OpenClaw 连接钉钉完整图文教程

前置准备

• 已安装并能正常打开 OpenClaw Windows。

• OpenClaw 顶部 Gateway 状态正常，建议保持在线或等待重启完成后再保存配置。

• 已登录钉钉开发者平台，并拥有当前组织的应用创建权限。

• 准备好一个可用于接收 OpenClaw 消息的钉钉组织或企业。

参考入口：

• 钉钉开发者后台：https://open-dev.dingtalk.com

• 钉钉开放平台：https://open.dingtalk.com

---

步骤 1：打开钉钉开发者平台并进入应用开发

打开钉钉开发者后台：
https://open-dev.dingtalk.com

登录后进入顶部菜单的“应用开发”。如果页面左侧显示“钉钉应用”“机器人”等入口，说明已经进入了正确的开发者后台。

---

步骤 2：点击“立即创建”

在“钉钉应用”页面中，找到一键自动创建 OpenClaw 机器人应用的提示栏，点击右侧的“立即创建”。

这个入口会帮助你快速创建 OpenClaw 所需的钉钉机器人应用，减少手动选择应用类型和机器人能力的步骤。

---

步骤 3：填写机器人基本信息

在“创建 OpenClaw 机器人”弹窗中，可以按需修改：

• 机器人名称：例如 小钉、OpenClaw 助手、虾壳云助手

• 机器人简介：例如 开启钉钉智能协作之旅

• 机器人图标：可以使用默认图标，也可以上传自定义图标

确认信息无误后，点击“确定”创建机器人。

---

步骤 4：复制 Client ID 和 Client Secret

机器人创建完成后，页面会显示两项重要凭证：

• Client ID：也叫 AppKey

• Client Secret：也叫 AppSecret

请点击右侧复制按钮，把这两个值临时保存好，下一步需要填写到 OpenClaw 中。

⚠️ 注意：Client Secret 属于敏感信息，不要发给无关人员，也不要截图公开。

---

步骤 5：回到 OpenClaw，进入钉钉聊天渠道配置

打开 OpenClaw Windows，进入“设置”里的“聊天配置”，找到 钉钉 (DingTalk) 卡片。

如果钉钉卡片里出现“安装插件”按钮，说明当前 OpenClaw 还没有安装钉钉渠道插件。点击“安装插件”，等待安装完成。

---

步骤 6：等待插件安装完成并关闭弹窗

点击“安装插件”后，OpenClaw 会显示安装进度和日志。等待进度到 100%，并出现“安装完成”提示。

安装完成后，Gateway 可能会自动重启。请稍等几秒，等弹窗提示可以关闭后，点击“关闭”。

⚠️ 如果安装过程中网络较慢，不要中途退出；等待日志不再滚动后再操作。

---

步骤 7：粘贴 Client ID 和 Client Secret

回到 钉钉 (DingTalk) 渠道卡片，把步骤 4 复制的凭证分别填入：

• Client ID (AppKey)：粘贴钉钉页面里的 Client ID

• Client Secret：粘贴钉钉页面里的 Client Secret

确认右上角开关处于开启状态，并且状态显示为“已配置”或等待保存后变为“已配置”。

---

步骤 8：保存渠道配置

确认 Client ID 和 Client Secret 都已填写后，点击右上角“保存渠道配置”。

保存完成后，钉钉渠道会保持启用状态。此时可以回到钉钉，搜索或打开刚创建的机器人，发送一条消息测试是否能收到 OpenClaw 回复。

---

接入完成后的自检清单

• 钉钉开发者平台里已经成功创建 OpenClaw 机器人。

• 已复制并妥善保存 Client ID 和 Client Secret。

• OpenClaw 的钉钉 (DingTalk) 插件已经安装完成。

• Client ID (AppKey) 和 Client Secret 已正确粘贴，没有多余空格。

• 钉钉渠道右侧开关已开启。

• 已点击“保存渠道配置”。

✅ 如果保存后没有立即生效，可以点击 OpenClaw 顶部“重启”，等待 Gateway 回到在线状态后再测试。

---

常见问题

1. OpenClaw 里为什么会出现“安装插件”按钮？

因为当前 OpenClaw 安装包默认不一定内置所有第三方聊天渠道。钉钉渠道需要安装连接器插件后才能使用。按截图点击“安装插件”，等待安装完成并关闭弹窗即可。

2. Client ID 和 Client Secret 应该填什么？

填写钉钉创建 OpenClaw 机器人成功后展示的两项凭证：

• Client ID 对应 OpenClaw 中的 Client ID (AppKey)

• Client Secret 对应 OpenClaw 中的 Client Secret

钉钉官方文档中也说明，Client ID 可理解为原来的 AppKey，Client Secret 可理解为原来的 AppSecret。

3. 保存后机器人没有回复怎么办？

优先检查以下几项：

• OpenClaw 顶部 Gateway 是否在线。

• 钉钉渠道开关是否已经打开。

• Client ID 和 Client Secret 是否复制完整，前后是否有空格。

• 插件安装后是否等待 Gateway 重启完成。

• 是否已经点击右上角“保存渠道配置”。

• 当前钉钉账号是否在创建机器人的组织内。

---

参考链接

• 钉钉开发者后台：https://open-dev.dingtalk.com

• 钉钉机器人应用创建说明：https://opensource.dingtalk.com/developerpedia/docs/explore/tutorials/stream/bot/nodejs/create-bot/

• OpenClaw 钉钉渠道文档：https://dingtalk-channel.nanoo.app/

---

最后提示：如果按照本教程完成配置后依然无法收到回复，欢迎在评论区留言（附上 Gateway 日志截图），我会尽快协助排查。