用于 OpenClaw 的钉钉频道插件

将 OpenClaw 连接到钉钉，实现企业级消息收发。

功能特性

• - 通过钉钉 API 发送/接收消息
• 支持企业内部应用和 Webhook 机器人
• 私聊与群聊策略
• 用户白名单支持

配置方式

方法一：环境变量

bash
export DINGTALKCLIENTID=your-app-key
export DINGTALKCLIENTSECRET=your-app-secret

方法二：配置文件

bash
openclaw config --section channels

选择 DingTalk 并按提示操作

或手动编辑配置：

yaml
channels:
dingtalk:
enabled: true
clientId: ding6kntxc33nvloty5z
clientSecret: your-secret
dmPolicy: allowlist # 或 open、pairing
allowFrom:
- user001
- user002
groupPolicy: allowlist # 或 open、disabled
groupAllowFrom:
- chat001

方法三：Webhook 机器人（群聊）

用于群机器人 Webhook：

yaml
channels:
dingtalk:
enabled: true
webhookUrl: https://oapi.dingtalk.com/robot/send?access_token=xxxxx
webhookSecret: SECxxxxx # 可选，用于签名验证

获取凭证

1. 1. 前往 钉钉开放平台
2. 创建微应用或内部机器人
3. 复制 App Key 和 App Secret
4. 对于内部应用，确保具备以下权限：

使用方式

发送消息

typescript
await message({
channel: dingtalk,
target: user-id,
text: 来自 OpenClaw 的问候！
});

接收消息

将钉钉回调 URL 配置为指向你的 OpenClaw 网关：

https://your-gateway/webhook/dingtalk

API 参考

• - 钉钉开放平台
• 机器人 Webhook API

故障排除

错误：invalid timestamp

• - 检查系统时间是否已同步

错误：app not authorized

• - 确保应用在钉钉管理后台拥有所需权限

错误：ip not in whitelist

• - 将 OpenClaw 网关 IP 添加到钉钉应用 IP 白名单

开发说明

此插件处于测试阶段。问题反馈请访问：https://github.com/openclaw/openclaw

许可证

MIT