OpenClaw 的钉钉 Channel

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

功能特性

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

[!IMPORTANT] 根据钉钉开放平台公告《关于限时开放钉钉PaaS资源不限量额度以助力企业AI智能体集成的公告》（更新于 2026-03-11），OpenClaw 调用钉钉 API/Webhook/Stream 的免费“不限量”额度默认有效至 2026-03-31；如已通过官方申请通道获批，豁免权益最晚有效至 2026-04-30。部署前请前往“钉钉开发者后台 -> 资源管理”核对当前额度状态。

文档入口

• 线上文档站点：https://dingtalk-channel.nanoo.app/
• 用户文档入口：docs/user/index.md
• 参与贡献入口：docs/contributor/index.md
• 发布记录：docs/releases/index.md
• 英文入口：docs/en/index.md

引用与署名

• GitHub / 机器可读引用元数据：CITATION.cff
• 维护者对复用、引用与 AI 协作场景的署名请求：docs/contributor/citation-and-attribution.md

安装

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

openclaw plugins install @soimy/dingtalk

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

如需本地开发、调试或联调，可使用源码链接安装：

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

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

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

详细说明：

• 安装指南

更新

ClawHub 安装来源：

openclaw plugins update dingtalk

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

git pull
openclaw gateway restart

详细说明：

• 更新指南

配置

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

openclaw onboard

或：

openclaw configure --section channels

最小手动配置示例：

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

详细说明：

• 配置指南
• 钉钉权限与凭证
• 配置项参考

重要功能文档

• 消息类型支持
• 回复模式
• AI 卡片
• 钉钉文档 API
• 反馈学习
• 多 Agent 与多机器人绑定
• @多助手路由
• 安全策略
• API 消耗说明
• 故障排查

开发简述

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

更多开发与维护说明：

• 本地开发
• 测试与验证
• 架构说明（中文详版）
• NPM 发布

许可

MIT

openclaw-channel-dingtalk 快速上手指南

本指南帮助开发者快速将钉钉企业内部机器人接入 OpenClaw，实现 Stream 模式下的 AI 对话能力，无需公网 IP 和 Webhook。

环境准备

在开始之前，请确保满足以下前置条件：

• OpenClaw 版本：必须 >= 2026.3.24。请先升级您的 OpenClaw 至最新版。
• Node.js 环境：已安装 Node.js (推荐 LTS 版本) 及包管理器 (npm 或 pnpm)。
• 钉钉应用凭证：
  • 已在 钉钉开发者后台 创建企业内部应用。
  • 获取应用的 AppKey (clientId) 和 AppSecret (clientSecret)。
  • 确认应用具备相应的机器人权限及 API 调用额度（注意免费额度有效期至 2026-03-31）。

安装步骤

方式一：通过 ClawHub 安装（推荐）

直接使用命令行安装官方发布的插件包：

openclaw plugins install @soimy/dingtalk

方式二：源码安装（适用于开发调试）

如需本地修改代码或进行联调，可克隆源码进行安装：

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

启用插件

安装完成后，建议在配置中显式允许该插件。编辑配置文件或在交互式配置中设置：

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

基本使用

1. 配置钉钉凭证

推荐使用交互式命令进行配置，按提示填入钉钉应用的 clientId 和 clientSecret：

openclaw onboard

或者手动编辑配置文件，最小配置示例如下：

{
  "channels": {
    "dingtalk": {
      "enabled": true,
      "clientId": "dingxxxxxx", 
      "clientSecret": "your-app-secret",
      "dmPolicy": "open",       // 私聊策略：open(开放) / close(关闭)
      "groupPolicy": "open",    // 群聊策略：open(开放) / close(关闭)
      "messageType": "markdown" // 回复格式：markdown / text
    }
  }
}

注意：clientId 对应钉钉后台的 AppKey，clientSecret 对应 AppSecret。

2. 重启服务

配置生效后，重启 OpenClaw 网关以加载新通道：

openclaw gateway restart

3. 验证运行

• 打开钉钉，进入已授权机器人的私聊窗口或群组。
• 发送一条文本消息（如“你好”），或在群中 @机器人 发送消息。
• 机器人将通过 Stream 模式实时返回 AI 生成的回复。
• 停止生成：在 AI 回复过程中，发送 停止 、stop、/stop 或按下 esc（取决于客户端支持）即可中断当前生成。

至此，您已成功部署并运行钉钉 Channel 插件。更多高级功能（如多 Agent 路由、AI 卡片、文档解析等）请参考项目详细文档。