agentscope-extensions-channel-dingtalk 通过 Stream 协议(持久 WebSocket)将你的 Agent 接入钉钉,无需暴露公网 webhook 端点即可实时接收机器人消息。
适用场景
- Agent 需要响应钉钉机器人消息(单聊和群 @提醒)。
- 你更倾向于 WebSocket 推送模型而非轮询或 webhook 回调。
添加依赖
前置准备
- 在钉钉开发者后台创建一个企业内部应用。
- 启用机器人能力并订阅机器人消息 topic。
- 记下 App Key、App Secret 和 Robot Code。
快速开始
配置属性
消息流转
入站:DingTalkStreamClient 通过 WebSocket 连接钉钉网关,接收机器人消息回调,ACK 每个帧后进入 DingTalkInboundMapper → 幂等去重 → 防循环 → Gateway。
出站: 通过 DingTalkOutboundClient 使用 OpenAPI 的 batchSend 接口发送回复——oToMessages/batchSend 用于单聊,groupMessages/send 用于群聊。文本和 Markdown 格式自动识别。