Skip to content
🎯 场景实战第 6 / 13 节

OpenClaw 能接钉钉吗,怎么接 ​

阿杰的公司全员用钉钉,日程、待办、日报都在里面。他照着教程装好了 OpenClaw,翻遍官方文档的渠道列表,飞书、企业微信都有,偏偏找不到钉钉。

先看清这件事的分界线:

考考你OpenClaw 官方文档的渠道列表里有钉钉吗?

OpenClaw 核心不支持钉钉,但钉钉团队维护了一个外部插件,装上以后能在钉钉私聊和群聊里用 OpenClaw。 这个插件的仓库自称“钉钉官方出品”,OpenClaw 官方文档没有收录它,出了问题要找插件仓库,而不是 OpenClaw。

学完你能做什么 ​

  • 用一条命令装好钉钉插件,扫码建好机器人
  • 扫码不成功时,手动填 AppKey / AppSecret 完成配置
  • 在钉钉里和 OpenClaw 对话,并知道群聊不回复时改哪个配置

这个插件是谁做的 ​

项目内容
仓库https://github.com/DingTalk-Real-AI/dingtalk-openclaw-connector
维护方GitHub 组织账号 DingTalk-Real-AI,仓库描述为 “Official OpenClaw DingTalk channel plugin | 钉钉官方 OpenClaw 插件”
npm 包@dingtalk-real-ai/dingtalk-connector
最新版本0.8.27(2026-10-20)
星标2,128(2026-11-20 查询)
许可证MIT
对 OpenClaw 的要求≥ 2026.8.1;更旧的 OpenClaw 用插件 0.8.25

README 列出的能力:接收群聊和私聊消息并回复、@成员;AI Card 流式回复;钉钉文档的创建、追加、搜索;DING 强提醒;个人待办;AI 表格;日历日程;日报周报。群待办和云盘文件标为“Coming Soon”,还不能用。

另有一个社区插件 soimy/openclaw-channel-dingtalk(个人账号维护,1,662 星,2026-11-20 查询)。本课只讲钉钉团队的这一个。

  • 我知道这个插件不属于 OpenClaw 核心,问题要提到插件仓库

用之前先读安全提示 ​

插件 README 在安装说明之前单独放了一节“安全与风险提示(使用前必读)”,要点是:

  • 它对接的是 OpenClaw 的 AI 自动化能力,存在模型幻觉、执行不可控、提示词注入等固有风险。
  • 授权以后,OpenClaw 会以你的用户身份在授权范围内操作钉钉,可能导致敏感数据泄露或越权操作。
  • 插件默认开了多层安全保护,README 强烈建议不要修改任何默认安全配置。
  • 建议把它当个人对话助手用,避免直接部署到企业生产环境;在公司账号里用,要遵守公司的信息安全规范。

另外,本教程基准 OpenClaw 2026.10.9 受高危公告 GHSA-pw3x 影响。把 OpenClaw 接进公司 IM 之前,先按升级与版本通道升到 2026.11.4 以上或 2026.10.33。

  • 我读过插件的安全提示,也确认了自己的 OpenClaw 版本

第 1 步:确认 OpenClaw 版本 ​

为什么:插件 0.8.26 起改用 OpenClaw 2 的新插件 SDK,最低要 OpenClaw 2026.8.1。

bash
openclaw -v

你应该看到:版本号不低于 2026.8.1。本教程基准 2026.10.9 满足要求,但请按上一节先升级到不受公告影响的版本。

  • 版本号 ≥ 2026.8.1

第 2 步:一条命令安装并扫码授权 ​

为什么:这是 README 推荐的方式,安装插件和创建机器人一次完成。

bash
npx -y @dingtalk-real-ai/dingtalk-connector install

终端会显示一个钉钉授权二维码。用钉钉手机 App 扫码,点“一键创建新机器人”。

你应该看到:终端打印 Success! Bot configured.,表示授权完成。

然后重启 Gateway,让新渠道生效:

bash
openclaw gateway restart

README 特别说明:扫码失败(超时、二维码显示不出来等)不影响插件本身的安装,可以接着走第 3 步手动配置。

  • 看到了 Success! Bot configured.,并重启了 Gateway

第 3 步(扫码失败时):手动填凭证 ​

为什么:扫码不可用时,自己在钉钉开放平台建应用,把凭证写进 OpenClaw 配置。

  1. 打开钉钉开放平台 https://open-dev.dingtalk.com/,进入“应用开发”。
  2. 在应用详情页一键创建 OpenClaw 机器人应用。
  3. 在“凭证与基础信息”里复制 AppKey(Client ID)和 AppSecret(Client Secret)。

编辑 ~/.openclaw/openclaw.json(Windows 是 C:\Users\<你的用户名>\.openclaw\openclaw.json),在 channels 下加上:

json
{
  "channels": {
    "dingtalk-connector": {
      "enabled": true,
      "clientId": "dingxxxxxxxxx",
      "clientSecret": "your_app_secret"
    }
  }
}

文件里已有内容的话,只在 channels 节点下添加 dingtalk-connector 这一段。这两个值是机器人的唯一凭证,不要发到群里或提交到代码仓库。改完运行 openclaw gateway restart。

你应该看到:Gateway 正常重启,没有报配置错误。

  • channels.dingtalk-connector 里填好了 clientId 和 clientSecret

第 4 步:在钉钉里说第一句话 ​

为什么:私聊是最快的端到端验证。

在钉钉里找到刚创建的机器人,私聊发一句话。

你应该看到:机器人回复。插件支持 AI Card 流式回复,消息卡片会显示思考中、生成中、完成这样的状态变化。

再把机器人拉进一个测试群,@它提问。

  • 私聊和群聊各收到一次回复

没成功? ​

插件仓库的常见问题页列了几种情况:

查一查我遇到的是……

点一个看看。

群聊只回兜底文案的那一条,要加的配置是:

json
{
  "messages": {
    "groupChat": {
      "visibleReplies": "automatic"
    }
  }
}

然后 openclaw gateway restart。常见问题页给的原因是:群聊默认只通过消息工具回复,插件拿不到文本,于是落到兜底文案。插件较新的版本会在兜底文案里直接附上这段修复指引。

更多问题见插件仓库的 docs/TROUBLESHOOTING.md 和 Issues。属于 OpenClaw 本体(网关、模型、多渠道)的问题,README 让你去 openclaw/openclaw 的 Issues。

检查点 ​

  • 我能说清:钉钉不是 OpenClaw 核心渠道,用的是钉钉团队维护的外部插件
  • 我的 OpenClaw ≥ 2026.8.1,且已升到不受 GHSA-pw3x 影响的版本
  • 机器人在钉钉私聊里能回复
  • 群里 @ 它只回兜底文案时,我知道改 messages.groupChat.visibleReplies

常见误会 ​

以为“钉钉官方插件”就是 OpenClaw 官方支持。 “官方”是插件仓库的自述,指钉钉团队出品。OpenClaw 官方文档没有收录钉钉渠道,插件的兼容性和问题由插件仓库负责。

以为装好就能放心用在全公司。 插件 README 自己建议当个人助手用,避免直接部署到企业生产环境;授权后 OpenClaw 以你的身份操作钉钉。要在公司里用,先过一遍安全加固(一):访问控制与身份。

以为群待办和云盘已经能用。 README 把这两项标为 Coming Soon。现在能用的是个人待办、文档、日程、AI 表格、日报和 DING。

下一节 ​

办公 IM 接好了,可以换一条线:B1 每日晨报让 Claw 每天定点把资讯汇总发到你的 IM。

搞懂AI关于我们怎么写隐私说明联系我们

独立的第三方教程,与文中提到的任何产品及其公司没有隶属或合作关系;产品名称和商标归各自所有者。价格和政策以官方页面为准。