Agent Skills
› dtyq/magic
› dingtalk-cli
dingtalk-cli
GitHub钉钉CLI技能，覆盖消息、文档、OA、考勤等全场景操作。需先加载dws技能，支持设备流认证及命令帮助查询，提供统一接口管理钉钉企业应用与数据。
Trigger Scenarios
用户需要发送或查询钉钉消息
用户需要管理钉钉文档、日历或OA审批
用户需要查询组织架构或联系人信息
Install
npx skills add dtyq/magic --skill dingtalk-cli -g -y
SKILL.md
Frontmatter
{
"name": "dingtalk-cli",
"description": "Use when the user wants to interact with DingTalk in any way — including but not limited to: reading, querying, searching, sending, replying to, forwarding, or recalling DingTalk chat messages and chat history; managing group chats and conversations; sending DING alerts; querying contacts, org structure, AI search, or coworkers; reading, searching, creating, or editing DingTalk docs, drive files, sheets, AI tables, wiki, mail, calendar events, meeting rooms, AI meeting minutes, attendance, OA approvals, todos, reports\/logs, live sessions, AI apps, permissions, or open-platform docs."
}
DingTalk CLI Skill Index
Before doing anything, you MUST load the dws skill first. It contains the full product reference, command syntax, intent routing decision tree, dangerous operation rules, and error handling guide. Do not proceed without reading it.
read_skills(skill_names=["dws"])
Product Overview
| Product | Use for | CLI entry |
|---|---|---|
aiapp |
AI apps: create, query, update | dws aiapp |
aisearch |
AI search: find people by name, employee number, phone, department, responsibility, reporting lines | dws aisearch |
aitable |
AI tables: bases, tables, fields, records, views, charts, dashboards, import/export | dws aitable |
attendance |
Attendance: punch records, shift schedules, statistics | dws attendance |
calendar |
Calendar: events, attendees, meeting rooms, availability | dws calendar |
chat |
Conversations, group chats, bot messaging, single chat, Webhook, message history, direct/group message list, sender filters, unread conversations, keyword and advanced message search, read/send status, send/reply/forward/recall | dws chat |
contact |
Contacts: user lookup, department structure | dws contact |
devdoc |
DingTalk open platform developer documentation search | dws devdoc |
ding |
DING alerts: send/recall (in-app / SMS / phone) | dws ding |
doc |
DingTalk docs: search, read, write, block edit, comments, copy/move | dws doc |
drive |
Cloud drive: file list, upload, download, folders | dws drive |
live |
Live sessions: list and info | dws live |
mail |
Mail: search, view, send | dws mail |
minutes |
AI meeting minutes: list, summary, transcript, todos, mindmap | dws minutes |
oa |
OA approvals: pending, submitted, approve, reject, revoke | dws oa |
pat |
Behavior authorization management | dws pat |
report |
Logs/reports: create by template, inbox, sent, statistics | dws report |
sheet |
DingTalk spreadsheets: worksheets, cells, formulas, images, find/replace | dws sheet |
todo |
Todos: create, query, update, complete, delete | dws todo |
wiki |
DingTalk wiki spaces and knowledge-base nodes | dws wiki |
Authentication
Before any DingTalk operation, verify auth status first:
dws auth status --format json
If authenticated is false, start the login flow. This environment has no browser (Docker/SSH), so always use the device flow:
dws auth login --device
The command outputs an authorization URL, then waits with the prompt Waiting for user authorization. At this point:
- Show the authorization URL to the user
- Ask the user to open the URL in a browser or DingTalk mobile app to complete authorization
- The command will automatically detect the authorization and proceed
To force re-login (e.g. token expired):
dws auth login --device --force
When Unsure About a Command
Always check --help before guessing parameters.
dws --help
dws <product> --help
dws <product> <command> --help
Examples:
dws chat --help
dws calendar event list --help
dws aitable record --help
Version History
- f9973c5 Current 2026-08-20 03:37
- 41d7ef4 2026-07-25 09:29
