skills.rest
openakita
openakitaCOMMUNITY
Explore all skills by this author →
GitHub

openakita/skills@dingtalk-cli

Operate DingTalk workspace resources through the dws command-line interface.

2.0k|274|Updated Jan 30, 2026
Search Tags:#CLI#approval#attendance#dws#dingTalk#bot messaging#Calendar
One-click install
npx skills add https://github.com/openakita/openakita --skill openakita-skills-dingtalk-cli
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openakita/skills@dingtalk-cli
Source: https://github.com/openakita/openakita/tree/main/skills/dingtalk-cli
Command: npx skills add https://github.com/openakita/openakita --skill openakita-skills-dingtalk-cli

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Managing DingTalk resources like messages, calendars, todos, approvals, and attendance normally requires manual clicks in the DingTalk app or writing custom API integrations. This Skill lets an AI agent operate all of these DingTalk products directly through the official dws CLI.

Core Features & Use Cases

  • 86 Commands Across 12 Products: Covers Contact, Chat, Bot, Calendar, Todo, Approval, Attendance, Ding, Report, AITable, Workbench, and DevDoc through one unified CLI.
  • Agent-Friendly Design: Built-in schema introspection (dws schema), automatic parameter correction, jq output filtering, and dry-run previews reduce errors and token consumption.
  • Helper Scripts: Includes dws_setup.py for cross-platform installation and OAuth authentication, plus dws_quick.py for common operations like sending bot messages, searching contacts, listing calendar events, and creating todos.
  • Use Case: Ask the agent to send a weekly report to a DingTalk group via a bot, find a free meeting slot, or batch-create todos, and it will invoke the appropriate dws commands with validated parameters.

Quick Start

Ask the agent to install and authenticate the DingTalk CLI, then send a message to a DingTalk group using your bot's robot code and group ID.

Frequently Asked Questions about openakita/skills@dingtalk-cli

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I send a message to a DingTalk group with a bot?▼

Use the dws chat message send-by-bot command with --robot-code and --group parameters, or run the dws_quick.py send helper script. The --text flag supports @file references to read message content from a local file.

How to install the DingTalk dws CLI on macOS or Windows?▼

On macOS or Linux, run the official install script via curl, or use npm install -g dingtalk-workspace-cli. On Windows, run the PowerShell install script. The dws_setup.py script automates all of these methods.

What DingTalk products does the dws CLI support?▼

The dws CLI provides 86 commands across 12 products: Contact, Chat, Bot, Calendar, Todo, Approval, Attendance, Ding, Report, AITable, Workbench, and DevDoc. You can discover available tools dynamically with dws schema.

Does dws CLI work in headless environments like Docker or CI?▼

Yes, use dws auth login --device for headless environments such as Docker, SSH, or CI pipelines. For CI/CD and ISV integrations, you can also authenticate with --client-id and --client-secret custom app credentials.

How does dws CLI store DingTalk credentials securely?▼

Credentials are encrypted with PBKDF2 and AES-256-GCM keyed to the device's physical MAC address. Bearer tokens are only sent to whitelisted dingtalk.com domains, and client secrets are never persisted to disk.

Can I preview a dws command before executing it?▼

Yes, append the --dry-run flag to any dws command to display the call parameters without executing the operation. This prevents accidental modifications to calendars, approvals, or messages.

Related Skills

Explore More Software Engineering Skills→
openaiopenai
5.3k

sign-in-with-vercel

Implements OAuth 2.0 and OIDC user authentication using Vercel as the identity provider.

Official
Basic
farrrrfarrrr

dingtalk-attendance

Manage DingTalk attendance groups, shifts, punch logs, and leave approvals via OpenAPI.

Community
Advanced
XronicalXronical

channels-setup

Configure Telegram, Discord, Slack, and other communication channels for OpenClaw.

Community
Intermediate
auth0auth0
40

go-jwt-middleware

Validate JWT Bearer tokens for access control in Go HTTP APIs.

Official
Advanced