A comprehensive integration for the DingTalk Open Platform that enables automated messaging, organizational management, and real-time event processing.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install dingtalk-bot-publish
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install dingtalk-bot-publish using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is DingTalk API Skill?
The DingTalk API skill is a powerful toolset designed for developers using Openclaw Skills to interact deeply with the DingTalk enterprise ecosystem. It provides a bridge between AI agents and DingTalk's robust backend, supporting everything from basic user queries to complex OA approval workflows. By leveraging both traditional REST APIs and modern WebSocket-based Stream mode, this skill allows for responsive and intelligent enterprise automation.
This skill is particularly valuable for organizations looking to deploy AI-driven robots that can maintain conversation context, manage departmental data, and route messages efficiently across private and group chats. It ensures high performance with low latency while maintaining strict data isolation and security standards required for enterprise-grade applications.
DingTalk API Skill Use Cases
- Automating organizational directory lookups and department management tasks.
- Deploying intelligent robots for real-time private and group chat interactions within Openclaw Skills.
- Managing complex OA approval processes, including initiating, terminating, and transferring tasks.
- Synchronizing enterprise employee statistics and organizational architecture mapping.
- Processing real-time event subscriptions via WebSocket for immediate system responses.
How DingTalk API Skill Works
- The skill initializes by authenticating with the DingTalk Open Platform using enterprise AppKey and AppSecret credentials.
- For standard operations, it triggers specific TypeScript scripts to perform CRUD operations on users, departments, and approval instances.
- When Stream mode is enabled, it establishes a persistent WebSocket connection to the DingTalk server to receive events and messages in real-time.
- A session management layer identifies the source of incoming messages (private vs. group) and retrieves the corresponding conversation context.
- AI-generated responses are processed and routed back through the DingTalk messaging API, ensuring reliable delivery and preventing multi-channel conflicts.
DingTalk API Skill Setup
To get started with this skill within Openclaw Skills, follow these installation steps:
# 1. Set environment variables
export DINGTALK_APP_KEY="<your-app-key>"
export DINGTALK_APP_SECRET="<your-app-secret>"
# 2. For Stream mode (Recommended), set up the Python bridge
python3 -m venv dingtalk_venv
source dingtalk_venv/bin/activate
pip install dingtalk-stream
# 3. Start the Stream service
./start_dingtalk_stream.sh
Ensure your DingTalk application has the necessary permissions granted in the DingTalk Developer Console.
DingTalk API Skill Data Schema & Taxonomy
The skill organizes its operations and persistence through a structured file system:
| Directory | Content Description |
|---|---|
scripts/ |
TypeScript-based API invocation scripts for users, departments, and messages. |
stream/ |
Python bridge files, session managers, and reply tools for real-time processing. |
memory/ |
Runtime-generated JSON files storing persistent conversation history and user context. |
types/ |
TypeScript interface definitions for DingTalk API responses and request payloads. |
package.json |
Dependency management for the Node.js execution environment. |
DingTalk API Skill Advanced Features
- Real-time Stream Mode: Low-latency event processing via WebSocket for instant interactions.
- Multi-Session Isolation: Complete context separation for different users and groups within Openclaw Skills.
- Persistent Conversation Memory: Automatic storage and retrieval of dialogue history in the memory directory.
- Advanced OA Approval Tools: Full lifecycle management of enterprise approval instances and comments.
- Automatic Resource Management: 24-hour inactivity cleanup for sessions to optimize system memory.
SKILL.md
Loading
Related Openclaw Skills
Cord Sentinel
A robust constitutional enforcement engine designed to govern AI agent tool calls through a strict 11-article security framework.
Labradoc CLI Skill
A powerful interface for managing Labradoc document intelligence, tasks, and file operations directly via the CLI.
Bring! Shopping List
A high-performance AI agent skill for managing Bring! shopping lists through natural language commands and automated synchronization.
Google Docs API Integration
A developer-focused skill for programmatically creating, formatting, and managing Google Documents via the official REST API.
OpenQQ Bot
A high-performance QQ bot integration for OpenClaw that enables AI-driven automated replies in private and group conversations.
WA-Relay
A secure WhatsApp relay and firewall that prevents AI agents from directly interacting with third parties without owner consent.