钉钉接入
钉钉不是 OpenClaw 官方内置渠道,但社区提供了连接器插件。
社区方案:dingtalk-connector
社区开发的钉钉连接器,支持将钉钉机器人接入 OpenClaw Gateway。
1. 创建钉钉机器人
- 登录 钉钉开放平台
- 创建企业内部应用
- 添加「机器人」能力
- 获取 AppKey 和 AppSecret
- 配置消息接收:
- 服务器出口 IP 白名单
- 消息接收地址(HTTP 回调)或 Stream 模式
2. 安装连接器
bash
# 通过 ClawHub 安装
clawhub install dingtalk-connector
# 或手动安装
git clone https://github.com/community/dingtalk-openclaw-connector.git
cd dingtalk-openclaw-connector
npm install3. 配置
编辑 ~/.openclaw/openclaw.json:
json
{
"channels": {
"dingtalk": {
"enabled": true,
"appKey": "dingxxxx",
"appSecret": "xxxx",
"mode": "stream"
}
}
}Stream 模式
推荐使用 Stream 模式(长连接),无需公网回调地址,配置更简单。
4. 重启并验证
bash
openclaw gateway restart
openclaw doctor钉钉机器人权限
在钉钉开放平台中需要开通:
| 权限 | 说明 |
|---|---|
| 企业内机器人发送消息 | 基础消息能力 |
| 获取群会话信息 | 群聊支持 |
| 获取用户基本信息 | 用户识别 |
使用方式
- 单聊:在钉钉中找到机器人,直接发消息
- 群聊:在群中 @机器人 + 消息内容
- 支持文本、图片、文件等消息类型
功能限制
相比飞书等官方支持的渠道,钉钉方案有一些限制:
- 流式回复支持取决于连接器版本
- AI Card 富文本渲染可能不完整
- 更新频率依赖社区维护
WARNING
钉钉连接器是社区维护项目,功能成熟度不如飞书方案。如果你的团队同时使用飞书和钉钉,建议优先接入飞书。
替代方案
如果社区连接器不满足需求,可以考虑:
- Webhook 中转:钉钉 Webhook → 自建中间件 → OpenClaw API
- n8n / Dify 编排:通过工作流平台桥接钉钉和 OpenClaw
- 企业微信替代:企业微信有更成熟的社区插件支持