<div align="center">
<img alt="DingTalk" src="https://raw.githubusercontent.com/DingTalk-Real-AI/dingtalk-openclaw-connector/main/docs/images/dingtalk.svg" width="72" height="72" />
<h1>OpenClaw DingTalk/钉钉 插件</h1>
<p>钉钉官方出品的 OpenClaw 钉钉 Channel 插件，将你的 OpenClaw Agent 无缝连接到钉钉，<br/>赋予其直接收发消息、操作文档、管理日程、协同待办等能力。</p>
<p>
<a href="https://www.npmjs.com/package/@dingtalk-real-ai/dingtalk-connector"><img src="https://img.shields.io/npm/v/@dingtalk-real-ai/dingtalk-connector.svg?style=flat&colorA=18181B&colorB=28CF8D" alt="npm version" /></a>
<a href="https://www.npmjs.com/package/@dingtalk-real-ai/dingtalk-connector"><img src="https://img.shields.io/npm/dm/@dingtalk-real-ai/dingtalk-connector.svg?style=flat&colorA=18181B&colorB=28CF8D" alt="npm downloads" /></a>
<a href="https://github.com/DingTalk-Real-AI/dingtalk-openclaw-connector/blob/main/LICENSE"><img src="https://img.shields.io/github/license/DingTalk-Real-AI/dingtalk-openclaw-connector.svg?style=flat&colorA=18181B&colorB=28CF8D" alt="license" /></a>
</p>
<p>
<a href="README.en.md">English</a> •
<a href="CHANGELOG.md">更新日志</a> •
<a href="https://openclaw.ai/">OpenClaw 官网</a>
</p>
</div>
特性
本插件为 OpenClaw 提供全面的钉钉集成能力：
| 类别 | 能力 |
|------|------|
| 📄 钉钉文档 | 创建、追加、搜索、列举钉钉文档 |
| 🔔 DING 消息 | 向用户/群发送强提醒 DING |
| 💬 消息收发 | 接收群聊/私聊消息，自动回复，发送文本/Markdown，@成员 |
| ✅ 待办任务 | 创建个人待办，查状态，设截止时间 |
| 📊 AI 表格 | 创建表格，读写行数据，条件查询 |
| 📅 日历日程 | 日历管理、日程管理（创建/查询/修改/删除/搜索）、参会人管理、忙闲查询 |
| 📝 日志 | 提交日报/周报，查历史日志 |
此外，插件还支持：
- 🌊 AI Card 流式响应：打字机效果，在消息卡片中实时流式显示回复
- 📱 交互式卡片：实时状态更新（思考中/生成中/完成），敏感操作确认按钮
- 🔒 权限策略：为私聊和群聊提供灵活的访问控制策略
- ⚙️ 多 Agent 路由：将多个机器人连接到不同 Agent，实现专业化服务
- 🖼️ 富媒体处理：接收图片/音频/文件附件，自动上传本地图片
- 🔄 会话管理：多轮对话上下文保持，私聊/群聊会话隔离
🚧 Coming Soon — 以下能力正在开发中，敬请期待！
| 类别 | 能力 |
|------|------|
| ✅ 待办任务 | 创建群待办，查状态，设截止时间 |
| 📁 文件云盘 | 上传/下载文件到钉钉云盘 |
安全与风险提示（使用前必读）
本插件对接 OpenClaw AI 自动化能力，存在模型幻觉、执行不可控、提示词注入等固有风险。授权钉钉权限后，OpenClaw 将以你的用户身份在授权范围内执行操作，可能导致敏感数据泄露或越权操作等高风险后果，请谨慎使用。
为降低风险，插件已在多个层面启用默认安全保护，但风险仍然存在。；一旦放开相关限制，风险将显著提高，后果需由你自行承担。