前提条件
- 已在电脑上安装 SetupClaw 应用（macOS 或 Windows）
- 拥有钉钉组织的管理员权限
- 已设置 OpenClaw 并配置了至少一个 AI 模型
设置步骤
1
创建钉钉应用
前往钉钉开放平台 open.dingtalk.com，使用管理员账号登录。
- 进入应用开发页面，创建一个自定义机器人或企业内部应用。
- 应用创建完成后，在应用凭证页面找到客户端 ID（Client ID）和客户端密钥（Client Secret）。
- 妥善保存这些凭证——您将在第 4 步中使用它们。
2
配置机器人功能
在钉钉应用设置中启用机器人功能，使应用能够发送和接收消息。
- 在应用设置中，找到「机器人」部分并启用。
- 为机器人设置名称和头像。这是用户在钉钉中看到的内容。
- 保存机器人配置后再继续下一步。
3
设置权限和推送模式
授予必要的权限并启用推送模式（Stream），实现实时消息推送。
- 在权限管理部分，为您的应用授予消息发送和接收权限。
- 进入消息推送设置，启用推送模式（Stream）。这允许钉钉实时向您的机器人推送消息。
- 推送模式是推荐的方式——它不需要公网回调地址。
4
在 SetupClaw 中输入凭证
打开 SetupClaw 应用，将钉钉添加为新渠道。
- 在 SetupClaw 应用中，进入「渠道」页面并点击「添加渠道」。
- 从可用渠道列表中选择「钉钉」。
- 输入您在第 1 步中获取的客户端 ID 和客户端密钥。
- SetupClaw 将自动安装钉钉连接器插件并启用网关 HTTP 端点。
5
测试您的机器人
在钉钉中发送测试消息，验证一切是否正常运行。
- 打开钉钉，在联系人或群聊中找到您的机器人。
- 向机器人发送一条消息。
- 如果 AI 回复了消息，说明您的钉钉集成已完成。
故障排除
机器人没有响应
检查 SetupClaw 应用中 OpenClaw 网关是否正在运行。进入仪表板，确认网关状态显示为绿色指示灯。如果已停止，请重新启动。
凭证错误
仔细核对客户端 ID 和客户端密钥是否与钉钉开放平台上显示的一致。如有需要，在 SetupClaw 中重新输入。
推送模式问题
确保在钉钉应用设置中已启用推送模式（Stream）。如果消息未被推送，尝试关闭后重新启用推送模式，然后在 SetupClaw 中重启网关。