OpenClaw DingTalk Docs

Appearance

DingTalk Channel for OpenClaw ​

针对 OpenClaw 的钉钉企业内部机器人 Channel 渠道插件，使用 Stream 模式，无需公网 IP。

功能特性 ​

  • Stream 模式，无需 Webhook 和公网入口
  • 支持私聊、群聊和 @机器人
  • 支持文本、图片、语音、视频、文件和钉钉文档/文件卡片
  • 支持引用消息恢复和常见文本附件正文抽取
  • 支持 Markdown 回复与 AI 卡片流式回复
  • 支持多 Agent、多机器人绑定和实验性的 @多助手路由
  • 支持实时中止当前 AI generation。常用停止指令包括 停止、stop、/stop、esc 等
  • 接入 OpenClaw 消息处理与 outbound 能力

文档入口 ​

安装 ​

IMPORTANT

最小兼容版本为 OpenClaw 2026.3.24。安装前请先升级到最新版 OpenClaw。

由于上游 ClawHub 安装链路目前存在 bug，暂时无法稳定通过 openclaw plugins install @soimy/dingtalk 完成安装。 当前推荐使用源码链接安装：

bash
git clone https://github.com/soimy/openclaw-channel-dingtalk.git
cd openclaw-channel-dingtalk
npm install # 或 pnpm install
openclaw plugins install -l .

详见下方：本地开发或联调可使用源码链接安装

如需关注上游修复进展：

历史 npm 安装命令如下，但在上游修复前不推荐使用：

bash
openclaw plugins install @soimy/dingtalk

本地开发或联调可使用源码链接安装 ​

当前生产安装也建议使用源码链接安装：

bash
git clone https://github.com/soimy/openclaw-channel-dingtalk.git
cd openclaw-channel-dingtalk
npm install # 或 pnpm install
openclaw plugins install -l .

安装后建议显式配置 plugins.allow：

json5
{
  "plugins": {
    "enabled": true,
    "allow": ["dingtalk"]
  }
}

详细说明：

更新 ​

npm 安装来源：

bash
openclaw plugins update dingtalk

本地源码 / 链接安装来源：

bash
git pull
openclaw gateway restart

详细说明：

配置 ​

推荐优先使用交互式配置：

bash
openclaw onboard

或：

bash
openclaw configure --section channels

最小手动配置示例：

json5
{
  "plugins": {
    "enabled": true,
    "allow": ["dingtalk"]
  },
  "channels": {
    "dingtalk": {
      "enabled": true,
      "clientId": "dingxxxxxx",
      "clientSecret": "your-app-secret",
      "robotCode": "dingxxxxxx",
      "corpId": "dingxxxxxx",
      "agentId": "123456789",
      "dmPolicy": "open",
      "groupPolicy": "open",
      "messageType": "markdown"
    }
  }
}

详细说明：

重要功能文档 ​

开发简述 ​

bash
git clone https://github.com/soimy/openclaw-channel-dingtalk.git
cd openclaw-channel-dingtalk
npm install
npm run type-check
npm run lint
pnpm test

更多开发与维护说明：

许可 ​

MIT