钉钉机器人快速配置指南

📦 前提条件

- OpenClaw ≥ 2026.4.9

- 钉钉账号（用于创建机器人）

🚀 方式一：一键安装（推荐）

1. 安装插件 + 扫码授权

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

终端会显示钉钉授权二维码：

- 用**钉钉 App** 扫码

- 点击「**一键创建新机器人**」

- 看到 Success! Bot configured. 即完成

2. 重启 Gateway

openclaw gateway restart

3. 验证状态

openclaw channels status --probe

✅ 成功标志DingTalk __default__: enabled, configured, running, connected

🔧 方式二：手动配置

如果扫码失败或需要手动控制配置，使用此方式。

1. 获取钉钉凭证

1. 访问 [钉钉开放平台](https://open-dev.dingtalk.com/)

2. 创建应用 → 添加机器人能力

3. 进入「**凭证与基础信息**」

4. 复制：

- AppKey → clientId

- AppSecret → clientSecret

2. 安装插件

# 安装钉钉插件
npm install -g @dingtalk-real-ai/dingtalk-connector

# 验证安装
openclaw plugins list | grep dingtalk

3. 配置凭证

# 启用渠道
openclaw config set 'channels.dingtalk-connector.enabled' true
# 设置 clientId (AppKey)
openclaw config set 'channels.dingtalk-connector.clientId' "dingxxxxxxxxx"
# 设置 clientSecret (AppSecret)
openclaw config set 'channels.dingtalk-connector.clientSecret' "your_secret_here"
# 重启 Gateway
openclaw gateway restart

4. 验证配置

# 查看渠道列表
openclaw channels list
# 查看详细状态
openclaw channels status --probe
# 查看配置文件
cat ~/.openclaw/openclaw.json | python3 -c "import sys,json; d=json.load(sys.stdin); print(json.dumps(d.get('channels',{}).get('dingtalk-connector',{}), indent=2))"

⚠️ 常见问题排查

机器人不回复

1. 检查应用状态

openclaw channels status --probe

2. 确认应用已发布

- 钉钉开放平台 → 版本管理 → 确认已**发布**

3. 确认机器人模式

- 必须是 Stream 模式（不是 Webhook 模式）

4. 查看日志

tail -100 /tmp/openclaw/openclaw-2026-MM-DD.log | grep -i dingtalk

配置不生效

1. 检查配置结构

cat ~/.openclaw/openclaw.json | python3 -m json.tool | grep -A 10 '"dingtalk-connector"'

2. 正确配置格式（顶层配置）：

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

3. 重启 Gateway

openclaw gateway restart

凭证错误 (401/403)

- 确认 clientId 和 clientSecret 无多余空格

- 确认应用未过期/禁用

- 重新从钉钉开放平台复制凭证

连接失败 (400)

- 确认应用已**发布**

- 确认机器人已**启用**

- 检查 IP 白名单（如有设置）

📚 相关文档

- [钉钉插件 GitHub](https://github.com/DingTalk-Real-AI/dingtalk-openclaw-connector)

- [OpenClaw 文档](https://docs.openclaw.ai/)

- [钉钉开放平台](https://open-dev.dingtalk.com/)

最后更新: 2026-05-05