
dingtalk-workspace-cli
在终端一条命令驱动钉钉,让脚本和 AI 自动干活
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-10-08 · 当前星标 ★ 4148
使用教程
环境要求
- 支持 Windows / macOS / Linux(Alpine 等 musl 发行版不受支持)
- 钉钉组织管理员已为该组织开通 CLI 访问权限
- npm 方式安装需已安装 Node.js(含 npm/npx)
- 从源码构建需 Go 1.25+ 及可用的 C 编译器(默认 CGO 构建)
安装与启动步骤
-
1macOS/Linux 安装
用官方脚本一键下载安装 dws 二进制;脚本自动识别平台,Alpine 等 musl 发行版会被检测并中止安装。
curl -fsSL https://raw.githubusercontent.com/DingTalk-Real-AI/dingtalk-workspace-cli/main/scripts/install.sh | sh -
2Windows 安装
在 PowerShell 中执行官方安装脚本,同样会安装 dws 命令与对应的 Agent skill 布局。
irm https://raw.githubusercontent.com/DingTalk-Real-AI/dingtalk-workspace-cli/main/scripts/install.ps1 | iex -
3备选安装方式
也可用 npm 全局安装或 Homebrew 安装;Homebrew 首次 tap 必须带上仓库完整 URL。
npm install -g dingtalk-workspace-cli -
4登录授权
执行后会自动打开浏览器,选择组织并授权;无头环境(Docker、SSH、CI)改用 --device 模式登录。
dws auth login -
5自定义应用登录
若为 CI/CD 或 ISV 集成场景,先在钉钉开放平台建应用并配置回调地址,再用自有凭证登录,凭证首次登录后安全持久化。
dws auth login --client-id <your-app-key> --client-secret <your-app-secret> -
6多组织管理
一个 CLI 可同时登录多个钉钉账号,用 profile 命令查看和切换当前身份,自动化请使用 profile list 返回的稳定值。
dws profile list -
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_SKILL_MODE | 否 | 安装时选择 skill 布局,multi 为默认,mono 为旧的单入口模式 | mono |
--client-id / --client-secret | 否 | 自定义应用模式登录所需的钉钉应用 Key 与 Secret | --client-id <your-app-key> --client-secret <your-app-secret> |
如何确认成功
执行 dws profile list 能看到已登录账号,或运行 dws version 正常输出版本号,即表示安装与授权成功。
常见问题
Q:组织没有开通 CLI 访问权限怎么办?
A:选择组织后点击 Apply Now 向管理员发送申请,管理员收到请求卡片一键批准后,重新执行 dws auth login 即可。
Q:Docker、SSH、CI 等无浏览器环境如何登录?
A:使用设备码模式:dws auth login --device。
Q:macOS 提示无法验证开发者怎么办?
A:执行 xattr -d com.apple.quarantine /path/to/dws 去掉隔离属性后再运行。
Q:Alpine 上安装脚本为什么不继续?
A:Linux 二进制基于 glibc 2.17 构建,musl 发行版不受支持,安装器会检测到并主动停止。
Q:如何从 multi 切换回 mono 模式?
A:执行 dws skill setup --mode mono(切回则用 --mode multi),确认列出的路径后交互式完成切换。
注意事项
- 项目处于共建阶段,访问钉钉企业数据需要企业管理员授权。
- Linux 二进制依赖 glibc 2.17 基线,Alpine 等 musl 发行版不支持。
- 默认安装 multi(按产品拆分)skill 布局,跨产品工作流可改用 mono。
- 多组织自动化场景请使用 profile list 返回的稳定 profile 值,友好名称仅作为输入别名。
核心亮点
- 钉钉官方开源,接口与产品线对齐,可信度和维护有保障
- Go 单二进制跨平台,安装部署简单,适合塞进 CI 和容器
- 专为 AI Agent 设计,命令行即工具接口,方便智能体直接调用
不足之处
- 强绑定钉钉生态,非钉钉用户无法复用
- CLI 交互对不熟悉命令行的业务人员仍有学习门槛
适用场景
- CI/CD 流水线构建失败时自动发钉钉群通知
- 运维脚本批量拉取通讯录、日程或审批数据
- AI Agent 通过 CLI 调用钉钉完成发消息、建日程等任务
替代项目
lark-cli、feishu-openapi-cli
上一篇:todo-for-ai
同类项目推荐
gawkbot
开源
让 AI 替你干杂活,还给你生成管理小应用
open source grok bot. gawk bots automate your menial work via AI models and build yo···
playwright-mcp
开源
让 AI 直接操作浏览器,点按填表一步到位
Playwright MCP server
design-studio
开源
拖拽画布搭 AI 对话,无代码上线自动化流程
Tiledesk's open-source visual, no-code designer where LLM/GPT AI meets a flexible 'g···
kane-cli
开源
用大白话写测试,AI 自动跑浏览器验证
Kane CLI by TestMu AI (Formerly LambdaTest)
OmniSpace
开源
本地跑大模型,一站式搞定对话、漫画、写作与学习
本地优先的全栈 AI 创作工作站:AI对话 · AI漫画 · 漫剧创作 · 写作台 · 知识学习五大···
YourDesk
开源
跨平台远程桌面,还能让 AI 代理直接操控电脑
Cross-platform remote desktop for macOS and Windows with hardware acceleration, mult···
dsh-game-studio
开源
一句话生成小游戏,侧边栏试玩,一键上线
Describe a small game in one sentence, play it in the DeepSeek Harness sidebar, swap···
YandexStation
开源
把 Yandex 音箱接入 Home Assistant,实现语音和自动化控制
Управление Яндекс.Станцией и другими устройст···
steel-cookbook
开源
照着示例抄,几分钟跑通浏览器自动化
Examples and guides for using the Steel API