Skillppx logo

dingtalk-link

用于配置 OpenClaw 与钉钉机器人的连接，支持消息收发和会话管理。

已扫描
适合谁
使用 OpenClaw 的开发者、需要在钉钉中接入 AI 服务的企业管理员
不适合谁
无钉钉企业账号的个人用户、不熟悉命令行操作的初学者
国内可用性
需网络配置。可能需要网络配置或第三方服务可访问。
安装难度
新手友好（★☆☆）。基于终端操作、依赖、API Key 和本地环境要求的初步判断。

安装与下载

openclaw skills install @chao980/dingtalk-link-smb
下载官方 ZIP

Skill 说明

命令、参数、文件名以原文为准

钉钉机器人配置

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

前置要求

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

快速配置

1. 安装插件

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

2. 创建钉钉应用

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

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

3. 配置凭证

使用命令行配置：

openclaw channels add

选择 DingTalk，输入 AppKey 和 AppSecret。

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

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

4. 重启并验证

openclaw gateway restart
openclaw status

确认 DingTalk 状态为 ON / OK。

常见问题排查

机器人不回复

openclaw logs --follow

检查日志确认：

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

版本不兼容错误

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

原因：OpenClaw 版本过低

解决：

npm install -g openclaw@latest
openclaw gateway restart

HTTP 401 错误

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

Stream 连接 400 错误

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

端口冲突

openclaw gateway stop
openclaw gateway start

进阶配置

异步模式（长时间任务）

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

会话配置

{
  "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/
C
@chao980

已收录 1 个 Skill

相关推荐