---

Features

This plugin provides comprehensive DingTalk integration for OpenClaw:

Category	Capabilities
📄 Docs	Create, append, search, and list DingTalk documents
🔔 DING	Send urgent DING reminders to users/groups
💬 Messaging	Receive group/DM messages, auto-reply, send text/Markdown, @mentions
✅ Tasks	Create personal tasks, check status, set deadlines
📊 AI Sheets	Create sheets, read/write rows, conditional queries
📅 Calendar	Calendar management, event management (create/query/modify/delete/search), attendee management, free/busy queries
📝 Reports	Submit daily/weekly reports, query history

Additionally, the plugin supports:

• 🌊 AI Card Streaming: Typewriter-style live streaming responses within message cards
• 📱 Interactive Cards: Real-time status updates (Thinking/Generating/Complete), confirmation buttons for sensitive operations
• 🔒 Permission Policies: Flexible access control policies for DMs and group chats
• ⚙️ Multi-Agent Routing: Connect multiple bots to different Agents for specialized services
• 🖼️ Rich Media: Receive images/audio/file attachments, auto-upload local images
• 🔄 Session Management: Multi-turn conversation context, isolated sessions for DMs/groups

🚧 Coming Soon — The following capabilities are under active development!

Category	Capabilities
✅ Tasks	Create group tasks, check status, set deadlines
📁 Drive	Upload/download files to DingTalk Drive

---

Security & Risk Warnings (Read Before Use)

This plugin integrates with OpenClaw AI automation capabilities and carries inherent risks such as model hallucinations, unpredictable execution, and prompt injection. After you authorize DingTalk permissions, OpenClaw will act under your user identity within the authorized scope, which may lead to high-risk consequences such as leakage of sensitive data or unauthorized operations. Please use with caution.

To reduce these risks, the plugin enables default security protections at multiple layers. However, these risks still exist. We strongly recommend that you do not proactively modify any default security settings; once relevant restrictions are relaxed, the risks will increase significantly, and you will bear the consequences.

We recommend using the DingTalk bot connected to OpenClaw as a personal conversational assistant. Avoid deploying it directly in enterprise production environments. If you plan to use it with a company account, please comply with your company's information security policies.

By using this plugin, you are deemed to have fully understood and voluntarily assumed all related risks and responsibilities.

---

Requirements & Installation

Before you start, make sure you have:

• OpenClaw: Installed and running properly. Visit the OpenClaw website for details.
• Version: OpenClaw ≥ 2026.8.1. Check with openclaw -v. This version uses the current plugin SDK, runtime config snapshots, and host-owned queue/interrupt semantics. On older hosts, keep connector 0.8.25 until you upgrade OpenClaw.

If below this version, upgrade with: npm install -g [email protected]

One-Click Install + QR Auth (Recommended)

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

During installation, the terminal will display a DingTalk authorization QR code. Scan it with the DingTalk mobile app and tap "Create Bot" to complete authorization.

When you see Success! Bot configured., the authorization is complete. Then restart the Gateway:

openclaw gateway restart

💡 Scan failure does not affect installation: Even if the QR flow fails, plugin dependencies will still be installed. See Manual Setup Guide to complete configuration.

---

Usage Guide

OpenClaw DingTalk Plugin User Guide

---

Advanced Documentation

• Manual Setup Guide — Configure credentials manually
• DingTalk DEAP Agent Integration — Local device operation capabilities
• Multi-Agent Routing — Bind multiple bots to different Agents
• Troubleshooting — Installation and usage issue resolution

---

Feedback & Community

Before filing an Issue / PR, please skim the pinned notice — clear context helps us debug faster:

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

Quick routing:

• Other DingTalk product / open-platform capabilities (outside this connector) → DingTalk developer ticket center
• OpenClaw upstream (gateway, models, channels, etc.) → openclaw/openclaw Issues
• dingtalk-workspace-cli (dws) (DingTalk workspace CLI behavior) → dingtalk-workspace-cli Issues
• This connector → GitHub Issues

---

Contributing

PRs are welcome — small, well-described changes with clear verification land fastest; for larger changes, please open an Issue first. Doc-style reference: #514 · code-style reference: #581.

Quarterly thanks: each quarter, the top 3 PR contributors get a small gift or an invite to a DingTalk on-site visit (details per quarterly announcement). Thanks for co-building the community.

---

License

This project is licensed under the MIT License.

---

Support

• Issues: GitHub Issues
• Changelog: CHANGELOG.md