# @dingtalk-real-ai/dingtalk-connector 中文文档 规范地址：https://npmcn.com/package/%40dingtalk-real-ai/dingtalk-connector/ 版本：0\.8\.27 npm 元数据更新时间：2026-10-20T07:11:14.458Z 中文译文更新时间：2026-11-12T10:12:43.001Z 软件包许可：MIT 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40dingtalk-real-ai/dingtalk-connector 原文对照：https://npmcn.com/package/%40dingtalk-real-ai/dingtalk-connector/?lang=original 项目主页：https://github.com/DingTalk-Real-AI/dingtalk-openclaw-connector#readme 源码仓库：https://github.com/DingTalk-Real-AI/dingtalk-openclaw-connector ## 关键信息（来自 npm 元数据） - 包体积（解压后）：2 MB，191 个文件 - 模块格式：ES Module - TypeScript 类型：包内自带 - 运行依赖：5 个 - peer 依赖：openclaw \>=2026\.8\.1 - 首次发布：2026-02-16T11:53:59.726Z - 最新版本发布：2026-10-20T07:11:14.172Z - 近 30 天下载量：5625（2026-10-13 至 2026-11-11，npm 官方下载统计） - 已发布版本数：86（近 12 个月 86 个） ## 中文简介 官方 OpenClaw DingTalk 频道插件 QQ OpenClaw QQ ## 安装 ```sh npm install @dingtalk-real-ai/dingtalk-connector ``` 也可以使用：`pnpm add @dingtalk-real-ai/dingtalk-connector`、`yarn add @dingtalk-real-ai/dingtalk-connector`、`bun add @dingtalk-real-ai/dingtalk-connector` ## README ![DingTalk](https://raw.githubusercontent.com/DingTalk-Real-AI/dingtalk-openclaw-connector/main/docs/images/dingtalk.svg) # OpenClaw DingTalk/钉钉 插件 钉钉官方出品的 OpenClaw 钉钉 Channel 插件，将你的 OpenClaw Agent 无缝连接到钉钉， 赋予其直接收发消息、操作文档、管理日程、协同待办等能力。 [![npm version](https://img.shields.io/npm/v/@dingtalk-real-ai/dingtalk-connector.svg?style=flat&colorA=18181B&colorB=28CF8D)](https://www.npmjs.com/package/@dingtalk-real-ai/dingtalk-connector) [![npm downloads](https://img.shields.io/npm/dm/@dingtalk-real-ai/dingtalk-connector.svg?style=flat&colorA=18181B&colorB=28CF8D)](https://www.npmjs.com/package/@dingtalk-real-ai/dingtalk-connector) [![license](https://img.shields.io/github/license/DingTalk-Real-AI/dingtalk-openclaw-connector.svg?style=flat&colorA=18181B&colorB=28CF8D)](https://github.com/DingTalk-Real-AI/dingtalk-openclaw-connector/blob/main/LICENSE) [English](https://npmcn.com/package/%40dingtalk-real-ai/dingtalk-connector/README.en.md) • [更新日志](https://npmcn.com/package/%40dingtalk-real-ai/dingtalk-connector/CHANGELOG.md) • [OpenClaw 官网](https://openclaw.ai/) * * * ## 特性 本插件为 OpenClaw 提供全面的钉钉集成能力： | 类别 | 能力 | | --- | --- | | 📄 钉钉文档 | 创建、追加、搜索、列举钉钉文档 | | 🔔 DING 消息 | 向用户/群发送强提醒 DING | | 💬 消息收发 | 接收群聊/私聊消息，自动回复，发送文本/Markdown，@成员 | | ✅ 待办任务 | 创建个人待办，查状态，设截止时间 | | 📊 AI 表格 | 创建表格，读写行数据，条件查询 | | 📅 日历日程 | 日历管理、日程管理（创建/查询/修改/删除/搜索）、参会人管理、忙闲查询 | | 📝 日志 | 提交日报/周报，查历史日志 | 社区能力对齐：支持引用恢复、常见文本附件正文、v2 结构化流式卡片、原生交互表单、实验 @多助手、`/btw` 旁路和实时停止。配置、模板与使用边界见 [社区能力对齐使用说明](https://npmcn.com/package/%40dingtalk-real-ai/dingtalk-connector/docs/COMMUNITY_CAPABILITY_ALIGNMENT.md)。 此外，插件还支持： - 🌊 **AI Card 流式响应**：打字机效果，在消息卡片中实时流式显示回复 - 📱 **交互式卡片**：实时状态更新（思考中/生成中/完成），敏感操作确认按钮 - 🔒 **权限策略**：为私聊和群聊提供灵活的访问控制策略 - ⚙️ **多 Agent 路由**：将多个机器人连接到不同 Agent，实现专业化服务 - 🖼️ **富媒体处理**：接收图片/音频/文件附件，自动上传本地图片 - 🔄 **会话管理**：多轮对话上下文保持，私聊/群聊会话隔离 > 🚧 **Coming Soon** — 以下能力正在开发中，敬请期待！ | 类别 | 能力 | | --- | --- | | ✅ 待办任务 | 创建群待办，查状态，设截止时间 | | 📁 文件云盘 | 上传/下载文件到钉钉云盘 | * * * ## 安全与风险提示（使用前必读） 本插件对接 OpenClaw AI 自动化能力，存在模型幻觉、执行不可控、提示词注入等固有风险。授权钉钉权限后，OpenClaw 将以你的用户身份在授权范围内执行操作，可能导致敏感数据泄露或越权操作等高风险后果，请谨慎使用。 为降低风险，插件已在多个层面启用默认安全保护，但风险仍然存在。**我们强烈建议不要主动修改任何默认安全配置**；一旦放开相关限制，风险将显著提高，后果需由你自行承担。 建议将接入 OpenClaw 的钉钉机器人作为**个人对话助手**使用，避免在企业生产环境中直接部署。若需在公司账号中使用，请遵守公司信息安全规范。 > 使用本插件即视为你已充分知悉并自愿承担所有相关风险与责任。 * * * ## 安装与要求 开始之前，请确保： - **OpenClaw**：已安装并正常运行。详情请访问 [OpenClaw 官网](https://openclaw.ai/) - **版本要求**：OpenClaw ≥ **2026.8.1**，通过 `openclaw -v` 查看。本版本使用新的插件 SDK、运行时配置快照以及 Host 管理的消息队列与中断语义；旧版宿主请继续使用插件 0.8.25，升级宿主后再升级插件。 > 如低于此版本，执行 `npm install -g openclaw@2026.8.1` 升级。 ### 一键安装 + 扫码授权（推荐） ```bash npx -y @dingtalk-real-ai/dingtalk-connector install ``` 安装过程中终端会显示钉钉授权二维码，使用**钉钉手机 App** 扫码，点击「一键创建新机器人」即可完成授权。 看到 `Success! Bot configured.` 即表示授权完成。之后重启 Gateway： ```bash openclaw gateway restart ``` > 💡 扫码失败不影响安装：即使扫码流程出现问题（如超时、二维码无法显示等），插件本身仍会正常安装。你可以稍后参考 [手动配置指南](https://npmcn.com/package/%40dingtalk-real-ai/dingtalk-connector/docs/DINGTALK_MANUAL_SETUP.md) 完成凭证配置。 * * * ## 使用指南 [OpenClaw 钉钉官方插件使用指南](https://alidocs.dingtalk.com/i/nodes/2Amq4vjg89GEno0zfPqoPGqdV3kdP0wQ?utm_scene=team_space) * * * ## 进阶文档 - [手动配置指南](https://npmcn.com/package/%40dingtalk-real-ai/dingtalk-connector/docs/DINGTALK_MANUAL_SETUP.md) — 手动填写凭证配置 - [钉钉 DEAP Agent 集成](https://npmcn.com/package/%40dingtalk-real-ai/dingtalk-connector/docs/DEAP_AGENT_GUIDE.md) — 本地设备操作能力 - [多 Agent 路由配置](https://npmcn.com/package/%40dingtalk-real-ai/dingtalk-connector/docs/MULTI_AGENT_SETUP.md) — 多机器人绑定不同 Agent（从零配置、完整示例、协作模式） - [常见问题](https://npmcn.com/package/%40dingtalk-real-ai/dingtalk-connector/docs/TROUBLESHOOTING.md) — 安装与使用问题排查 * * * ## 反馈与社区 提 Issue / PR 前，建议先看一眼置顶说明（信息完整能帮我们更快定位问题）： - 中文：[【提 Issue 前必看】#584](https://github.com/DingTalk-Real-AI/dingtalk-openclaw-connector/issues/584) - English: [\[READ FIRST\] #585](https://github.com/DingTalk-Real-AI/dingtalk-openclaw-connector/issues/585) 简要分流： - **钉钉其他业务能力**（非本 connector 范畴）→ [钉钉开发者侧工单入口](https://applink.dingtalk.com/client/aiAgent?assistantId=381bb5860c264d33bc184c51db776fa7&from=development) - **OpenClaw 本体**（网关、模型、多通道等）→ [openclaw/openclaw Issues](https://github.com/openclaw/openclaw/issues) - **dws（钉钉工作空间 CLI）** → [dingtalk-workspace-cli Issues](https://github.com/DingTalk-Real-AI/dingtalk-workspace-cli/issues) - **本仓库 connector** → [GitHub Issues](https://github.com/DingTalk-Real-AI/dingtalk-openclaw-connector/issues) * * * ## 贡献 欢迎提交 Pull Request：改动越小、描述与验证步骤越清晰，越容易合入；较大改动建议先开 Issue 同步。文档类参考 [#514](https://github.com/DingTalk-Real-AI/dingtalk-openclaw-connector/pull/514/changes)，代码类参考 [#581](https://github.com/DingTalk-Real-AI/dingtalk-openclaw-connector/pull/581)。 > **季度致谢**：每个季度对 PR 贡献量居前 3 位的伙伴提供小礼品或钉钉参观交流机会（细则以当季公告为准），感谢大家对社区共建的支持。 * * * ## 许可证 本项目基于 [MIT](https://npmcn.com/package/%40dingtalk-real-ai/dingtalk-connector/LICENSE) 许可证。 * * * ## 支持 - **问题反馈**：[GitHub Issues](https://github.com/DingTalk-Real-AI/dingtalk-openclaw-connector/issues) - **更新日志**：[CHANGELOG.md](https://npmcn.com/package/%40dingtalk-real-ai/dingtalk-connector/CHANGELOG.md) ## 常见问题 ### @dingtalk-real-ai/dingtalk-connector 是什么？ 官方 OpenClaw DingTalk 频道插件 QQ OpenClaw QQ ### 如何安装 @dingtalk-real-ai/dingtalk-connector？ 在项目目录运行 npm install @dingtalk-real-ai/dingtalk-connector，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 dingtalk-connector，可以用 npx dingtalk-connector 直接运行。 ### @dingtalk-real-ai/dingtalk-connector 支持 TypeScript 吗？ 支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。 ### @dingtalk-real-ai/dingtalk-connector 支持 ESM 还是 CommonJS？ 以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。 ### @dingtalk-real-ai/dingtalk-connector 可以商用吗？ @dingtalk-real-ai/dingtalk-connector 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。 ### @dingtalk-real-ai/dingtalk-connector 的下载量有多少？ 根据 npm 官方下载统计，@dingtalk-real-ai/dingtalk-connector 在 2026/10/13 – 2026/11/11 这 30 天内被下载 5,625 次，日均约 188 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @dingtalk-real-ai/dingtalk-connector 还在维护吗？ 最新版本 0\.8\.27 发布于 2026/10/20（23 天前）；至今共发布 86 个版本，其中过去 12 个月发布了 86 个；首次发布于 2026/02/16。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。