dingtalk-openclaw-connector

特性

本插件为 OpenClaw 提供全面的钉钉集成能力：

此外，插件还支持：

• AI Card 流式响应：打字机效果，在消息卡片中实时流式显示回复
• 交互式卡片：实时状态更新（思考中/生成中/完成），敏感操作确认按钮
• 权限策略：为私聊和群聊提供灵活的访问控制策略
• ⚙️ 多 Agent 路由：将多个机器人连接到不同 Agent，实现专业化服务
• ️ 富媒体处理：接收图片/音频/文件附件，自动上传本地图片
• 会话管理：多轮对话上下文保持，私聊/群聊会话隔离

Coming Soon — 以下能力正在开发中，敬请期待！

安全与风险提示（使用前必读）

本插件对接 OpenClaw AI 自动化能力，存在模型幻觉、执行不可控、提示词注入等固有风险。授权钉钉权限后，OpenClaw 将以你的用户身份在授权范围内执行操作，可能导致敏感数据泄露或越权操作等高风险后果，请谨慎使用。

为降低风险，插件已在多个层面启用默认安全保护，但风险仍然存在。我们强烈建议不要主动修改任何默认安全配置；一旦放开相关限制，风险将显著提高，后果需由你自行承担。

建议将接入 OpenClaw 的钉钉机器人作为个人对话助手使用，避免在企业生产环境中直接部署。若需在公司账号中使用，请遵守公司信息安全规范。

使用本插件即视为你已充分知悉并自愿承担所有相关风险与责任。

安装与要求

开始之前，请确保：

• OpenClaw：已安装并正常运行。详情请访问 OpenClaw 官网
• 版本要求：OpenClaw ≥ 2026.8.1，通过 openclaw -v 查看。本版本使用新的插件 SDK、运行时配置快照以及 Host 管理的消息队列与中断语义；旧版宿主请继续使用插件 0.8.25，升级宿主后再升级插件。

如低于此版本，执行 npm install -g [email protected] 升级。

一键安装 + 扫码授权（推荐）

npx -y @dingtalk-real-ai/dingtalk-connector install

安装过程中终端会显示钉钉授权二维码，使用钉钉手机 App 扫码，点击「一键创建新机器人」即可完成授权。

看到 Success! Bot configured. 即表示授权完成。之后重启 Gateway：

openclaw gateway restart

扫码失败不影响安装：即使扫码流程出现问题（如超时、二维码无法显示等），插件本身仍会正常安装。你可以稍后参考 手动配置指南 完成凭证配置。

使用指南

OpenClaw 钉钉官方插件使用指南

进阶文档

• 手动配置指南 — 手动填写凭证配置
• 钉钉 DEAP Agent 集成 — 本地设备操作能力
• 多 Agent 路由配置 — 多机器人绑定不同 Agent（从零配置、完整示例、协作模式）
• 常见问题 — 安装与使用问题排查

反馈与社区

提 Issue / PR 前，建议先看一眼置顶说明（信息完整能帮我们更快定位问题）：

• 中文：【提 Issue 前必看】#584
• English: [READ FIRST] #585

简要分流：

• 钉钉其他业务能力（非本 connector 范畴）→ 钉钉开发者侧工单入口
• OpenClaw 本体（网关、模型、多通道等）→ openclaw/openclaw Issues
• dws（钉钉工作空间 CLI） → dingtalk-workspace-cli Issues
• 本仓库 connector → GitHub Issues

贡献

欢迎提交 Pull Request：改动越小、描述与验证步骤越清晰，越容易合入；较大改动建议先开 Issue 同步。文档类参考 #514，代码类参考 #581。

季度致谢：每个季度对 PR 贡献量居前 3 位的伙伴提供小礼品或钉钉参观交流机会（细则以当季公告为准），感谢大家对社区共建的支持。

许可证

本项目基于 MIT 许可证。

支持

• 问题反馈：GitHub Issues
• 更新日志：CHANGELOG.md