DingTalk CLI for Openclaw

A professional command-line interface for AI agents to interact with DingTalk documents, spreadsheets, and knowledge base nodes.

ianen
v1.0.0
Mar 18, 2026
0
1.1k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install dingtalk-cli

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install dingtalk-cli 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 CLI?

DingTalk CLI is a specialized tool designed to bridge the gap between AI agents and the DingTalk Open Platform. It allows for seamless interaction with DingTalk's collaborative ecosystem, including knowledge base management, document CRUD operations, and spreadsheet data extraction. By using this tool within Openclaw Skills, developers can empower their agents to read, write, and organize corporate knowledge effectively.

The tool is optimized for programmatic use, supporting JSON output and explicit safety flags for destructive operations. It handles the complexities of DingTalk's authentication and node-based file system, making it an essential component for any workflow involving DingTalk-based documentation or team collaboration.

DingTalk CLI Use Cases

  • Synchronizing local technical documentation to DingTalk knowledge bases via Markdown.
  • Automating the creation and deletion of temporary collaboration documents.
  • Extracting data ranges from DingTalk .axls spreadsheets for AI-driven analysis.
  • Programmatically managing document permissions and team member access.
  • Resolving DingTalk document URLs into actionable node IDs for agent processing.

How DingTalk CLI Works

  1. The user authenticates the CLI using DingTalk App credentials (App Key and Secret) and an operator UnionID.
  2. The CLI connects to the DingTalk Open Platform APIs to fetch workspace and node metadata.
  3. For document operations, the tool translates Markdown or local files into DingTalk-compatible formats.
  4. For spreadsheets, it targets specific workbooks and ranges to retrieve or update structured data.
  5. The agent receives structured JSON responses, allowing for logical branching and further automation steps.

DingTalk CLI Setup

Install the package using pip:

pip install dingtalk-cli

Configure your authentication credentials (stored in ~/.dingtalk-cli/config.json):

dingtalk-cli auth setup \
  --app-key <APP_KEY> \
  --app-secret <APP_SECRET> \
  --operator-union-id <UNION_ID>

Alternatively, you can use environment variables such as DINGTALK_APP_KEY and DINGTALK_APP_SECRET for configuration.

DingTalk CLI Data Schema & Taxonomy

The DingTalk CLI interacts with several key data entities within the DingTalk ecosystem:

Entity Description
Workspace The top-level container for a knowledge base or wiki.
Node A specific file entry, which can be a document, spreadsheet, or folder.
Doc Key A unique identifier for the document content itself.
Workbook The data structure representing .axls spreadsheet files.
Member User entities identified by UnionID or UserID with assigned roles like 'editor' or 'reader'.

DingTalk CLI Advanced Features

  • Full support for .axls spreadsheet workbook, sheet, and range reading.
  • Markdown-based document overwriting for automated content updates.
  • URL resolution to identify node information from standard browser links.
  • Agent-optimized mode using the --json flag for reliable data parsing.
  • Explicit safety checks with the --yes flag for all delete and overwrite commands.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*