钉钉
目标
- 创建/配置钉钉应用或机器人
- 获取 Client ID / Client Secret，并完成权限配置
- 完成事件订阅配置（Stream 模式长连接）
前置说明
- OpenClaw 的钉钉渠道通过 Stream 模式（长连接）接收消息，因此通常不需要暴露公网回调 URL。
- Client Secret 属于敏感信息，请使用密钥管理工具或安全的环境变量注入方式保存与使用。
第 1 步：创建钉钉应用（开放平台）
- 打开 钉钉开放平台 并登录你的企业管理员账号
- 进入「应用开发」页面，选择「企业内部开发」
- 点击「创建应用」
- 填写应用名称与描述
- 选择应用图标
截图占位：钉钉开放平台首页 / 创建应用表单
第 2 步：复制凭证（Client ID / Client Secret）
在应用的「凭证与基础信息」页面复制：
- Client ID（原 AppKey，格式如
dingxxxxxxxx） - Client Secret（原 AppSecret）
截图占位：凭证与基础信息页面（Client ID / Client Secret 位置）
第 3 步：配置权限（Permissions）
进入应用的「权限管理」页面，搜索并开通以下权限：
必要权限：
| 权限标识 | 说明 |
|---|---|
qyapi_chat_manage |
群会话管理 |
qyapi_robot_sendmsg |
企业内机器人发送消息 |
Contact.User.Read |
通讯录个人信息读权限 |
Chat.Bot.Read |
机器人接收群聊消息 |
Chat.Bot.Write |
机器人发送群聊消息 |
Chat.SingleBot.Read |
机器人接收单聊消息 |
Chat.SingleBot.Write |
机器人发送单聊消息 |
Connector.Storage.READ_AND_WRITE |
连接器存储读写（如需要） |
截图占位：权限管理页面（搜索与开通权限）
第 4 步：启用机器人能力
在「应用能力」>「机器人」中：
- 开启机器人配置
- 填写机器人名称
- 消息接收模式选择 Stream 模式（推荐，无需公网 IP）
截图占位：机器人能力配置页面（Stream 模式选择）
第 5 步：配置事件订阅（Stream 模式）
在「事件与回调」中：
- 推送方式选择 Stream 模式
- 添加事件订阅，勾选以下事件：
- chat_bot_message_recieve — 机器人收到消息
- 其他按需勾选（如群变更通知等）
截图占位：事件与回调页面（Stream 模式与事件列表）
第 6 步：发布应用
- 在应用详情页点击「版本管理与发布」
- 创建新版本，填写版本号与发布说明
- 提交发布，等待企业管理员审核通过
- 发布成功后，在钉钉客户端搜索应用名即可使用
截图占位：版本管理与发布页面
常见问题与补充
- Stream 模式 vs HTTP 模式：Stream 模式通过长连接接收事件推送，无需公网 IP 和域名，适合大多数场景。HTTP 模式需要配置公网可访问的回调 URL。
- 旧版 AppKey/AppSecret：钉钉新版已将 AppKey 更名为 Client ID，AppSecret 更名为 Client Secret，功能不变。
- 调试工具：可使用钉钉开放平台的「API Explorer」在线调试接口，验证凭证是否正常。