今天刷 GitHub 的时候，发现钉钉官方刚开源了一个叫 dingtalk-workspace-cli（简称 dws）的命令行工具。看 star 数量，已经 593 了，而且更新时间显示 “6 hours ago”，说明这项目现在正是活跃的时候。

作为一个天天和命令行打交道的人，忍不住研究了一下。这玩意儿有点意思——它不只是给程序员用的，AI Agent 也能直接拿来干活。

一个 CLI 搞定钉钉全家桶

先说说 dws 能干嘛。

简单来说，你在钉钉工作台能操作的功能，它几乎都能通过命令行完成：

• 通讯录：搜索用户、查看部门

• 群聊：管理群成员、发机器人消息

• 智能表格：操作 AITable

• 日历：查日程、会议室、闲忙状态

• 待办：创建和管理待办任务

• 审批：处理审批流程

• 考勤：打卡记录、排班查询

• DING 消息：发送和撤回 DING

• 日志：查看和统计日志

还在陆续推出文档、邮箱、钉盘、视频会议、Teambition 等功能。

怎么安装

安装方式很简单，一行命令搞定：

macOS / Linux：

Windows (PowerShell)：

安装脚本会自动检测你的操作系统和架构，从 GitHub Releases 下载预编译的二进制文件。不用装 Go、Node.js 这些依赖，直接就能用。

装好之后，记得把 ~/.local/bin 加到 PATH 里。

怎么用

先要完成认证：

或者直接设环境变量：

认证完成后，就可以开始操作了。来看几个例子：

搜索联系人：

列出日历事件：

创建待办：

它还有个很贴心的功能：–dry-run，可以预览要执行的请求但不真正调用 API，避免手抖操作失误。

输出格式：人类和 AI 都能看懂

dws 支持三种输出格式：

• 表格（默认）：适合人看

• JSON：适合 AI 处理和管道操作

• 原始 API 响应：调试用

这就很爽了。你写个脚本，用 JSON 格式解析结果，随你怎么折腾。

AI Agent 的杀手锏

最让我觉得有意思的，是它内置了 Agent Skills。

安装脚本会把 skills 安装到 ~/.agents/skills/dws。主流的 AI Agent（比如 Claude Code、Cursor、Windsurf）都能自动发现这个目录里的技能。

也就是说，你的 AI Agent 不需要自己写钉钉 API 的调用工具，直接调用 dws 就能操作钉钉了。这对于做自动化工作流的人来说，简直是生产力神器。

现在的限制

需要注意，这是共创阶段。

项目涉及企业数据访问，需要企业管理员授权。目前是灰度共创，需要加入钉钉 DWS 共创群，提交应用 Client ID 和企业管理员授权凭证，才能开通白名单。不过官方说后续会支持企业管理员自助审批。

我的想法

总的来说，dws 这个工具定位很清晰：

1. 对开发者：告别手写 API 调用，一个命令行搞定钉钉各种功能

2. 对 AI Agent：结构化 JSON 输出 + 内置 Skills，让 AI 能直接操作钉钉

钉钉这波开源，至少方向是对的。之前很多企业工具都是封闭的，现在官方自己开放 CLI，多少能让生态活跃起来。至于能不能火，得看后续功能和授权流程跟进速度了。

感兴趣的朋友可以直接去 GitHub 看看。

好了，今天的分享就到此结束，咱们下回见；

如果觉得文章对你有帮助，记得 点.赞.转.发.收.藏 喔！