Skip to content

钉钉接入

钉钉不是 OpenClaw 官方内置渠道,但社区提供了连接器插件。

社区方案:dingtalk-connector

社区开发的钉钉连接器,支持将钉钉机器人接入 OpenClaw Gateway。

1. 创建钉钉机器人

  1. 登录 钉钉开放平台
  2. 创建企业内部应用
  3. 添加「机器人」能力
  4. 获取 AppKeyAppSecret
  5. 配置消息接收:
    • 服务器出口 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 install

3. 配置

编辑 ~/.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

钉钉连接器是社区维护项目,功能成熟度不如飞书方案。如果你的团队同时使用飞书和钉钉,建议优先接入飞书。

替代方案

如果社区连接器不满足需求,可以考虑:

  1. Webhook 中转:钉钉 Webhook → 自建中间件 → OpenClaw API
  2. n8n / Dify 编排:通过工作流平台桥接钉钉和 OpenClaw
  3. 企业微信替代:企业微信有更成熟的社区插件支持

OpenClaw 中文教程 - 社区项目