A dedicated interface for executing DingTalk messaging operations and user lookups using the uxc CLI and modern OpenAPI specifications.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install dingtalk-openapi-skill
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-openapi-skill 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 Messaging Skill?
The DingTalk Messaging Skill enables developers to interact with the newer DingTalk v1 APIs for robust messaging automation. By utilizing Openclaw Skills, this tool provides a structured way to handle bot-to-user communications, group chats, and service group requests. It specifically focuses on request/response patterns for high-frequency messaging tasks, utilizing the uxc skill for shared execution logic and automated authentication management. This skill is pinned to the modern DingTalk Open Platform host to ensure consistency in auth and schema shape.
DingTalk Messaging Skill Use Cases
- Automating batch internal notifications to employees via 1-to-1 bot sends.
- Posting real-time operational alerts into DingTalk group conversations.
- Facilitating automated responses within DingTalk service groups for support efficiency.
- Retrieving user profile information by unionId to personalize automated messages.
- Building automated messaging workflows that require secure, app-based authentication.
How DingTalk Messaging Skill Works
- The user configures credentials using appKey and appSecret via the uxc auth bootstrap system.
- A specialized CLI command is created by linking the DingTalk v1 API host to the curated OpenAPI schema.
- The skill manages the lifecycle of the accessToken, refreshing it automatically when necessary to maintain connectivity.
- Messaging commands are executed by providing routing identifiers like robotCode, openConversationId, and target identifiers.
- Payloads are formatted as JSON-encoded strings within the msgParam field and dispatched to the DingTalk Open Platform via the uxc execution engine.
DingTalk Messaging Skill Setup
First, set up your credentials and bootstrap configuration to handle automated token refreshes for your Openclaw Skills:
uxc auth credential set dingtalk-app \
--auth-type bearer \
--field app_key=env:DINGTALK_APP_KEY \
--field app_secret=env:DINGTALK_APP_SECRET
uxc auth bootstrap set dingtalk-app \
--token-endpoint https://api.dingtalk.com/v1.0/oauth2/accessToken \
--header 'Content-Type=application/json' \
--request-json '{"appKey":"{{field:app_key}}","appSecret":"{{field:app_secret}}"}' \
--access-token-pointer /accessToken \
--expires-in-pointer /expireIn
Next, bind the credential to the API host and link the CLI tool:
uxc auth binding add --id dingtalk-app --host api.dingtalk.com --path-prefix /v1.0 --scheme https --credential dingtalk-app --priority 100
uxc link dingtalk-openapi-cli https://api.dingtalk.com/v1.0 --schema-url https://raw.githubusercontent.com/holon-run/uxc/main/skills/dingtalk-openapi-skill/references/dingtalk-messaging.openapi.json
DingTalk Messaging Skill Data Schema & Taxonomy
The skill organizes its operations based on the DingTalk v1 OpenAPI schema, focusing on the following data structures:
| Component | Description |
|---|---|
| API Host | https://api.dingtalk.com/v1.0 |
| Auth Scheme | Bearer (Managed via uxc auth bootstrap) |
| Primary Operations | batchSend (1-to-1), groupSend, serviceGroupSend, userLookup |
| Identifier Types | unionId, openConversationId, robotCode, coolAppCode |
| Payload Type | msgParam (JSON-encoded string inside a JSON request) |
All output is wrapped in a stable JSON envelope containing ok, kind, protocol, data, and error fields.
DingTalk Messaging Skill Advanced Features
- Automated Token Management: Leverages uxc auth bootstrap to automatically fetch and refresh short-lived access tokens.
- Flexible Execution: Supports both key/value pairs and positional JSON strings for complex msgParam payloads.
- Scoped Guardrails: Includes explicit verification for high-risk write operations to prevent accidental message spamming.
- Integrated Schema Validation: Uses a curated OpenAPI schema to provide help documentation and parameter validation directly in the CLI.
- Extensible Logic: Designed to work alongside other Openclaw Skills for complex multi-agent automation workflows.
SKILL.md
Loading
Related Openclaw Skills
Lobster Quant Company
A comprehensive multi-agent architecture that instantly deploys a 17-member quantitative investment and research team.
Notion
A comprehensive automation skill for the Notion API that enables programmatic management of pages, data sources, and content blocks.
ColorsCC
A high-performance, stateless color API and asset toolset specifically designed for AI agents like OpenClaw.
Skill Vetter
A security-focused vetting protocol designed to audit and verify AI agent skills before deployment.
AI Intelligent Agent Platform
A comprehensive development platform for building intelligent agents with visual workflow orchestration and advanced memory management.
AI Intelligent Agriculture Monitoring
A sophisticated AI-driven system designed for real-time crop growth monitoring, automated pest identification, and precision agriculture management.
Featured*
