这篇文章适合谁
如果你已经把 OpenClaw 跑起来了，现在只差“把它接进国内聊天平台”，那这篇就是给你的。
这篇文章不讲抽象概念，只讲三件事：
- 怎么把 OpenClaw 接进飞书
- 怎么把 OpenClaw 接进钉钉
- 怎么把 OpenClaw 接进企业微信
我的目标只有一个： 你照着这篇文章操作，至少能把机器人接起来，并发出第一条测试消息。
———
一、接入前统一检查
在开始接任何平台之前，先确认下面 5 件事。
1. OpenClaw 已经能本地运行
先在终端执行：
openclaw-cn gateway status
如果你还没启动过网关，也可以直接执行：
openclaw-cn gateway
至少要保证你本地这套 OpenClaw 是活的。
2. 你知道配置文件位置
后面三个平台都会改这个文件：
~/.openclaw/openclaw.json
3. 你会看日志
后面排错最重要的命令是：
openclaw-cn logs –follow
如果接入失败，不是靠猜，是先看日志。
4. 你有对应平台的创建权限
至少要有下面之一：
- 飞书企业自建应用创建权限
- 钉钉企业内部应用创建权限
- 企业微信智能机器人创建权限
5. 先别同时接 3 个平台
建议顺序：
- 先接一个
- 跑通
- 再接第二个
- 最后再同时启用
第一次接，最怕的不是不会配，而是多个变量一起变，导致你不知道问题在哪。
———
二、飞书 AI 助手接入教程
2.1 飞书接入后的效果
接好后，你可以：
- 在飞书里私聊机器人
- 在群里 @机器人
- 让它总结文本、整理内容、执行 OpenClaw 任务
- 使用 WebSocket 长连接模式，不需要公网回调地址
飞书是国内最好上手的一个通道之一。
———
2.2 第一步：创建飞书应用
打开飞书开放平台：
https://open.feishu.cn/ (https://open.feishu.cn/)
然后这样操作：
- 登录你的飞书账号
- 点击“创建企业自建应用”
- 填写应用名称、描述、图标
- 创建完成后进入应用详情页
———
2.3 第二步：获取 App ID 和 App Secret
进入应用的“凭证与基础信息”页面，复制这两个值：
- App ID
- App Secret
其中 App ID 一般长这样：
cli_xxx
这两个值后面要填到 OpenClaw 里。
———
2.4 第三步：配置飞书权限
进入“权限管理”页面。
中文社区文档给了一份可直接导入的权限 JSON。你可以用“批量导入”方式把权限一次加进去。核心权限包含：
- 机器人发消息
- 接收私聊消息
- 接收群聊消息
- 文档和表格相关访问能力
- 事件订阅能力
文档里给的示例权限清单在这里： https://clawd.org.cn/channels/feishu (https://clawd.org.cn/channels/feishu)
其中有一个你要特别注意的权限：
im:message.group_msg
这个权限很关键。
它的作用是：
- 如果你想让机器人在群里“不用 @ 也能响应”
- 那必须加这个敏感权限
- 不加的话，飞书默认只把 @机器人 的群消息推给你
如果你现在只是想先跑通，建议先按默认模式来： 群里必须 @机器人 才响应。
这样最稳，也最安全。
———
2.5 第四步：启用机器人能力
进入：
应用能力 > 机器人
然后做这几步：
- 开启机器人能力
- 填写机器人名称
- 保存
做到这里，你的飞书应用才真正变成一个“能聊天的机器人”。
———
2.6 第五步：配置事件订阅
进入：
事件订阅
然后这样配置：
- 选择 使用长连接接收事件（WebSocket 模式）
-
添加事件：
im.message.receive_v1
这个事件就是“接收消息事件”。
注意一个非常容易踩坑的点：
在配这个之前，最好先确保：
- 你已经在 OpenClaw 侧加过飞书通道
- 网关已经启动
否则飞书侧有时候会出现事件配置保存不顺或者后续消息收不到的问题。这个提醒来自中文社区文档。 来源：https://clawd.org.cn/channels/feishu (https://clawd.org.cn/channels/feishu)
———
2.7 第六步：发布飞书应用
很多人配置完就去测，结果机器人搜不到，问题就出在这里。
你还要去：
版本管理与发布
然后：
- 创建版本
- 填写版本说明
- 提交审核 / 发布
- 等待生效
企业自建应用通常比较快。
———
2.8 第七步：把飞书添加到 OpenClaw
推荐命令：
openclaw-cn channels add
然后按提示操作：
- 选择 Feishu
- 输入 App ID
- 输入 App Secret
如果你不想走交互式，也可以直接改配置文件。
编辑：
~/.openclaw/openclaw.json
加入：
{ “channels”: { “feishu”: { “enabled”: true, “dmPolicy”: “pairing”, “accounts”: { “main”: { “appId”: “cli_xxx”, “appSecret”: “你的AppSecret”, “botName”: “我的AI助手” } } } } }
字段说明：
- enabled: true 表示启用飞书通道
- dmPolicy: “pairing” 表示私聊默认先走配对授权
- appId 填飞书 App ID
- appSecret 填飞书 App Secret
- botName 机器人显示名称
———
2.9 第八步：启动或重启网关
执行：
openclaw-cn gateway restart
如果你当前没启动网关，就直接跑：
openclaw-cn gateway
再开一个终端看日志：
openclaw-cn logs –follow
———
2.10 第九步：在飞书里测试
私聊测试
- 在飞书里找到你创建的机器人
- 给它发一条消息，例如：
你好
第一次配对授权
默认情况下，机器人可能会返回一个配对码。 这时你需要在终端执行：
openclaw-cn pairing approve feishu
如果你想先看有哪些待审批请求：
openclaw-cn pairing list feishu
批准后，再回到飞书继续发消息。
———
2.11 飞书群聊测试
默认情况下，飞书群里推荐用：
必须 @机器人 才响应
如果你什么都不额外配，这通常就是默认行为。
在群里测试：
@机器人 请帮我总结这段内容
———
2.12 飞书常见问题
1. 机器人搜不到
优先检查：
- 应用是否已经发布
- 机器人能力是否开启
- 应用可见范围是否正确
2. 私聊不回复
优先检查：
- App ID / App Secret 是否填错
- 网关是否在运行
- 日志里是否有认证报错
- 是否还没批准配对码
3. 群里只有 @ 才响应，是不是有问题
不是问题，这是默认安全行为。
如果你想“群里不 @ 也响应”，还要：
- 配置特定群组的 requireMention: false
- 在飞书开放平台额外申请敏感权限 im:message.group_msg
- 重新发布应用
———
2.13 飞书进阶配置：群里不 @ 也响应
如果你确认自己需要这个能力，在配置文件里可以写：
{ “channels”: { “feishu”: { “groups”: { “oc_xxx”: { “requireMention”: false } } } } }
这里的：
- oc_xxx 就是飞书群的 chat_id
获取方式：
- 启动网关
- 在群里 @机器人 发一条消息
- 查看日志：
openclaw-cn logs –follow
日志里能看到 chat_id
———
三、钉钉 AI 助手接入教程
3.1 钉钉接入后的效果
接好后，你可以：
- 在钉钉里私聊机器人
- 在群里 @机器人
- 使用 Stream 模式，不需要公网 IP
- 把 OpenClaw 作为钉钉里的 AI 助手来用
钉钉最大的优点是：
Stream 模式不需要你自己配公网回调地址。
———
3.2 第一步：创建钉钉企业内部应用
打开钉钉开放平台：
https://open-dev.dingtalk.com/ (https://open-dev.dingtalk.com/)
然后这样做：
- 登录钉钉开发者后台
- 进入： 应用开发 > 企业内部开发
- 点击“创建应用”
- 选择“钉钉应用”
- 填写应用名称和描述
- 创建完成后进入应用详情页
———
3.3 第二步：获取 Client ID 和 Client Secret
在应用“基础信息”页面，复制：
- Client ID
- Client Secret
中文社区文档说明：
- Client ID 也就是 AppKey
- Client Secret 也就是 AppSecret
来源： https://clawd.org.cn/channels/dingtalk-connector (https://clawd.org.cn/channels/dingtalk-connector)
———
3.4 第三步：开启机器人能力
进入：
添加应用能力 > 机器人
然后：
- 点击“添加”
- 开启机器人能力
- 填写机器人名称和描述
- 在消息接收模式里选择：
Stream 模式
这一步必须做对。 如果不是 Stream 模式，你后面整套“本地跑 OpenClaw、无需公网”的方案就不成立。
———
3.5 第四步：配置钉钉权限
进入：
权限管理
搜索并添加中文社区文档列出的这 3 个必要权限：
- Card.Streaming.Write
- Card.Instance.Write
- qyapi_robot_sendmsg
它们分别用于：
- AI 卡片流式输出
- 创建和更新卡片实例
- 机器人发送消息
如果你后面出现“能收到消息但发不出去”，优先来检查这里。
来源： https://clawd.org.cn/channels/dingtalk-connector (https://clawd.org.cn/channels/dingtalk-connector)
———
3.6 第五步：发布钉钉应用
进入：
版本管理与发布
然后：
- 创建新版本
- 写版本说明
- 选择应用可见范围
- 点击发布
测试期建议先把可见范围开给自己或测试成员。
———
3.7 第六步：给 OpenClaw 安装钉钉插件
在终端执行：
openclaw-cn plugins install @soimy/dingtalk
如果插件没装，后面就算配置项写对了，OpenClaw 也没法处理钉钉消息。
———
3.8 第七步：把插件加入白名单
编辑：
~/.openclaw/openclaw.json
确保有这段：
{ “plugins”: { “enabled”: true, “allow”: [“@soimy/dingtalk”] } }
如果你已经有别的插件，不要覆盖，改成数组合并。
———
3.9 第八步：配置钉钉通道
还是编辑：
~/.openclaw/openclaw.json
加入最小可用配置：
{ “plugins”: { “enabled”: true, “allow”: [“@soimy/dingtalk”] }, “channels”: { “dingtalk”: { “enabled”: true, “clientId”: “你的ClientID”, “clientSecret”: “你的ClientSecret”, “groupPolicy”: “mention” } } }
字段说明：
- enabled 启用钉钉通道
- clientId 填钉钉后台的 Client ID
- clientSecret 填钉钉后台的 Client Secret
- groupPolicy: “mention” 表示群里必须 @机器人 才响应
第一次接入，强烈建议保留 mention，不要改成群里全量响应。
———
3.10 第九步：重启网关
执行：
openclaw-cn gateway restart
然后看状态：
openclaw-cn gateway status
再开实时日志：
openclaw-cn logs –follow
———
3.11 第十步：在钉钉里测试
私聊测试
- 在钉钉里找到你刚发布的应用 / 机器人
- 发一条消息：
你好
预期结果：
- 机器人返回消息
群聊测试
- 把机器人拉进测试群
- 在群里发：
@机器人 请帮我总结这段话
如果配置的是：
“groupPolicy”: “mention”
那只有 @机器人 时才会触发，这是正常的。
———
3.12 钉钉常见问题
1. 钉钉里找不到机器人
优先检查：
- 应用有没有发布
- 可见范围是否包含你自己
- 机器人能力是否已开启
2. 有机器人，但发消息没反应
优先检查：
- clientId / clientSecret 是否填错
- 插件是否安装成功
- 插件是否加入白名单
- 网关是否已经重启
3. 能收消息，不能回复
优先检查：
- 权限管理里 3 个必需权限是否都加了
- 日志里是否有发消息权限报错
4. 群里不回复
优先检查：
- 机器人是否已加入群
- 你是否真的 @机器人
- groupPolicy 是否为 mention
———
四、企业微信 AI 助手接入教程
4.1 企业微信接入后的效果
接好后，你可以：
- 在企业微信里私聊机器人
- 在群里和机器人交互
- 使用长连接模式，不需要公网回调
- 让 OpenClaw 成为企业微信里的 AI 助手
企业微信这条链路现在中文社区文档走的是：
智能机器人 + API 模式 + 长连接
来源： https://clawd.org.cn/channels/wecom (https://clawd.org.cn/channels/wecom)
———
4.2 第一步：在企业微信里创建智能机器人
根据中文社区文档，创建入口在企业微信客户端里：
- 打开企业微信客户端
- 进入 工作台
- 点击 智能机器人
- 点击 创建机器人
- 选择 API 模式 创建
这一步不要选错。 你要的是“智能机器人”，不是别的应用接入方式。
———
4.3 第二步：选择长连接模式并获取凭证
创建时，选择：
长连接
文档明确说明：
- 长连接方式创建的机器人
- 支持主动向用户发送消息
- 无需公网 URL
创建完成后，记下这两个值：
- Bot ID
- Secret
后面 OpenClaw 就用这两个值。
来源： https://clawd.org.cn/channels/wecom (https://clawd.org.cn/channels/wecom)
———
4.4 第三步：把企业微信机器人添加到 OpenClaw
推荐命令：
openclaw-cn channels add
然后按提示：
- 选择 企业微信 (WeCom)
- 输入 Bot ID
- 输入 Secret
如果你想直接改配置文件，也可以。
编辑：
~/.openclaw/openclaw.json
加入：
{ “channels”: { “wecom”: { “enabled”: true, “botId”: “你的BotID”, “secret”: “你的Secret” } } }
———
4.5 第四步：启动或重启网关
执行：
openclaw-cn gateway restart
如果你没启动过，就直接：
openclaw-cn gateway
再看实时日志：
openclaw-cn logs –follow
———
4.6 第五步：在企业微信里测试
私聊测试
- 在企业微信里找到你创建的智能机器人
- 给它发一条消息：
你好
第一次配对授权
默认情况下，机器人会返回一个配对码。 你需要在终端执行：
openclaw-cn pairing approve wecom
也可以先查看待审批列表：
openclaw-cn pairing list wecom
批准后，再继续对话。
———
4.7 企业微信群测试
把机器人加入一个测试群，然后测试群聊消息。
企业微信当前文档里默认也有群组访问控制，核心配置是：
- groupPolicy: “open”
- groupPolicy: “allowlist”
- groupPolicy: “disabled”
如果你只是初次测试，先保持默认就行，不要先做复杂白名单。
———
4.8 企业微信进阶配置：最小完整示例
如果你想把私聊和群组策略也一起写上，可以这样配：
{ “channels”: { “wecom”: { “enabled”: true, “botId”: “你的BotID”, “secret”: “你的Secret”, “dmPolicy”: “pairing”, “groupPolicy”: “open” } } }
含义：
- dmPolicy: “pairing” 私聊默认先配对
- groupPolicy: “open” 群里默认允许使用
如果你后面要做更严格控制，再改成 allowlist。
———
4.9 如何获取企业微信用户 ID
如果你后面要做白名单控制，文档给了两个方法：
方法一：看日志
- 启动网关
- 给机器人发消息
- 执行：
openclaw-cn logs –follow
日志里可以看到用户 ID。
方法二：看配对列表
openclaw-cn pairing list wecom
来源： https://clawd.org.cn/channels/wecom (https://clawd.org.cn/channels/wecom)
———
4.10 企业微信常见问题
1. 机器人收不到消息
优先检查：
- 创建时是不是选了“长连接”
- botId / secret 是否填错
- 网关是否正在运行
- 日志里有没有连接报错
2. 私聊时一直没反应
优先检查：
- 是否还没批准配对码
- channels.wecom.enabled 是否为 true
- 配置文件是不是改错位置了
3. 群里行为不符合预期
优先检查：
- groupPolicy 配置值
- 群消息是否真的到了网关
- 日志里是否能看到对应群事件
———
五、接完以后怎么判断“真的成功了”
不要只看平台里有没有机器人。 真正成功至少要满足下面 6 条里的 5 条：
- 机器人在平台里能找到
- 私聊发消息能收到回复
- 如果启用了配对，能成功批准配对码
- 群里测试时能按配置响应
- 改配置后重启网关，行为会变化
- openclaw-cn logs –follow 里没有持续报认证失败
如果只是“看到了机器人头像”，那不算成功。
———
六、最实用的排错顺序
如果你接入失败，不要乱改。 按这个顺序查，效率最高：
第一步：看网关状态
openclaw-cn gateway status
第二步：看实时日志
openclaw-cn logs –follow
第三步：确认配置文件
~/.openclaw/openclaw.json
重点检查：
- 通道名写对没有
- 凭证字段名写对没有
- 值有没有多空格、少引号
第四步：确认平台后台是否已发布
很多问题不是 OpenClaw 配错，而是平台那边配置了但没发布。
第五步：确认是不是第一次配对还没批准
飞书和企业微信默认都可能会先走 pairing。
———
七、建议你怎么实际操作
如果你现在就要开始，我建议你按这个顺序：
- 先接飞书
- 飞书跑通后再接钉钉
- 最后接企业微信
原因很简单：
- 飞书链路最直观
- 钉钉 Stream 模式 很适合本机调试
- 企业微信更贴业务，放后面更稳
-上一章：常见问题与使用建议