dingtalk-link

钉钉机器人配置

配置 OpenClaw 与钉钉机器人连接，支持 AI Card 流式响应和会话管理。

前置要求 OpenClaw >= 2026.3.22（dingtalk-connector v0.8.6+ 必需） 钉钉企业账号 Open路由r API Key 快速配置

• 安装插件

OpenClaw 插件s 安装 @dingtalk-real-AI/dingtalk-connector

• 创建钉钉应用

访问 https://open-dev.dingtalk.com/ 应用开发 → 创建企业内部应用 添加应用能力 → 选择"机器人" 获取 应用Key 和 应用Secret（凭证与基础信息页面） 发布应用（版本管理与发布）

⚠️ 应用必须发布才能正常接收消息

• 配置凭证

使用命令行配置：

OpenClaw channels 添加

选择 DingTalk，输入 应用Key 和 应用Secret。

或手动编辑 ~/.OpenClaw/OpenClaw.json：

{ "channels": { "dingtalk-connector": { "enabled": true, "命令行工具entId": "你的应用Key", "命令行工具entSecret": "你的应用Secret" } } }

• 重启并验证

OpenClaw gateway re启动 OpenClaw 状态

确认 DingTalk 状态为 ON / OK。

常见问题排查 机器人不回复 OpenClaw 记录s --follow

检查日志确认：

应用已发布 机器人模式为 流（非 网页hook） 应用Key/应用Secret 正确 版本不兼容错误

错误信息：Cannot find 模块 '.../插件-sdk/root-alias.cjs/channel-运行time'

原因：OpenClaw 版本过低

解决：

npm 安装 -g OpenClaw@latest OpenClaw gateway re启动

HTTP 401 错误 检查 应用Key/应用Secret 是否正确（注意多余空格） 确认应用已发布 流 连接 400 错误 原因 解决方案 应用未发布 发布应用 凭证错误 检查 应用Key/应用Secret 非 流 模式 确认机器人配置为 流 模式 IP 白名单限制 检查应用是否设置了 IP 白名单 端口冲突 OpenClaw gateway 停止 OpenClaw gateway 启动

进阶配置 异步模式（长时间任务） { "channels": { "dingtalk-connector": { "enabled": true, "命令行工具entId": "应用Key", "命令行工具entSecret": "应用Secret", "a同步Mode": true, "ackText": "收到，处理中..." } } }

会话配置 { "channels": { "dingtalk-connector": { "enabled": true, "命令行工具entId": "应用Key", "命令行工具entSecret": "应用Secret", "separate会话ByConversation": true, "group会话Scope": "group" } } }

参考链接 插件文档：https://github.com/DingTalk-Real-AI/dingtalk-OpenClaw-connector 钉钉开放平台：https://open-dev.dingtalk.com/