OpenClaw 是一个跑在自己电脑上的开源 AI 助手,接进 WhatsApp、Telegram、Slack、Discord、iMessage、Teams 等聊天软件,在对话框里替你办事。装它只要一行脚本或一条 npm 命令,再走一遍引导向导;WhatsApp 扫码绑定,Telegram 填 BotFather 给的 token。工具沙箱默认关闭,需要自己打开。
项目用 MIT 许可,由 OpenClaw Foundation(美国 501(c)(3) 非营利组织)维护。README 写明没有付费版、没有托管服务、也不发币。模型由你自己接,云端服务商或本地模型都行,费用直接付给服务商。截至 2026 年 10 月 22 日,openclaw/openclaw 仓库约有 39.3 万星,最新版本是 10 月 18 日的 v2026.10.5。
安装与初始化
官方脚本支持 macOS、Linux、WSL2 和 Windows,缺 Node.js 时会自动装一个合适的版本:
macOS、Linux 或 WSL2:
curl -fsSL https://openclaw.ai/install.sh | bash
Windows PowerShell:
iwr -useb https://openclaw.ai/install.ps1 | iex
自己管 Node.js 的,可以直接装 npm 包,要求 Node 24.16+ 或 26.1+,官方推荐 Node 26:
npm install -g openclaw@latest --allow-scripts=openclaw
openclaw onboard --install-daemon
--allow-scripts 参数只适用于 npm 12 或 npm 11.16 及以上,npm 11.15 及更早版本要去掉。用安装脚本的话,引导向导会自动弹出。向导负责检查模型能否调用、建工作区、配置 Gateway。Gateway 是本地的控制中枢,会话、工具和各聊天渠道的连接都挂在它上面。装完先确认它在跑:
openclaw gateway status
openclaw dashboard
第二条命令打开 Control UI,先在这里发一句话,确认助手能回,再去接聊天软件。
接入 WhatsApp
WhatsApp 走的是 WhatsApp Web(Baileys 库),登录会话由 Gateway 持有,没有 Twilio 方案。这个渠道是独立插件 @openclaw/whatsapp,第一次在向导里选 WhatsApp 时会提示安装,也可以手动执行 openclaw plugins install @openclaw/whatsapp。
先在配置里写好访问策略,只放行自己的号码:
{
channels: {
whatsapp: {
dmPolicy: "pairing",
allowFrom: ["+15551234567"],
groupPolicy: "allowlist",
groupAllowFrom: ["+15551234567"],
},
},
}
然后扫码绑定并启动 Gateway。登录只支持二维码,放在无界面服务器上时,得先想好怎么把实时二维码送到手机上,截图或聊天转发的二维码可能在路上就过期了:
openclaw channels login --channel whatsapp
openclaw gateway
第一个联系人发来消息后,在 Settings → Channels → DM access requests 里批准,或者用命令行:
openclaw pairing list whatsapp
openclaw pairing approve whatsapp <CODE>
请求 1 小时后失效,每个账号最多同时挂 3 个待批请求。官方建议给助手单独准备一个 WhatsApp 号;用自己的号也行,向导会把你的号码写进白名单并打开自聊模式。
接入 Telegram
Telegram 用普通的 bot 账号,默认长轮询,也可以改成 webhook。
在 Telegram 里找 @BotFather(核对用户名一字不差),发送 /newbot 按提示建好 bot,记下 token。然后交给 OpenClaw:
openclaw channels add --channel telegram --token <bot-token>
openclaw channels status --probe
也可以手动写进 ~/.openclaw/openclaw.json 的 channels.telegram.botToken,默认账号还能用环境变量 TELEGRAM_BOT_TOKEN。注意 Telegram 不走 openclaw channels login。
给 bot 发一条消息,1 小时内批准配对码:
openclaw pairing list telegram
openclaw pairing approve telegram <CODE>
官方示例配置在群里开了 requireMention: true,只有被 @ 时才回复。以 -100 开头的群聊 ID 要放在 channels.telegram.groups 下面,不是 groupAllowFrom。
沙箱设置
README 说得很直接:没配沙箱时,主会话的工具直接在宿主机上执行。开了沙箱,挪进容器或远程环境的只是工具执行,Gateway 本身仍在宿主机。控制它的是三个设置:
| 设置 | 配置项 | 可选值 | 默认 |
|---|---|---|---|
| 模式 | agents.defaults.sandbox.mode |
off、non-main、all |
off |
| 范围 | agents.defaults.sandbox.scope |
agent、session、shared |
agent |
| 后端 | agents.defaults.sandbox.backend |
docker、podman、ssh、openshell、crabbox |
docker |
non-main 会把主会话以外的会话都放进沙箱。群聊和各渠道的会话有自己的会话键,所以这个模式下 WhatsApp 群里的对话一定在沙箱里跑。另一个设置 workspaceAccess 决定沙箱能看到什么:默认 none 给它一个独立工作区(~/.openclaw/sandboxes 下),ro 只读挂载 Agent 工作区,rw 读写挂载。
文档给的最小起步配置:
{
agents: {
defaults: {
sandbox: {
mode: "non-main",
scope: "session",
workspaceAccess: "none",
},
},
},
}
Docker 后端默认很严:network: "none" 不能出网,根文件系统只读,丢弃全部 Linux capabilities,镜像是 openclaw-sandbox:trixie-slim。文档也提醒了两点:沙箱“不是完美的安全边界”;tools.elevated 仍可以让 exec 绕到沙箱外执行,想彻底禁掉 exec 要在工具策略里 deny。openclaw sandbox explain 能打印某个会话实际生效的沙箱配置。
默认安全策略
普通宿主机安装时,Gateway 只监听本机回环地址;陌生人私信只会收到配对码,群聊默认走白名单。例外是容器镜像,默认绑定对外地址,文档要求配合认证使用。想知道配置有没有偏离默认值,跑一下:
openclaw security audit
安全文档的前提是一个 Gateway 对应一个信任边界,也就是一个人用,或一个彼此信任的团队用。互不信任的用户要拆开:各自的 Gateway 和凭据,最好再分开系统用户或主机。另外,有消息工具权限的 Agent 默认可以跨会话、跨渠道发消息,要限制得单独配置。
AI Rank 上的用量
OpenClaw 以应用身份向 OpenRouter 上报流量。2026 年 10 月 10 日至 16 日这一周,它在 OpenRouter 应用榜排第 7,用了 2.66 万亿 token,前面是 Hermes Agent、Claude Code、Kilo Code、Cline、pi 和 Freebuff。这个数只统计经 OpenRouter 转发的请求,用本地模型或直连其他服务商的不在其中。
不想自己部署的,可以看 Grok Bot:厂商托管的云端电脑,按订阅计费。
继续探索: 在 AI Rank 的 AI 应用排名 查看哪些 Agent 和编程工具的 token 用量最高。
或 📱 下载 AI Rank App 在手机上随时查看。
来源
- GitHub:openclaw/openclaw README
- OpenClaw 文档:安装
- OpenClaw 文档:WhatsApp
- OpenClaw 文档:Telegram 设置
- OpenClaw 文档:安全
- OpenClaw 文档:沙箱
- OpenClaw 官网
本文使用自动化编辑辅助,于 2026 年 10 月 22 日依据 openclaw/openclaw 仓库、OpenClaw 官方文档及 AI Rank 的 OpenRouter 应用数据核对,未实际安装。