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。
openclaw -v你应该看到:版本号不低于 2026.8.1。本教程基准 2026.10.9 满足要求,但请按上一节先升级到不受公告影响的版本。
- 版本号 ≥ 2026.8.1
第 2 步:一条命令安装并扫码授权
为什么:这是 README 推荐的方式,安装插件和创建机器人一次完成。
npx -y @dingtalk-real-ai/dingtalk-connector install终端会显示一个钉钉授权二维码。用钉钉手机 App 扫码,点“一键创建新机器人”。
你应该看到:终端打印 Success! Bot configured.,表示授权完成。
然后重启 Gateway,让新渠道生效:
openclaw gateway restartREADME 特别说明:扫码失败(超时、二维码显示不出来等)不影响插件本身的安装,可以接着走第 3 步手动配置。
- 看到了
Success! Bot configured.,并重启了 Gateway
第 3 步(扫码失败时):手动填凭证
为什么:扫码不可用时,自己在钉钉开放平台建应用,把凭证写进 OpenClaw 配置。
- 打开钉钉开放平台 https://open-dev.dingtalk.com/,进入“应用开发”。
- 在应用详情页一键创建 OpenClaw 机器人应用。
- 在“凭证与基础信息”里复制 AppKey(Client ID)和 AppSecret(Client Secret)。
编辑 ~/.openclaw/openclaw.json(Windows 是 C:\Users\<你的用户名>\.openclaw\openclaw.json),在 channels 下加上:
{
"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 流式回复,消息卡片会显示思考中、生成中、完成这样的状态变化。
再把机器人拉进一个测试群,@它提问。
- 私聊和群聊各收到一次回复
没成功?
插件仓库的常见问题页列了几种情况:
查一查我遇到的是……
点一个看看。
群聊只回兜底文案的那一条,要加的配置是:
{
"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。