钉钉官方开源CLI：用一个dws把企业协作变成AI可编程工作台

钉钉官方开源了一款命令行工具，核心思路直指当下企业数字化的一个痛点：协作能力分散在无数个页面和子系统里，人要在它们之间反复横跳。这款名为「钉钉工作台命令行」（dws）的工具，用一个统一入口把这些分散的能力串了起来，更关键的是，它从设计之初就为 AI Agent 做了适配，让智能体能够直接操作真实的企业业务。

一个 dws 入口，统一分散的协作能力

过去要完成一个跨场景的协作任务，往往需要打开多个页面、在不同系统之间切换。dws 的做法是把这些能力收敛到一条命令行入口下，通过清晰的层级结构组织功能，帮助信息本身就是使用说明——这对习惯命令行的开发者来说几乎没有学习成本。

覆盖范围从日常协作起步：联系人、聊天、日历都能直接调用；再往上接入待办、审批、考勤；文档、云盘、表格也纳入同一入口；白板、邮件、知识库继续补齐；甚至会议纪要都能作为工作流的起点。可以说，钉钉里高频使用的协作模块基本都被命令行化了。

帮助信息就是使用说明

这种统一入口的价值在于，它把原本割裂的操作体验收敛成了一套可组合、可脚本化的指令集。对一个团队而言，这意味着重复性的「搬运」工作可以被自动化掉。

为 AI Agent 而生的设计细节

dws 真正区别于普通 CLI 工具的地方，在于它对 AI Agent 的友好程度。它默认返回结构化 JSON，并且可以配合 jq 精确提取字段，这让 Agent 处理返回结果时不需要做复杂的文本解析。

工具内置了一系列技能，让 Agent 开箱即用；同时支持字段投影和 Mock 功能，用来减少无效的上下文消耗。这两点对实际落地很重要——大模型的上下文窗口和 token 成本都是现实约束，字段投影能只返回需要的信息，Mock 则能在不触发真实业务的情况下预演流程。

还支持字段投影和Mock

换个角度看，这套设计实际上是在为「Agent 操作企业系统」这件事建立一套规范接口。相比让 Agent 去模拟点击网页，直接调用结构化、带技能描述的命令行，稳定性和可控性都要高得多。

jq 是一款轻量级的命令行 JSON 处理工具，语法类似于管道操作符，可以对 JSON 数据做过滤、提取、转换等操作。例如 dws calendar list | jq '.items[].title' 可以直接从返回结果中提取所有日历事项的标题，而不需要额外写解析脚本。在 Agent 工作流中，这种能力尤为重要：大模型每次调用工具时，拿到的返回内容会占用上下文窗口，如果原始 JSON 包含大量无关字段，不仅浪费 token，还可能干扰模型的推理。字段投影（只返回指定字段）配合 jq 精准提取，实际上是在「信息入模型前」做了一次降噪，让 Agent 拿到的信息更干净、更聚焦。

安全与可控：企业落地的真正门槛

AI Agent 要碰企业真实业务数据，安全是绕不开的问题。dws 在这方面做了几层保护：登录采用 OAuth 设备流，访问边界由域名白名单控制，权限遵循最小化原则，并配合完整的审计日志。

更值得关注的是执行层面的两道闸门：执行前支持 Dry Run（空跑预览），关键动作则采用「先预演再提交」的机制。这意味着在一个由 Agent 驱动的工作流里，危险操作不会被直接执行，而是先给出预期结果供确认。对企业管理员来说，这套机制提供的是一个可控、可审计的 Agent 入口，而不是一个黑箱。

OAuth 设备流（Device Authorization Grant）是 OAuth 2.0 的一种授权模式，专为无浏览器或输入受限的设备（如命令行终端、智能电视）设计。用户在终端发起登录后，设备会生成一个短码和验证 URL，用户用另一台设备（通常是手机或电脑浏览器）访问该 URL 完成身份确认，终端随后轮询获取访问令牌。这种方式避免了在命令行中直接输入账号密码，也不需要在本地启动 HTTP 服务来接收回调，安全性和易用性在 CLI 场景下达到较好的平衡。对 AI Agent 的自动化调用而言，一旦完成首次授权，后续操作可以使用刷新令牌维持会话，无需反复人工介入。

真实工作流：从读取到执行的完整闭环

工具的能力只有串成流程才有意义。原视频给出了两个典型的工作流示例：

一是从会议纪要中提取待办事项，自动创建任务并通知到群聊；二是先搜索相关记录文档，生成摘要后写入智能表格，最后把结果同步到项目群。

再创建任务并通知群聊

这两个例子的共同点是形成了「读取 → 处理 → 执行 → 同步」的完整闭环。Agent 不再只是回答问题，而是真正地在企业系统里完成一连串动作。这正是当前 Agent 产品化最需要补齐的一环——从「能说」走向「能做」。

谁适合用，以及如何上手

按照介绍，dws 特别适合三类人：开发者可以少写重复的接口对接代码；运营可以把快应用的操作步骤自动化；企业管理员则获得一个可控的统一入口。每一类角色的收益都很明确，共同指向同一个结果——少做搬运，多做判断。

安装方式也比较直接，支持脚本和 NPM 安装，也支持 Homebrew，三大主流操作系统都能运行。装好后先完成登录授权，再从一条命令开始体验。

安装也很直接

小结

dws 的意义不只在于「钉钉又开源了一个工具」，而在于它提供了一种让 AI Agent 接入真实企业业务的务实范式：统一入口降低复杂度，结构化输出和内置技能降低 Agent 接入成本，OAuth、白名单、最小权限和 Dry Run 则守住了安全底线。对于正在探索 Agent 落地的团队来说，把钉钉变成一个可编程工作台，这个方向值得认真试一遍。