Open Source · Personal AI That Lives On Your Machine

THE AI THAT ACTUALLY DOES THINGS

清邮箱、发邮件、管日历、帮你值机 — 全部通过 WhatsApp、Telegram 或任何你已有的聊天应用完成。
由 Peter Steinberger 和开源社区打造。数据留在你的机器上,隐私优先。

50+
集成渠道
7
聊天平台
24/7
后台运行
100%
本地部署
$ curl -fsSL https://openclaw.ai/install.sh | bash

适用于 macOS、Windows 和 Linux。一行命令安装所有依赖。

系统架构总览

OpenClaw 采用 Gateway 中心架构,一个长生命周期的 WebSocket 服务控制所有消息面板和客户端连接。

聊天渠道层
💬
WhatsApp
Baileys
✈️
Telegram
grammY
🎮
Discord
discord.js
💼
Slack
🔒
Signal
🍎
iMessage
imsg CLI
🌐
WebChat
WebSocket JSON Protocol
Gateway 核心 (Daemon)
🔌
WebSocket
Server
🧠
Agent
Runtime
💾
Session
Manager
💓
Heartbeat
Runner
Cron
Scheduler
🔐
Pairing &
Auth
Tool Execution & Events
工具 & 能力层
🌍
Browser
Control
📁
File
System
Bash
Exec
🧩
Skills
Engine
🎨
Canvas
A2UI
📱
Nodes
iOS/Android
Device Connections
客户端 & 节点层
🖥️
macOS App
⌨️
CLI
🌐
Web UI
📱
iOS Node
🤖
Android Node
🔄
Automation

Gateway 网关架构

单一 WebSocket 控制平面,管理所有客户端、工具和事件流。JSON 文本帧协议,TypeBox Schema 类型安全。

📡

Wire Protocol

1
req:connect → 握手必须为首帧
2
res: hello-ok → 附带 presence + health 快照
3
req → res → 请求/响应 + 推送事件
// 请求帧
{type: "req", id, method, params}

// 响应帧
{type: "res", id, ok, payload|error}

// 事件推送
{type: "event", event, payload, seq?}
🔐

配对 & 安全

  • 所有 WS 客户端在 connect 时包含设备身份
  • 新设备 ID 需要配对审批
  • Gateway 颁发设备 Token 用于后续连接
  • 本地连接可自动审批 (loopback)
  • v3 签名绑定 platform + deviceFamily
  • 元数据变更需要重新配对
// 远程访问 (推荐 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..."
      }
    }
  }
}
HEARTBEAT_OK → 无事需处理时的静默响应
💾

会话管理

  • 私聊折叠到共享 main 会话
  • 群聊隔离为独立会话
  • 每次运行序列化 (per-session + global queue)
  • Token 压缩 (Compaction) 自动触发
  • 会话记忆自动持久化到 memory/ 目录
📝 memory/YYYY-MM-DD.md
📋 MEMORY.md (长期)

Agent 运行循环

完整的 Agentic Loop:消息接收 → 上下文组装 → 模型推理 → 工具执行 → 流式回复 → 持久化。

01

消息接入 & 队列

agent RPC 验证参数,解析 session,持久化元数据。支持 collect/steer/followup 队列模式。

02

工作区 & Skills 准备

解析/创建工作区,加载 Skills 快照,注入 Bootstrap 上下文和系统提示。

03

模型推理 & 工具执行

runEmbeddedPiAgent 驱动 pi-agent-core,流式输出 assistant/tool delta 事件。

04

回复塑形 & 持久化

流式分块发送,session 状态更新,Compaction 检查,Hook 触发 (session-memory 等)。

连接生命周期

Client
req:connect
res (ok) + hello-ok snapshot
event:presence
event:tick
req:agent
res:agent ack {runId, status}
event:agent (streaming...)
res:agent final {summary}
Gateway

一流 Agent 工具

类型化的 first-class 工具,替代旧版 Skills shell 调用。直接嵌入 Agent Runtime。

group:runtime

exec 执行命令
bash Shell 脚本
process 进程管理
📁

group:fs

read 读取文件
write 写入文件
edit 精确编辑
apply_patch 多文件补丁
🌍

browser

snapshot AI 可访问性视图
screenshot 截图 → 图像块
act 点击/输入/拖拽
navigate 页面跳转
🧠

group:sessions

sessions_list 列出活跃会话
sessions_send 跨会话通信
sessions_spawn 创建子 Agent
sessions_history 会话历史日志
🗄️

group:memory

memory_search 搜索记忆库
memory_get 读取记忆文件
🤖

group:automation

cron 定时任务
gateway 网关控制
message 消息发送
nodes 设备节点
🐳

Docker 沙箱隔离

模式选择

off | non-main | all

按需隔离非主会话或全部

作用域粒度

session | agent | shared

每个会话或每个 Agent 独立容器

工具策略

allow / deny

精确控制每个 Agent 可用工具

Skills 可扩展体系

AgentSkills 兼容的技能文件夹系统。自带丰富内置 Skills,支持社区扩展(ClawHub),甚至可以让 AI 自己编写新 Skills。

最高优先

<workspace>/skills

工作区 Skills — 用户自有,按项目定制

↓ 覆盖
中等优先

~/.openclaw/skills

托管/本地 Skills — 全局共享,手动覆盖

↓ 覆盖
最低优先

Bundled Skills

内置 Skills — 随安装包分发 (npm / OpenClaw.app)

SKILL.md 格式

---
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...

热门 Skills

🧩

coding-agent

委托编码任务给 Codex、Claude Code 或 Pi 后台 Agent

👁️

peekaboo

macOS 系统控制 — 截图、点击、窗口管理、菜单操控

🐦

xurl

X/Twitter 完整操作 — 发推、回复、搜索、时间线

📝

OpenProse

多 Agent 编排语言 — .prose 程序、并行执行、循环

📋

things-mac

Things 3 待办管理 — 读取 inbox/today,添加/更新任务

🛠️

skill-creator

自动创建新 Skill — AI 编写 AI 的技能

真实场景演示

看看 OpenClaw 如何在日常生活中发挥作用 — 通过聊天 App 实现一切。

🦞
Molty online via Telegram
Agent 活动日志

连接一切

50+ 集成,从聊天应用到智能家居,从代码仓库到云服务。

💬 聊天平台

WhatsApp
Telegram
Discord
Slack
Signal
iMessage

🤖 AI 模型

Claude (Anthropic)
GPT (OpenAI)
Gemini (Google)
MiniMax
本地模型

🛠️ 开发工具

GitHub
Codex CLI
Claude Code
Cursor

📱 生产力

Gmail
Calendar
Obsidian
Things 3
Todoist

🏠 智能设备

Philips Hue
Spotify
WHOOP
Winix 空净

🌐 社交媒体

X / Twitter
Browser 控制
WordPress
Hetzner

多 Agent 协作

工作区隔离、per-agent 会话管理、Agent-to-Agent 通信。

Main Agent
个人助手 · 完全权限 heartbeat: 30m sandbox: off
sessions_send / sessions_spawn
Work Agent
工作专用 · 沙箱隔离 sandbox: all tools: group:fs, browser
Family Agent
家庭共享 · 受限权限 tools: read, message deny: exec, write
Public Agent
对外服务 · 最小权限 sandbox: all tools: sessions_send only

5 分钟上手

1

一行安装

curl -fsSL https://openclaw.ai/install.sh | bash
2

运行向导

openclaw onboard --install-daemon
3

检查 Gateway

openclaw gateway status
4

开始对话

openclaw dashboard

或直接在 WhatsApp / Telegram 中和你的 AI 聊天