dingtalk-workspace-cli

在终端一条命令驱动钉钉,让脚本和 AI 自动干活

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 自动化工作流 🍴 复刻 287 🐛 待处理 239 👀 关注 21
GitHub ↗
GitHub 星标 ★ 4148
维护状态 活跃
是否开源 开源
定价模式 🏷️完全免费 开源免费,需自行部署使用

项目预览

dingtalk-workspace-cli 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类自动化工作流
开发团队DingTalk-Real-AI
定价模式🏷️完全免费
价格说明开源免费,需自行部署使用
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议Apache-2.0
主要语言Go
GitHub 星标★ 4148
上线时间2026-03-21 00:00:00
代码更新2026-11-20
仓库体积240.1 MB
本站数据更新2026-11-22
维护状态活跃
收录时间2026-10-08
浏览次数6

项目介绍

dingtalk-workspace-cli 是钉钉官方开源的跨平台命令行工具,用 Go 编写,把钉钉的全套产品能力统一封装进一个 CLI 包里。它解决的核心问题是:过去开发者或运维要调用钉钉的群机器人、消息、日程、通讯录、审批、文档等能力,往往得写代码调 API 或依赖图形界面,难以批量化、脚本化和自动化。这个工具把这些操作变成一条条命令,既方便人类在终端里直接使用,也专门为 AI Agent 场景设计——让智能体可以通过标准命令行接口驱动钉钉完成实际工作。核心能力包括跨平台运行(Windows/macOS/Linux)、统一入口覆盖钉钉多产品线、可脚本化编排、以及面向 Agent 的结构化调用方式。对于做企业自动化、CI/CD 通知、批量运维和 AI 工作流的团队,它把钉钉从一个人工操作的应用变成了可编程的基础设施。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-10-08 · 当前星标 ★ 4148

使用教程

难度:入门 约 10 分钟 部署方式:命令行工具 7 步

环境要求

  • 支持 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 <your-app-key> --client-secret <your-app-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_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

下一篇:ai-research-skills

同类项目推荐

gawkbot 开源

让 AI 替你干杂活,还给你生成管理小应用

open source grok bot. gawk bots automate your menial work via AI models and build yo···

★ 1586 2026-09-14
playwright-mcp 开源

让 AI 直接操作浏览器,点按填表一步到位

Playwright MCP server

★ 39957 2026-11-19
design-studio 开源

拖拽画布搭 AI 对话,无代码上线自动化流程

Tiledesk's open-source visual, no-code designer where LLM/GPT AI meets a flexible 'g···

★ 473 2026-10-08
kane-cli 开源

用大白话写测试,AI 自动跑浏览器验证

Kane CLI by TestMu AI (Formerly LambdaTest)

★ 267 2026-08-09
OmniSpace 开源

本地跑大模型,一站式搞定对话、漫画、写作与学习

本地优先的全栈 AI 创作工作站:AI对话 · AI漫画 · 漫剧创作 · 写作台 · 知识学习五大···

★ 536 2026-09-24
YourDesk 开源

跨平台远程桌面,还能让 AI 代理直接操控电脑

Cross-platform remote desktop for macOS and Windows with hardware acceleration, mult···

★ 271 2026-10-07
dsh-game-studio 开源

一句话生成小游戏,侧边栏试玩,一键上线

Describe a small game in one sentence, play it in the DeepSeek Harness sidebar, swap···

★ 750 2026-11-12
YandexStation 开源

把 Yandex 音箱接入 Home Assistant,实现语音和自动化控制

Управление Яндекс.Станцией и другими устройст···

★ 2021 2026-08-09
steel-cookbook 开源

照着示例抄,几分钟跑通浏览器自动化

Examples and guides for using the Steel API

★ 116 2026-09-15