钉钉

钉钉机器人通过 Stream 长连接收消息，常驻 Gateway 主动连接平台，无需暴露公网入站 Webhook。先在应用中启用机器人能力和 Stream 消息订阅。

连接需要哪些字段

Dashboard 渠道 → 添加 → DingTalk 的默认 Stream 接入使用 client_id、client_secret。需要显式匹配应用身份时，可填写 bot_user_id、bot_staff_id、robot_code，不要猜这些值。默认账号 ID 为 work。

平台侧设置可参考钉钉 Stream SDK 资料。保存成功只说明本地账号操作已提交，还要检查传输和应用权限。

处理私聊授权

默认私聊 pairing、群聊 mention。通过 anyy setup channel 的交互向导，可改私聊为 pairing/open/allowlist/disabled、群聊为 mention/open/allowlist/disabled；Dashboard 凭据表单没有这些策略字段。当前公开设置也没有钉钉名单条目编辑输入，见消息平台。

收到私聊配对请求后：

anyy channel pairing list --channel dingtalk
anyy channel pairing approve --request REQUEST_ID

核对平台身份，批准后发一条新私聊；群里另用明确的 @机器人 消息测试。

诊断顺序

anyy channel reload
anyy channel doctor dingtalk

无法建立 Stream 时，先看 Gateway 是否在线，再看出站网络、Client 凭据与消息订阅。收到事件却未回复时，检查访问策略和提及；能收不能发时，检查 Bot 身份、回复上下文和应用发信权限。不要把身份字段有效当成整个消息链已验证。