dingtalk-workspace-cli

环境要求

• 支持 Windows / macOS / Linux（Alpine 等 musl 发行版不受支持）
• 钉钉组织管理员已为该组织开通 CLI 访问权限
• npm 方式安装需已安装 Node.js（含 npm/npx）
• 从源码构建需 Go 1.25+ 及可用的 C 编译器（默认 CGO 构建）

安装与启动步骤

1. 1macOS/Linux 安装

   用官方脚本一键下载安装 dws 二进制；脚本自动识别平台，Alpine 等 musl 发行版会被检测并中止安装。

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

   复制

2. 2Windows 安装

   在 PowerShell 中执行官方安装脚本，同样会安装 dws 命令与对应的 Agent skill 布局。

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

   复制

3. 3备选安装方式

   也可用 npm 全局安装或 Homebrew 安装；Homebrew 首次 tap 必须带上仓库完整 URL。

   npm install -g dingtalk-workspace-cli

   复制

4. 4登录授权

   执行后会自动打开浏览器，选择组织并授权；无头环境（Docker、SSH、CI）改用 --device 模式登录。

   dws auth login

   复制

5. 5自定义应用登录

   若为 CI/CD 或 ISV 集成场景，先在钉钉开放平台建应用并配置回调地址，再用自有凭证登录，凭证首次登录后安全持久化。

   dws auth login --client-id  --client-secret 

   复制

6. 6多组织管理

   一个 CLI 可同时登录多个钉钉账号，用 profile 命令查看和切换当前身份，自动化请使用 profile list 返回的稳定值。

   dws profile list

   复制

7. 7源码构建

   需要 Go 1.25+ 和 C 编译器；静态端点数据已提交在仓库内，无需额外拉取数据仓库。

   git clone https://github.com/DingTalk-Real-AI/dingtalk-workspace-cli.git
   cd dingtalk-workspace-cli
   go build -o dws ./cmd

   复制

关键配置

如何确认成功

执行 dws profile list 能看到已登录账号，或运行 dws version 正常输出版本号，即表示安装与授权成功。

常见问题

注意事项

• 项目处于共建阶段，访问钉钉企业数据需要企业管理员授权。
• Linux 二进制依赖 glibc 2.17 基线，Alpine 等 musl 发行版不支持。
• 默认安装 multi（按产品拆分）skill 布局，跨产品工作流可改用 mono。
• 多组织自动化场景请使用 profile list 返回的稳定 profile 值，友好名称仅作为输入别名。