dingtalk-cli

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