创建钉钉应用
本示例企业内部应用为例，如需创建第三方企业应用，可根据实际场景进行创建。
1.登录开发者后台;
2.在开发者后台，点击应用开发，并点击创建应用;
3.在右侧展示应用创建页，根据内容填写应用的基本信息（包括应用名称和应用描述），最后单击保存即可;
4.创建成功后，在应用列表会显示已创建的应用，如下图所示：
5.在应用详情页中的凭证与基础信息模块内，获取应用的Client ID和Client Secret。
请妥善保管获取的Client ID和Client Secret信息，切勿轻易提供给他人使用。
创建钉钉机器人
在执行本步骤前，需要保证已经存在钉钉应用，如果未创建应用，请参考本文中步骤一进行创建。
1.选择目标应用，进入目标详情页;
2.在左侧菜单中选中添加应用能力，并添加机器人能力;
3.在配置页面开启机器人配置功能，并填写机器人名称等必填项，最后单击发布即可。
说明
在配置机器人信息时，默认消息接收模式为Stream模式。
发布钉钉应用
1.选择目标应用，进入目标详情页；
2.在左侧菜单中选中版本管理与发布，并点击创建新版本；
3.在版本详情中，填写应用版本号和版本描述，并选择应用的可用范围，最后单击保存即可。
在选择应用可用范围时，请根据业务实际需求选择可见范围，若选择全部员工，则当应用发布后，当前企业下所有的员工都可见。
部署 OpenClaw
1.首先安装钉钉官方插件，输入以下命令直接运行 OpenClaw 插件安装命令，OpenClaw 会自动处理下载、安装依赖和注册。 时间可能比较久，请耐心等待即可。
openclaw plugins install @dingtalk-real-ai/dingtalk-connector
效果如下图所示：
如果提示报错，使用openclaw-cn plugins install @dingtalk-real-ai/dingtalk-connector
2.在OpenClaw中添加钉钉配置。
完成上方步骤后，你需要在 ~/.openclaw/openclaw.json 文件中添加channels/dingtalk-connector、gateway/auth 和 gateway/http/endpoints3 个配置项属性。
以下示例已省略其他配置项，只提供了核心配置项及需要配置钉钉的相关属性内容。
| JSON { "channels": { "dingtalk-connector": { "clientId": "钉钉应用的Client Secret", // 必选：填入上方的 钉钉 Client ID "clientSecret": "钉钉应用的Client Secret", // 必选：填入上方的 Client Secret "gatewayToken": "Gateway 认证 token", // 必选：Gateway 认证 token, openclaw.json配置中 gateway.auth.token 的值 "gatewayPassword": "", // 可选：Gateway 认证 password（与 token 二选一） "sessionTimeout": 1800000 // 可选：会话超时(ms)，默认 30 分钟 } }, "gateway": { // gateway通常是已有的节点，配置时注意把http部分追加到已有节点下 "auth": { "mode": "token", "token": "Gateway 认证 token" // 必选：一般是安装时默认就有 }, "http": { "endpoints": { "chatCompletions": { "enabled": true // 必选 } } } } } |
3.重启Gateway。
关闭启动程序的终端，重新点击桌面的启动后台服务，等加载完成后即可重试。
使用钉钉机器人
场景一：群聊中使用机器人
1.打开钉钉客户端，进入任意群聊；
如果是已有群聊，需要确保群归属组织与创建机器人时的组织相同。
创建新的群聊，请确保创建时候选择的归属组织与创建机器人时的组织相同。
2.单击群设置（右上角），进入群设置，器然后选择机器人。
3.在机器人管理模块下，选择添加机器人；
4.在添加机器人界面，通过搜索已经创建并发布的机器人，点击机器人进行添加即可；
5.机器人添加成功后，通过@机器人，实现自动回复。
场景二：单聊中使用机器人
1.在顶部搜索框中搜索已创建机器人名称直接使用。
2.通过发送消息，实现机器人单聊回复，如下图所示：
常见问题
钉钉机器人配置后无法收到消息怎么办？
请检查以下几点：
确认钉钉插件已正确安装（openclaw plugins install @dingtalk-real-ai/dingtalk-connector）。
检查 Client ID 和 Client Secret 配置是否正确。
确认已申请 Card.Streaming.Write 和 Card.Instance.Write 权限。
确保应用版本已发布。
添加机器人时，找不到创建的机器人
原因可能是：
该群聊的归属组织与创建机器人时的组织不同。请选择或重新创建一个正确的群聊。
群聊归属组织正确，但不是内部群，需转换为内部群。
