dingtalk-setup

Name: dingtalk-setup
Rating: 5 (3743 reviews)
Author: chao980

by chao980

钉钉机器人连接配置指南。用于安装、配置和排查 OpenClaw 钉钉连接器 (dingtalk-connector) 的问题。当用户需要连接钉钉机器人、配置 AppKey/AppSecret、或排查钉钉消息收发问题时使用。

3.7k平台与服务未扫描2026年3月30日

安装

claude skill add --url https://github.com/openclaw/skills

文档

钉钉机器人配置

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

前置要求

OpenClaw >= 2026.3.22（dingtalk-connector v0.8.6+ 必需）
钉钉企业账号
OpenRouter API Key

快速配置

1. 安装插件

bash

openclaw plugins install @dingtalk-real-ai/dingtalk-connector

2. 创建钉钉应用

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

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

3. 配置凭证

使用命令行配置：

bash

openclaw channels add

选择 DingTalk，输入 AppKey 和 AppSecret。

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

json5

{
  "channels": {
    "dingtalk-connector": {
      "enabled": true,
      "clientId": "你的AppKey",
      "clientSecret": "你的AppSecret"
    }
  }
}

4. 重启并验证

bash

openclaw gateway restart
openclaw status

确认 DingTalk 状态为 ON / OK。

常见问题排查

机器人不回复

bash

openclaw logs --follow

检查日志确认：

应用已发布
机器人模式为 Stream（非 Webhook）
AppKey/AppSecret 正确

版本不兼容错误

错误信息：Cannot find module '.../plugin-sdk/root-alias.cjs/channel-runtime'

原因：OpenClaw 版本过低

解决：

bash

npm install -g openclaw@latest
openclaw gateway restart

HTTP 401 错误

检查 AppKey/AppSecret 是否正确（注意多余空格）
确认应用已发布

Stream 连接 400 错误

原因	解决方案
应用未发布	发布应用
凭证错误	检查 AppKey/AppSecret
非 Stream 模式	确认机器人配置为 Stream 模式
IP 白名单限制	检查应用是否设置了 IP 白名单

端口冲突

bash

openclaw gateway stop
openclaw gateway start

进阶配置

异步模式（长时间任务）

json5

{
  "channels": {
    "dingtalk-connector": {
      "enabled": true,
      "clientId": "AppKey",
      "clientSecret": "AppSecret",
      "asyncMode": true,
      "ackText": "收到，处理中..."
    }
  }
}

会话配置

json5

{
  "channels": {
    "dingtalk-connector": {
      "enabled": true,
      "clientId": "AppKey",
      "clientSecret": "AppSecret",
      "separateSessionByConversation": true,
      "groupSessionScope": "group"
    }
  }
}

参考链接

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

dingtalk-setup

安装

文档

钉钉机器人配置

前置要求

快速配置

1. 安装插件

2. 创建钉钉应用

3. 配置凭证

4. 重启并验证

常见问题排查

机器人不回复

版本不兼容错误

HTTP 401 错误

Stream 连接 400 错误

端口冲突

进阶配置

异步模式（长时间任务）

会话配置

参考链接

相关 Skills

MCP构建

Slack动图

接口设计评审

相关 MCP 服务

Slack 消息

io.github.netdata/mcp-server

Scrapling MCP Server

评论