DingTalk Workspace CLI

在数字化办公时代，钉钉已经深度融入无数企业和团队的日常工作。但对于开发者、运维人员和 AI Agent 爱好者来说，图形界面有时反而成了效率瓶颈。DingTalk Workspace CLI（简称 dws） 应运而生，它是钉钉官方开源的跨平台命令行工具，将钉钉全产品能力统一打包，支持人类高效操作，更原生适配 AI Agent 场景。

DingTalk Workspace CLI 网站截图

为什么 dws 如此特别？核心特色一览

1. 双轮驱动：兼顾人类与 AI Agent
   • 人类友好：丰富的 –help 提示、–dry-run 预览请求、-f table/json/raw 输出格式切换，让命令行操作丝滑顺手。
   • AI 原生：提供结构化 JSON 响应 + 内置 Agent Skills，开箱即用。Claude、Cursor 等 AI 工具可通过自然语言直接调用钉钉能力，极大降低集成门槛。
2. 企业级安全设计（零信任架构） 采用 OAuth 设备流认证、域名白名单、最小权限原则。没有一个字节能绕过鉴权和审计，适合企业管理员严格管控。支持多组织（profile）切换、凭证安全存储（Keychain）和导出/导入迁移，满足复杂场景需求。
3. 全面覆盖钉钉生态 支持联系人管理、日历事件、文档搜索、AI 听记、钉盘文件、待办任务、智能表格（Aitable）等核心服务。命令直观，例如：
   • dws contact user search –query “张三” 搜索联系人
   • dws calendar event list 查看日程
   • dws todo task create –title “季度汇报” 创建待办
4. 强大扩展与易用性
   • Schema 动态发现：dws schema 让 Agent 自动探索可用工具和参数，无需硬编码。
   • Skill 模式灵活：mono（推荐，单一入口跨产品）与 multi（实验，单产品小上下文）两种布局。
   • 自升级机制：dws upgrade 一键升级，支持回滚、校验和备份。
   • 国内优化：Gitee 镜像 + npmmirror，加速安装。

如何安装与部署？超简上手指南

一键安装（推荐）： macOS / Linux：

curl -fsSL https://raw.githubusercontent.com/DingTalk-Real-AI/dingtalk-workspace-cli/main/scripts/install.sh | sh

Windows（PowerShell）：

irm https://raw.githubusercontent.com/DingTalk-Real-AI/dingtalk-workspace-cli/main/scripts/install.ps1 | iex

国内用户加速：添加 DWS_GITEE_REPO=DingTalk-Real-AI/dingtalk-workspace-cli 前缀即可走 Gitee 镜像。

其他方式：

• npm 全局安装：npm install -g dingtalk-workspace-cli（国内用 –registry=https://registry.npmmirror.com）
• 从 Releases 下载预编译二进制
• 源码构建：Go 1.25+，go build -o dws ./cmd

Skill 安装（Agent 必备）：

curl -fsSL https://raw.githubusercontent.com/DingTalk-Real-AI/dingtalk-workspace-cli/main/scripts/install-skills.sh | sh

或使用 dws skill setup 交互式配置 mono/multi 模式和目标 Agent（Claude、Cursor 等）。

登录授权：

dws auth login          # 浏览器自动授权
dws auth login --device # 无头环境（如 Docker、CI）

企业管理员可在开发者平台开启 CLI 访问权限。自建应用模式支持 –client-id 和 –client-secret。

多组织管理：dws profile list/switch 轻松切换，默认操作当前 profile。

实际使用场景推荐

• 日常办公：快速搜索文档、创建待办、管理日程，效率翻倍。
• AI Agent 开发：结合 Skills，让大模型直接操作钉钉，实现自动化流程（如自动汇总会议纪要、同步任务）。
• 企业集成：CI/CD 流水线、ISV 开发中无缝调用钉钉能力。
• 批量操作：搭配 –jq 精确提取数据，脚本化处理海量信息。

注意事项：

• 首次使用需组织管理员开启权限。
• 写操作请确认当前 profile，避免跨组织误操作。
• macOS 用户若遇 Gatekeeper 提示，执行 xattr -d com.apple.quarantine /path/to/dws。

总结：dws 是钉钉生态的“命令行升级包”

DingTalk Workspace CLI 不仅降低了钉钉 API 的使用门槛，更前瞻性地拥抱了 AI Agent 时代。它安全、强大、易扩展，是开发者、管理员和 AI 玩家的必备工具。