OpenClaw 钉钉 (DingTalk) 渠道插件 - 支持 Stream 模式接入。
openclaw plugins install @xuanmiss-npm/dingtalk
### 从本地源码安装
# 或使用 link 模式(不复制文件,适合开发)
openclaw plugins install -l ./extensions/dingtalk
- 在 钉钉开放平台 创建一个企业内部应用/机器人
- 获取以下凭证:
- Client ID (AppKey)
- Client Secret (AppSecret)
- Robot Code (机器人 Code,可选,默认使用 Client ID)
export DINGTALK_CLIENT_ID="your-client-id"
export DINGTALK_CLIENT_SECRET="your-client-secret"
export DINGTALK_ROBOT_CODE="your-robot-code" # 可选在 OpenClaw 配置文件中添加:
{
channels: {
dingtalk: {
enabled: true,
clientId: "your-client-id",
clientSecret: "your-client-secret",
robotCode: "your-robot-code", // 可选
dmPolicy: "pairing", // "open" | "allowlist" | "pairing"
groupPolicy: "allowlist", // "open" | "allowlist"
},
},
}pairing(默认):未知发送者需要通过配对码验证allowlist:仅允许allowFrom列表中的用户open:允许所有用户
allowlist(默认):需要 @机器人 才会响应open:响应所有消息(需要 @机器人)
支持配置多个钉钉机器人账户:
{
channels: {
dingtalk: {
accounts: {
default: {
name: "主机器人",
clientId: "client-id-1",
clientSecret: "secret-1",
},
alerts: {
name: "告警机器人",
clientId: "client-id-2",
clientSecret: "secret-2",
},
},
},
},
}默认情况下,新用户需要通过配对验证:
# 查看待验证的配对请求
openclaw pairing list dingtalk
# 批准配对请求
openclaw pairing approve dingtalk <CODE>通过 CLI 发送消息:
# 发送到用户
openclaw message send dingtalk user:<userId> "Hello!"
# 发送到群聊
openclaw message send dingtalk <conversationId> "Hello group!"-
无法连接
- 检查 Client ID 和 Client Secret 是否正确
- 确认机器人已在钉钉开放平台启用
-
群聊无响应
- 确保机器人已被添加到群聊
- 确认消息中 @了机器人
- 检查
groupPolicy配置
-
私聊无响应
- 检查
dmPolicy配置 - 如果是
pairing模式,确认用户已完成配对验证
- 检查
MIT