OpenClaw 2.7.1 绑定钉钉详细教程
前置准备
- 已安装并能正常打开 OpenClaw Windows 2.7.1 版本
- OpenClaw 顶部 Gateway 状态正常，建议保持在线或等待重启完成后再保存配置
- 已登录钉钉开发者平台，并拥有当前组织的应用创建权限
- 准备好一个可用于接收 OpenClaw 消息的钉钉组织或企业
参考入口：
钉钉开发者后台：
open-dev.dingtalk.com
钉钉开放平台：open.dingtalk.com
步骤 1：打开钉钉开发者平台并进入应用开发
打开钉钉开发者后台（
open-dev.dingtalk.com），登录后进入顶部菜单的**应用开发**。页面左侧显示 “钉钉应用”“机器人” 等入口，即进入正确的开发者后台。
步骤 2：点击 “立即创建”
在 “钉钉应用” 页面中，找到一键自动创建 OpenClaw 机器人应用的提示栏，点击右侧立即创建，快速创建 OpenClaw 所需的钉钉机器人应用，简化手动配置步骤。
步骤 3：填写机器人基本信息
在 “创建 OpenClaw 机器人” 弹窗中，可按需修改以下信息：
- 机器人名称：如小钉、OpenClaw 助手、虾壳云助手
- 机器人简介：如开启钉钉智能协作之旅
- 机器人图标：使用默认图标或上传自定义图标（JPG/PNG 格式、240*240p 以上、1:1、2MB 以内无角图标）
信息确认无误后，点击确定完成机器人创建。
步骤 4：复制 Client ID 和 Client Secret
机器人创建完成后，页面会展示两项关键凭证：
- Client ID（也叫 AppKey）
- Client Secret（也叫 AppSecret）
点击右侧复制按钮，将两个值临时保存，后续需填写到 OpenClaw 中。
注意：Client Secret 属于敏感信息，请勿泄露给无关人员，切勿截图公开。
步骤 5：回到 OpenClaw，进入钉钉聊天渠道配置
打开 OpenClaw Windows 2.7.1，进入设置→聊天配置，找到钉钉 (DingTalk) 卡片。
若卡片内显示 “安装插件” 按钮，说明未安装钉钉渠道插件，点击安装插件等待完成。
步骤 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 重启完成
- 是否点击 “保存渠道配置”
- 当前钉钉账号是否在创建机器人的组织内
参考链接
钉钉开发者后台：
open-dev.dingtalk.com
钉钉机器人应用创建说明：
opensource.dingtalk.com/developerpe…
OpenClaw 钉钉渠道文档：
dingtalk-channel.nanoo.app/
OpenClaw 下载地址：
xiake.yun/api/downloa…
