OpenParable
Skip to content
← Back to skills

Dingtalk CLI

Apps & Automation
dingtalk-cli

Dingtalk CLI is an Agent Skill for apps & automation published in the dtyq/magic repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

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.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/dtyq/magic/blob/HEAD/backend/super-magic/agents/skills/dingtalk-cli/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/dingtalk-cli, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

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

ProductUse forCLI entry
aiappAI apps: create, query, updatedws aiapp
aisearchAI search: find people by name, employee number, phone, department, responsibility, reporting linesdws aisearch
aitableAI tables: bases, tables, fields, records, views, charts, dashboards, import/exportdws aitable
attendanceAttendance: punch records, shift schedules, statisticsdws attendance
calendarCalendar: events, attendees, meeting rooms, availabilitydws calendar
chatConversations, 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/recalldws chat
contactContacts: user lookup, department structuredws contact
devdocDingTalk open platform developer documentation searchdws devdoc
dingDING alerts: send/recall (in-app / SMS / phone)dws ding
docDingTalk docs: search, read, write, block edit, comments, copy/movedws doc
driveCloud drive: file list, upload, download, foldersdws drive
liveLive sessions: list and infodws live
mailMail: search, view, senddws mail
minutesAI meeting minutes: list, summary, transcript, todos, mindmapdws minutes
oaOA approvals: pending, submitted, approve, reject, revokedws oa
patBehavior authorization managementdws pat
reportLogs/reports: create by template, inbox, sent, statisticsdws report
sheetDingTalk spreadsheets: worksheets, cells, formulas, images, find/replacedws sheet
todoTodos: create, query, update, complete, deletedws todo
wikiDingTalk wiki spaces and knowledge-base nodesdws 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:

  1. Show the authorization URL to the user
  2. Ask the user to open the URL in a browser or DingTalk mobile app to complete authorization
  3. 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