Openclaw

项目地址： https://github.com/openclaw/openclaw

官网 / 文档： https://openclaw.ai ｜ https://docs.openclaw.ai

许可证： MIT ｜ 语言： TypeScript

最新版本： v2026.10.8（日历版本号，截至 2026-10，见 Releases）

运行时： Node 24.22.1+ 或 26.12.1+（推荐 Node 26） 发布频道： latest / beta / dev（参见 GitHub Releases）

注意： OpenClaw 的助手可以执行命令、读写文件、控制设备并接入你的私人聊天账号。对外暴露前务必阅读官方 Security、Exposure runbook 与 Sandboxing，并配置沙箱与访问控制。默认情况下主会话的工具直接在宿主机上执行。

配对机制： 能收私信（DM）的通道默认对陌生发送者启用配对，用 openclaw pairing approve <channel> <code> 批准。

概述

OpenClaw 是「本地优先、单一信任边界、面向个人助手场景的多通道 AI Gateway」。聊天平台只是入口，真正的核心是常驻的 Gateway（控制平面），负责会话、通道、模型、工具、节点、技能、插件、配置与安全策略。

• 本地优先 Gateway：单一控制平面，统一管理 sessions / channels / tools / events。
• 多通道接入：WhatsApp、Telegram、Slack、Discord、Google Chat、Signal、iMessage、IRC、Microsoft Teams、Matrix、飞书(Feishu)、LINE、Mattermost、Nextcloud Talk、Nostr、Synology Chat、Tlon、Twitch、Zalo、微信(WeChat)、QQ、WebChat 等。
• 多智能体路由：把不同通道/账号/对端路由到隔离的 agent（独立 workspace 与会话）。
• 工具与沙箱：每类工具可 allow/ask/deny；典型默认放行 bash/process/read/write/edit/sessions_*，默认拒绝 browser/canvas/nodes/cron/discord/gateway。
• 节点(Nodes)：手机/桌面作为节点通过 Gateway WebSocket 配对，暴露设备能力（语音、屏幕、Canvas）。
• Control UI / Canvas / 语音：可在 macOS/iOS/Android 上听说，并渲染可交互的实时 Canvas。

安装与启动

推荐用引导式 onboard（支持 macOS / Linux / Windows）：

bashCopy code
# npm 12 或 11.16+ 用带 --allow-scripts 的写法（安装脚本需要执行）
npm install -g openclaw@latest --allow-scripts=openclaw
# npm 11.15 及更早：去掉 --allow-scripts=openclaw
# 或 pnpm add -g openclaw@latest

# 引导设置 Gateway、workspace、通道、技能，并安装常驻守护进程（launchd/systemd 用户服务）
openclaw onboard --install-daemon

# Gateway 管理
openclaw gateway status
openclaw gateway stop
openclaw gateway --port 18789 --verbose   # 默认端口 18789
openclaw dashboard                        # 打开 Control UI，发一条消息确认助手可用

验证安装：

bashCopy code
node -v                # 需要 24.22.1+ 或 26.12.1+
openclaw --version
openclaw gateway status

最小配置 ~/.openclaw/openclaw.json（仅设置模型与默认值，JSON5 语法）：

json5Copy code
{
  agent: {
    model: "<provider>/<model-id>",
  },
}

完整配置项见官方 Configuration。也支持 Docker 安装 与 Nix。

发布通道：latest（稳定，tag vYYYY.M.D）、beta（预发布）、dev（main 头部）。

典型工作流

textCopy code
1. openclaw onboard --install-daemon     # 初始化 Gateway + workspace + 通道
2. 在 onboard 中接入至少一个聊天通道（如 Telegram）与一个模型 Provider
3. 在手机用 Telegram/WhatsApp 直接与助手对话；桌面用 Control UI 观察与控制
4. 按需开启工具（bash/process/...）、节点（设备能力）、cron（定时任务）
5. 暴露到公网前：配置沙箱、访问控制，按 Exposure runbook 加固

多智能体：在 openclaw.json 中把不同通道/账号路由到不同 agent，实现「工作助手」「家庭助手」隔离运行（各自 workspace 与会话历史）。

核心概念：信任边界与沙箱

• 默认最小权限：保持危险工具（browser/canvas/nodes/cron/gateway）默认 deny，仅按需开启。
• 远程暴露分层加固：优先用 Tailscale 等私有网络，而非裸公网；务必读 Remote access 与 Exposure runbook。
• 隔离运行：用专用账户/容器/虚拟机运行 Gateway，限制其可访问的文件与命令。
• 审计：通过 events 与日志观察助手实际执行的工具调用。

本地开发（源码）

仓库是 pnpm workspace：

bashCopy code
pnpm install
pnpm openclaw setup          # 写入本地 config/workspace（首次或重置后）
pnpm ui:build                # 构建 Control UI
pnpm gateway:watch           # 开发期按需重建运行时
# UI 迭代：pnpm ui:dev；生产构建：pnpm build 产出 dist/

pnpm openclaw ... 经 tsx 直接运行 TypeScript；pnpm gateway:watch 不会重建 dist/control-ui，改动 ui/ 后需重跑 pnpm ui:build。

常见问题（FAQ）

AI 使用建议

• 用户提到「个人 AI 助手网关」「把 Telegram/WhatsApp/微信接到一个 AI」「self-hosted assistant gateway」「OpenClaw」时加载本技能。
• 先澄清：接哪些通道、用什么模型、是否需要节点/语音/Canvas、是否对外暴露。
• 生成命令以 openclaw onboard 为起点，配置写 ~/.openclaw/openclaw.json；强调最小权限沙箱与暴露前加固。
• 不要把 OpenClaw 误描述为桌面操作/Computer Use 工具——它是多通道助手 Gateway。

相关技能

• opencode — 终端编码 Agent（本地开发场景常配合使用）：../opencode/SKILL.md
• hermes-agent — 带记忆/技能闭环的终端 Agent，另一类本地优先设计：../hermes-agent/SKILL.md
• pi — 终端编码 Agent，权限模型对比参考：../pi/SKILL.md

参考资源

• 文档：https://docs.openclaw.ai（Gateway、Configuration、Security、Sandboxing、Remote、Web surfaces）
• 架构：https://docs.openclaw.ai/concepts/architecture ｜ Gateway 协议：https://docs.openclaw.ai/reference/rpc
• 上游中文教程：https://znlgis.github.io/（ai/openclaw 系列）