清邮箱、发邮件、管日历、帮你值机 — 全部通过 WhatsApp、Telegram 或任何你已有的聊天应用完成。
由 Peter Steinberger 和开源社区打造。数据留在你的机器上,隐私优先。
curl -fsSL https://openclaw.ai/install.sh | bash
适用于 macOS、Windows 和 Linux。一行命令安装所有依赖。
OpenClaw 采用 Gateway 中心架构,一个长生命周期的 WebSocket 服务控制所有消息面板和客户端连接。
单一 WebSocket 控制平面,管理所有客户端、工具和事件流。JSON 文本帧协议,TypeBox Schema 类型安全。
req:connect
→ 握手必须为首帧
res: hello-ok
→ 附带 presence + health 快照
req → res
→ 请求/响应 + 推送事件
// 请求帧
{type: "req", id, method, params}
// 响应帧
{type: "res", id, ok, payload|error}
// 事件推送
{type: "event", event, payload, seq?}
// 远程访问 (推荐 Tailscale)
ssh -N -L 18789:127.0.0.1:18789 user@host
// 或设置 Token
OPENCLAW_GATEWAY_TOKEN=your_secret
在主会话中运行周期性 Agent 轮次,主动发现需要关注的事项。
// openclaw.json 配置
{
agents: {
defaults: {
heartbeat: {
every: "30m",
target: "last",
model: "anthropic/claude-opus-4-6",
prompt: "Read HEARTBEAT.md..."
}
}
}
}
main 会话
完整的 Agentic Loop:消息接收 → 上下文组装 → 模型推理 → 工具执行 → 流式回复 → 持久化。
agent RPC 验证参数,解析 session,持久化元数据。支持 collect/steer/followup 队列模式。
解析/创建工作区,加载 Skills 快照,注入 Bootstrap 上下文和系统提示。
runEmbeddedPiAgent 驱动 pi-agent-core,流式输出 assistant/tool delta 事件。
流式分块发送,session 状态更新,Compaction 检查,Hook 触发 (session-memory 等)。
类型化的 first-class 工具,替代旧版 Skills shell 调用。直接嵌入 Agent Runtime。
exec
执行命令
bash
Shell 脚本
process
进程管理
read
读取文件
write
写入文件
edit
精确编辑
apply_patch
多文件补丁
snapshot
AI 可访问性视图
screenshot
截图 → 图像块
act
点击/输入/拖拽
navigate
页面跳转
sessions_list
列出活跃会话
sessions_send
跨会话通信
sessions_spawn
创建子 Agent
sessions_history
会话历史日志
memory_search
搜索记忆库
memory_get
读取记忆文件
cron
定时任务
gateway
网关控制
message
消息发送
nodes
设备节点
off | non-main | all
按需隔离非主会话或全部
session | agent | shared
每个会话或每个 Agent 独立容器
allow / deny
精确控制每个 Agent 可用工具
AgentSkills 兼容的技能文件夹系统。自带丰富内置 Skills,支持社区扩展(ClawHub),甚至可以让 AI 自己编写新 Skills。
工作区 Skills — 用户自有,按项目定制
托管/本地 Skills — 全局共享,手动覆盖
内置 Skills — 随安装包分发 (npm / OpenClaw.app)
---
name: nano-banana-pro
description: Generate images via Gemini
metadata:
{"openclaw": {
"requires": {"bins": ["uv"],
"env": ["GEMINI_API_KEY"]},
"primaryEnv": "GEMINI_API_KEY"
}}
---
# Nano Banana Pro
Instructions for the agent...
委托编码任务给 Codex、Claude Code 或 Pi 后台 Agent
macOS 系统控制 — 截图、点击、窗口管理、菜单操控
X/Twitter 完整操作 — 发推、回复、搜索、时间线
多 Agent 编排语言 — .prose 程序、并行执行、循环
Things 3 待办管理 — 读取 inbox/today,添加/更新任务
自动创建新 Skill — AI 编写 AI 的技能
看看 OpenClaw 如何在日常生活中发挥作用 — 通过聊天 App 实现一切。
50+ 集成,从聊天应用到智能家居,从代码仓库到云服务。
工作区隔离、per-agent 会话管理、Agent-to-Agent 通信。