🤖 钉钉CLI (dws) 详解
<div class="info">
<strong>📋 摘要</strong><br><br>
钉钉官方在 2026 年初开源了 <strong>DingTalk Workspace CLI（简称 dws）</strong>，这是一个专为 AI Agent 和开发者设计的命令行工具，将钉钉所有开放平台能力统一封装为 104 个原子命令。本文详细介绍其安装、架构、与 OpenClaw 的关系，以及项目管理相关接口的使用方法。
</div>
<h2>一、两个钉钉CLI：别再搞混了</h2>
<div class="section">
<p>钉钉实际上有<strong>两个不同的 CLI 工具</strong>，功能定位完全不同：</p>
</div>
<table>
<tr>
<th>工具</th>
<th>定位</th>
<th>仓库</th>
<th>用途</th>
</tr>
<tr>
<td><strong>DingTalk Design CLI</strong></td>
<td>前端研发工具</td>
<td>open-dingtalk/dingtalk-design-cli</td>
<td>小程序/H5微应用/工作台组件的初始化、调试、上传</td>
</tr>
<tr>
<td><strong>DingTalk Workspace CLI (dws)</strong></td>
<td>企业能力CLI</td>
<td>DingTalk-Real-AI/dingtalk-workspace-cli</td>
<td>通讯录、日历、待办、审批、考勤、智能表格等企业级 API</td>
</tr>
</table>
<div class="warning">
<strong>⚠️ 本文聚焦的是 dws</strong> — 它才是面向 AI Agent 和企业自动化的 CLI 工具，也是我们与 OpenClaw 集成的核心工具。Design CLI 是给小程序前端开发者用的，不在本系列讨论范围内。
</div>
<h2>二、dws 是什么？</h2>
<div class="section">
<p><strong>DingTalk Workspace CLI (dws)</strong> 是钉钉官方团队（DingTalk-Real-AI）在 2026 年初开源的跨平台命令行工具，用 Go 语言编写，约 8MB 单二进制文件，Apache-2.0 协议。</p>
<p>它的核心设计理念是：<strong>把钉钉开放平台的所有能力，用一行命令暴露给人类和 AI Agent</strong>。</p>
<div class="feature-grid">
<div class="feature-card">
<strong>✅ 104 个工具</strong><br>
覆盖 12 个产品线，全部通过命令行调用
</div>
<div class="feature-card">
<strong>✅ 结构化 JSON</strong><br>
所有输出均为结构化 JSON，AI Agent 可直接解析
</div>
<div class="feature-card">
<strong>✅ 内置 Agent Skills</strong><br>
安装后 AI 工具可自然语言驱动钉钉
</div>
<div class="feature-card">
<strong>✅ 零信任安全</strong><br>
OAuth 设备流 + 域名白名单 + 权限最小化
</div>
</div>
</div>
<h2>三、安装 dws</h2>
<h3>3.1 macOS / Linux 一键安装</h3>
<pre><code>curl -fsSL https://raw.githubusercontent.com/DingTalk-Real-AI/dingtalk-workspace-cli/main/scripts/install.sh | sh</code></pre>
<h3>3.2 Windows (PowerShell)</h3>
<pre><code>irm https://raw.githubusercontent.com/DingTalk-Real-AI/dingtalk-workspace-cli/main/scripts/install.ps1 | iex</code></pre>
<h3>3.3 其他方式</h3>
<pre><code># 方式1：直接下载预编译二进制（GitHub Releases）
访问: https://github.com/DingTalk-Real-AI/dingtalk-workspace-cli/releases
下载对应平台的 dws 二进制文件，添加到 PATH
方式2：从源码构建（需要 Go 1.25+）
git clone https://github.com/DingTalk-Real-AI/dingtalk-workspace-cli.git
cd dingtalk-workspace-cli
go build -o dws ./cmd
cp dws ~/.local/bin/ # 或添加到 PATH
方式3：npm 安装（Node.js 环境）
npm install -g dingtalk-workspace-cli
<h3>3.4 验证安装</h3>
<pre><code>dws --version # 查看版本
dws --help # 查看帮助
<h2>四、创建钉钉应用（认证配置）</h2>
<div class="warning">
<strong>⚠️ 共创阶段</strong>：目前 dws 处于灰度共创阶段，需要企业管理员授权才能使用。请先加入 DWS 共创群完成白名单配置。
</div>
<h3>Step 1：创建企业内部应用</h3>
<p>前往 <a href="https://open-dev.dingtalk.com/fe/app?hash=%23%2Fcorp%2Fapp#/corp/app">钉钉开放平台控制台</a>，在「内部企业应用 - 钉钉应用」下点击「创建应用」。</p>
<h3>Step 2：配置安全设置</h3>
<p>在应用设置 → 安全设置中，添加以下重定向 URL：</p>
<pre><code>http://127.0.0.1
https://login.dingtalk.com
<p><code>http://127.0.0.1</code> 用于本地浏览器登录；<code>https://login.dingtalk.com</code> 用于 <code>--device</code> 设备流登录（Docker 容器、远程服务器等无浏览器环境）。</p>
<h3>Step 3：发布应用</h3>
<p>点击「应用发布 - 版本管理与发布」将应用发布上线。</p>
<h3>Step 4：加入共创群并配置白名单</h3>
<p>加入钉钉 DWS 共创群，提供 Client ID 和管理员确认，完成白名单配置。</p>
<h3>Step 5：登录认证</h3>
<pre><code># 方式1：交互式登录
dws auth login
方式2：使用 Client ID/Secret（推荐 AI Agent 使用）
export DWS_CLIENT_ID=your-app-key
export DWS_CLIENT_SECRET=your-app-secret
dws auth login
<h2>五、dws 能力全景图（104 个工具）</h2>
<table>
<tr>
<th>产品</th>
<th>服务名</th>
<th>工具数</th>
<th>核心功能</th>
</tr>
<tr>
<td>通讯录</td>
<td><code>contact</code></td>
<td>8</td>
<td>用户搜索、部门查询、当前用户信息</td>
</tr>
<tr>
<td>消息</td>
<td><code>chat</code></td>
<td>14</td>
<td>群 CRUD、成员管理、消息历史、发消息</td>
</tr>
<tr>
<td>机器人</td>
<td><code>chat bot</code></td>
<td>9</td>
<td>机器人创建、群/单聊消息、webhook、消息撤回</td>
</tr>
<tr>
<td>日历</td>
<td><code>calendar</code></td>
<td>13</td>
<td>日程 CRUD、会议预订空闲时段、参会人管理</td>
</tr>
<tr>
<td>待办</td>
<td><code>todo</code></td>
<td>6</td>
<td>任务创建、列表、更新、完成、详情、删除</td>
</tr>
<tr>
<td>审批</td>
<td><code>oa</code></td>
<td>9</td>
<td>审批通过/拒绝/撤销、待处理任务、实例查询</td>
</tr>
<tr>
<td>考勤</td>
<td><code>attendance</code></td>
<td>4</td>
<td>打卡记录、排班、考勤统计、班组规则</td>
</tr>
<tr>
<td>DING</td>
<td><code>ding</code></td>
<td>3</td>
<td>DING 消息发送、撤回</td>
</tr>
<tr>
<td>日志</td>
<td><code>report</code></td>
<td>7</td>
<td>日志创建、列表、详情、模版、统计、已发已收</td>
</tr>
<tr>
<td>智能表格</td>
<td><code>aitable</code></td>
<td>27</td>
<td>库/表/记录/字段全 CRUD、视图、导入导出</td>
</tr>
<tr>
<td>工作台</td>
<td><code>workbench</code></td>
<td>2</td>
<td>批量查询应用详情</td>
</tr>
<tr>
<td>开发文档</td>
<td><code>devdoc</code></td>
<td>2</td>
<td>平台文档搜索、错误码查询</td>
</tr>
</table>
<div class="info">
<strong>即将支持</strong>：<code>doc</code>（文档）· <code>mail</code>（邮箱）· <code>minutes</code>（AI 听记）· <code>drive</code>（钉盘）· <code>conference</code>（视频会议）· <code>tb</code>（Teambition）· <code>aiapp</code>（AI 应用）· <code>live</code>（直播）· <code>skill</code>（技能市场）
</div>
<h2>六、核心命令详解</h2>
<h3>6.1 帮助与发现</h3>
<pre><code># 查看所有可用产品
dws --help
查看某个产品的所有工具
dws calendar --help
查看某个工具的参数 schema（AI Agent 必读）
dws schema
dws schema aitable.query_records
dws schema todo.task_create --jq '.tool.required'
预览操作（不执行）
dws todo task list --dry-run
<h3>6.2 输出格式控制</h3>
<pre><code># 表格格式（默认，适合人类阅读）
dws contact user search --keyword "Alice" -f table
JSON 格式（适合 AI Agent 解析）
dws contact user search --keyword "Alice" -f json
原始 API 响应（调试用）
dws contact user search --keyword "Alice" -f raw
jq 精确提取字段
dws contact user get-self --jq '.result[0].orgEmployeeModel | {name: .orgUserName, dept: .depts[0].deptName, userId}'
保存到文件
dws contact user search --keyword "Alice" -o result.json
<h3>6.3 通讯录操作</h3>
<pre><code># 搜索用户
dws contact user search --keyword "张三"
搜索部门
dws contact dept search --keyword "研发部"
获取部门成员
dws contact dept members --dept-id 123456
获取当前用户信息
dws contact user get-self
<h3>6.4 消息发送</h3>
<pre><code># 发送群消息（通过机器人）
dws chat message send-by-bot \
--robot-code "dingxxxxxxxxxx" \
--group "群ID" \
--title "项目通知" \
--text "工业网关V2.0 已发布新版本"
发送工作通知（给个人）
dws chat message send \
--user-id "用户ID" \
--msg-type "text" \
--content "任务已分配，请查收"
撤回消息
dws chat message recall --msg-id "消息ID"
<h3>6.5 日历管理</h3>
<pre><code># 列出日历事件
dws calendar event list
创建日程
dws calendar event create \
--title "项目周会" \
--start "2026-03-30T10:00:00+08:00" \
--end "2026-03-30T11:00:00+08:00" \
--attendees "userId1,userId2"
查询空闲会议室
dws calendar room search \
--start "2026-03-30T09:00:00+08:00" \
--end "2026-03-30T10:00:00+08:00" \
--group-id "群ID"
更新日程
dws calendar event update \
--id "事件ID" \
--title "项目周会V2" \
--start "2026-03-30T10:00:00+08:00" \
--end "2026-03-30T11:30:00+08:00"
<h2>七、项目管理相关接口（重点）</h2>
<p>这是我们最关心的部分。dws 中与项目管理直接相关的模块有：</p>
<h3>7.1 待办任务（todo）— 项目管理核心</h3>
<pre><code># 查看任务列表
dws todo task list
创建任务（关键！）
dws todo task create \
--title "完成固件V1.2.0开发" \
--executors "userId1,userId2" \
--participant-ids "userId3" \
--due-time "2026-04-15T00:00:00+08:00" \
--priority 1 \
--yes
更新任务
dws todo task update \
--id "任务ID" \
--title "固件V1.2.0已发布" \
--status "done"
完成任务
dws todo task done --id "任务ID"
查看任务详情
dws todo task get --id "任务ID"
删除任务
dws todo task delete --id "任务ID"
<div class="info">
<strong>待办任务参数说明</strong>：
<ul>
<li><code>--title</code>：任务标题，最大长度 1024 字符</li>
<li><code>--executors</code>：执行人的 unionId，支持多人</li>
<li><code>--participant-ids</code>：参与人的 unionId</li>
<li><code>--due-time</code>：截止时间，ISO 8601 格式</li>
<li><code>--priority</code>：优先级（0=普通, 1=重要, 2=紧急）</li>
<li><code>--yes</code>：跳过确认提示（AI Agent 必须加）</li>
</ul>
</div>
<h3>7.2 审批（oa）— 流程管理</h3>
<pre><code># 查询待审批列表
dws oa approval list --status pending
审批通过
dws oa approval approve \
--process-instance-id "流程实例ID" \
--approve-text "同意" \
--action "agree"
审批拒绝
dws oa approval reject \
--process-instance-id "流程实例ID" \
--reject-text "材料不全，请补充" \
--action "refuse"
发起审批实例
dws oa approval create \
--process-code "PROC-XXXXX" \
--form "表单JSON"
查询我发起的审批
dws oa approval list --type initiator
<h3>7.3 日志（report）— 项目汇报</h3>
<pre><code># 查看收到的日志
dws report inbox today
查看发出的日志
dws report sent list
创建日志
dws report create \
--template-id "模版ID" \
--content "今日工作：1.完成串口驱动；2.修复bug#23"
查看日志统计
dws report stats --user-id "userId"
<h3>7.4 日历（calendar）— 项目协调</h3>
<pre><code># 查找共同空闲时间（安排会议）
dws calendar free-slot find \
--users "userId1,userId2,userId3" \
--duration 60
推荐最佳会议时间
dws calendar schedule meeting \
--users "userId1,userId2" \
--title "项目评审会" \
--duration 90
查询今天/本周日程
dws calendar today agenda
dws calendar week agenda
<h3>7.5 智能表格（aitable）— 项目数据管理</h3>
<pre><code># 列出所有库
dws aitable base list
创建新库
dws aitable base create --name "工业网关项目"
创建数据表
dws aitable table create --base-id "库ID" --name "Bug跟踪"
查询记录
dws aitable record query \
--base-id "库ID" \
--table-id "表ID" \
--limit 50
新增记录
dws aitable record create \
--base-id "库ID" \
--table-id "表ID" \
--fields '[{"Bug名称":"串口丢包"},{"优先级":"高"},{"状态":"进行中"}]'
批量导入
python3 scripts/import_records.py --file bugs.csv
<h3>7.6 群管理（chat）— 团队协作</h3>
<pre><code># 创建群
dws chat group create \
--name "工业网关开发组" \
--owner "群主userId" \
--members "userId1,userId2,userId3"
添加群成员
dws chat group members add \
--id "群ID" \
--users "userId4,userId5"
移除群成员
dws chat group members remove \
--id "群ID" \
--users "userId4"
发送群消息
dws chat message send-by-bot \
--robot-code "机器人code" \
--group "群ID" \
--title "📢 版本发布" \
--text "工业网关V2.0 正式版发布，变更：..."
<h2>八、与 OpenClaw 的关系</h2>
<h3>8.1 两个组件的分工</h3>
<table>
<tr>
<th>组件</th>
<th>定位</th>
<th>运行位置</th>
<th>接口类型</th>
</tr>
<tr>
<td><strong>OpenClaw DingTalk 插件</strong><br>(@soimy/dingtalk)</td>
<td>消息通道</td>
<td>OpenClaw Gateway 服务器</td>
<td>接收/发送钉钉消息（Stream 模式）</td>
</tr>
<tr>
<td><strong>dws</strong><br>(dingtalk-workspace-cli)</td>
<td>企业能力 CLI</td>
<td>任意位置（通常也是 Gateway 服务器）</td>
<td>调用钉钉开放平台所有 API</td>
</tr>
</table>
<div class="info">
<strong>关系说明</strong>：OpenClaw DingTalk 插件和 dws 是<strong>互补关系</strong>，各自解决不同层面的问题：
<ul>
<li><strong>OpenClaw 插件</strong>：负责钉钉消息的实时接收和发送，是 AI 对话的入口</li>
<li><strong>dws</strong>：负责操作钉钉后台的企业资源（任务、日历、审批等），是自动化执行的引擎</li>
</ul>
</div>
<h3>8.2 安装情况</h3>
<p>当前 <code>@soimy/dingtalk</code> OpenClaw 插件已安装在 Gateway 服务器上（位于 <code>~/.openclaw/extensions/dingtalk/</code>），这是消息通道的 CI 部分。dws 需要单独安装，它是命令行工具，不属于 OpenClaw 插件体系。</p>
<pre><code># 查看 OpenClaw 插件安装情况
openclaw plugins list
查看 dws 安装情况
which dws
dws --version
<h3>8.3 OpenClaw Agent 如何调用 dws</h3>
<p>OpenClaw Agent 通过 <code>exec</code> 工具调用 dws 命令，实现方式是在 AGENTS.md 或 Skill 中定义调用指令：</p>
<pre><code># 在 Skill 中定义 dws 调用示例
// 创建钉钉任务
await exec({
command: dws todo task create \
--title "${taskTitle}" \
--executors "${executorId}" \
--due-time "${dueTime}" \
--priority 1 \
--yes
});
// 发送项目通知
await exec({
command: dws chat message send-by-bot \
--robot-code "${robotCode}" \
--group "${groupId}" \
--title "📢 项目更新" \
--text "${message}"
});
<h2>九、AI Agent Skills 安装（让 AI 自然语言驱动钉钉）</h2>
<pre><code># 全局安装（AI 工具自动发现）
curl -fsSL https://raw.githubusercontent.com/DingTalk-Real-AI/dingtalk-workspace-cli/main/scripts/install.sh | sh
当前项目安装
curl -fsSL https://raw.githubusercontent.com/DingTalk-Real-AI/dingtalk-workspace-cli/main/scripts/install-skills.sh | sh
<p>安装后，Claude Code、Cursor、Windsurf 等 AI 工具可以在 <code>~/.agents/skills/dws/</code> 目录下找到 Skill 定义文件，直接用自然语言操作钉钉。</p>
<pre><code># 验证 skills 安装
ls ~/.agents/skills/dws/
应该看到：SKILL.md, references/, scripts/
<h3>Skills 包含的内容</h3>
<table>
<tr>
<th>文件</th>
<th>说明</th>
</tr>
<tr>
<td><code>SKILL.md</code></td>
<td>主 Skill 文件：意图路由、决策树、安全规则、错误处理</td>
</tr>
<tr>
<td><code>references/products/*.md</code></td>
<td>各产品线命令参考（aitable、chat、calendar 等）</td>
</tr>
<tr>
<td><code>references/intent-guide.md</code></td>
<td>歧义场景的意图判断（如日志 vs 待办）</td>
</tr>
<tr>
<td><code>references/global-reference.md</code></td>
<td>认证、输出格式、全局参数</td>
</tr>
<tr>
<td><code>references/error-codes.md</code></td>
<td>错误码 + 调试工作流</td>
</tr>
<tr>
<td><code>scripts/*.py</code></td>
<td>13 个常用批量操作脚本</td>
</tr>
</table>
<h2>十、批量操作脚本（13个）</h2>
<p>dws 提供了 13 个 Python 脚本，覆盖常见批量操作场景：</p>
<table>
<tr>
<th>脚本</th>
<th>功能</th>
</tr>
<tr>
<td><code>calendar_schedule_meeting.py</code></td>
<td>创建日程 + 添加参会人 + 查找空闲会议室</td>
</tr>
<tr>
<td><code>calendar_free_slot_finder.py</code></td>
<td>查找多人共同空闲时段，推荐最佳会议时间</td>
</tr>
<tr>
<td><code>calendar_today_agenda.py</code></td>
<td>查看今天/明天/本周日程</td>
</tr>
<tr>
<td><code>import_records.py</code></td>
<td>从 CSV/JSON 批量导入记录到智能表格</td>
</tr>
<tr>
<td><code>bulk_add_fields.py</code></td>
<td>批量添加字段到智能表格</td>
</tr>
<tr>
<td><code>upload_attachment.py</code></td>
<td>上传附件到智能表格附件字段</td>
</tr>
<tr>
<td><code>todo_batch_create.py</code></td>
<td>从 JSON 批量创建待办（含优先级、截止日期、执行人）</td>
</tr>
<tr>
<td><code>todo_daily_summary.py</code></td>
<td>汇总今天/本周未完成任务</td>
</tr>
<tr>
<td><code>todo_overdue_check.py</code></td>
<td>扫描并输出逾期任务清单</td>
</tr>
<tr>
<td><code>contact_dept_members.py</code></td>
<td>按部门名搜索并列出所有成员</td>
</tr>
<tr>
<td><code>attendance_my_record.py</code></td>
<td>查看今日/本周/指定日期的考勤记录</td>
</tr>
<tr>
<td><code>attendance_team_shift.py</code></td>
<td>查询班组排班和考勤统计</td>
</tr>
<tr>
<td><code>report_inbox_today.py</code></td>
<td>查看今日收到的日志及详情</td>
</tr>
</table>
<pre><code># 使用示例：批量创建项目任务
python3 ~/.agents/skills/dws/scripts/todo_batch_create.py \
--file project_tasks.json
project_tasks.json 格式：
[
{"title": "完成固件开发", "executors": "userId1", "due": "2026-04-15", "priority": 1},
{"title": "编写测试文档", "executors": "userId2", "due": "2026-04-20", "priority": 2}
]
<h2>十一、错误码参考</h2>
<table>
<tr>
<th>错误码</th>
<th>类别</th>
<th>说明</th>
</tr>
<tr>
<td><code>0</code></td>
<td>成功</td>
<td>命令执行成功</td>
</tr>
<tr>
<td><code>1</code></td>
<td>API 错误</td>
<td>MCP 工具调用或上游 API 失败</td>
</tr>
<tr>
<td><code>2</code></td>
<td>认证错误</td>
<td>身份认证或授权失败</td>
</tr>
<tr>
<td><code>3</code></td>
<td>校验错误</td>
<td>输入参数校验失败（无效参数、schema 不匹配）</td>
</tr>
<tr>
<td><code>4</code></td>
<td>发现错误</td>
<td>服务发现失败（MCP 服务器连接问题）</td>
</tr>
<tr>
<td><code>5</code></td>
<td>内部错误</td>
<td>未预期的内部错误</td>
</tr>
</table>
<pre><code># JSON 格式错误响应示例
{
"code": 3,
"category": "Validation",
"reason": "invalid_parameter",
"hint": "due_time must be in ISO 8601 format",
"actions": ["Check --due-time format", "Use --dry-run to validate"]
}
<h2>十二、智能纠错（AI-Friendly 设计）</h2>
<div class="section">
<p>dws 内置了 <strong>Smart Input Correction</strong> 管道引擎，能自动纠正 AI 模型常见的参数错误：</p>
<ul>
<li><strong>命名风格转换</strong>：<code>--baseId</code> → <code>--base-id</code>（camelCase / snake_case / UPPER → kebab-case）</li>
<li><strong>粘附参数拆分</strong>：<code>--timeout30</code> → <code>--timeout 30</code></li>
<li><strong>拼写模糊匹配</strong>：<code>--tabel-id</code> → <code>--table-id</code></li>
<li><strong>值规范化</strong>：<code>"yes"</code> → <code>true</code>，<code>"1,000"</code> → <code>1000</code>，<code>"2024/03/29"</code> → <code>"2024-03-29"</code></li>
</ul>
</div>
<h2>十三、安全架构</h2>
<div class="section">
<p>dws 从架构层面将安全作为一等公民：</p>
<ul>
<li><strong>凭证不落盘</strong>：PBKDF2 + AES-256-GCM 加密存储，密钥绑定设备 MAC 地址</li>
<li><strong>Token 不出域</strong>：Bearer token 仅允许发送到白名单域名（默认 <code>*.dingtalk.com</code>）</li>
<li><strong>权限不越界</strong>：OAuth 最小权限范围，每次 API 调用都经过钉钉鉴权和审计</li>
<li><strong>路径安全</strong>：符号链接解析 + 工作目录约束，防止路径遍历攻击</li>
</ul>
</div>
<h2>十四、配置环境变量</h2>
<pre><code># 认证相关
export DWS_CLIENT_ID=your-app-key
export DWS_CLIENT_SECRET=your-app-secret
配置目录（可选）
export DWS_CONFIG_DIR=~/.config/dws
服务发现（可选，自定义 MCP 服务器）
export DWS_SERVERS_URL=https://your-mcp-server.com/registry
域名白名单（仅开发环境设为 *）
export DWS_TRUSTED_DOMAINS=*.dingtalk.com
允许 HTTP 回环地址（仅开发调试）
export DWS_ALLOW_HTTP_ENDPOINTS=1
<h2>十五、与 OpenClaw 多Agent的集成方案</h2>
<h3>15.1 Agent 团队架构</h3>
<div class="section">
<pre><code> ┌─────────────────┐
│ 张煜（钉钉） │
└────────┬────────┘
│
┌────────▼────────┐
│ Elaine (PM) │ ◀── 总指挥，理解需求，调度任务
│ 🌸 项目经理 │
└────────┬────────┘
│
┌────────────────────────┼────────────────────────┐
│ │ │
┌───▼──────┐ ┌─────▼─────┐ ┌────▼────┐
│ Sheldon │ │ Leonard │ │ Raj │
│ 🖥️ 开发 │ │ 🧪 测试 │ │ 📁 文档 │
│ 工程师 │ │ 工程师 │ │ 管理 │
└──────────┘ └───────────┘ └─────────┘
│
┌───────▼───────┐
│ Howard │
│ 🔧 运维 │
│ Agent │
└──────────────┘
<h3>15.2 各 Agent 职责与 dws 调用</h3>
<div class="agent-card">
<h4>🎯 Elaine（PM Agent）— 项目总管</h4>
<p>负责理解用户需求、拆解任务、分配给 Sheldon/Leonard/Raj、跟踪整体进度。当需要操作钉钉资源时，通过 exec 工具调用 dws。</p>
<pre><code># Elaine 创建项目任务
dws todo task create --title "工业网关V2.0 需求分析" --executors "userId_Elaine" --priority 1 --yes
Elaine 安排项目启动会
dws calendar event create --title "工业网关V2.0 项目启动会" --start "2026-04-01T09:00:00+08:00" --end "2026-04-01T10:00:00+08:00" --attendees "userId1,userId2"
<div class="agent-card">
<h4>💻 Sheldon（Dev Agent）— 开发工程师</h4>
<p>负责代码管理、技术方案、固件开发。定时向 Raj 请求文档支持，向 Howard 请求环境资源。</p>
<pre><code># Sheldon 查询分配给自己的任务
dws todo task list --executor "userId_Sheldon"
Sheldon 上报进度
dws report create --template-id "进度汇报" --content "固件V1.2.0 开发进度 80%，预计本周完成"
Sheldon 更新任务状态
dws todo task update --id "任务ID" --status "in_progress"
<div class="agent-card">
<h4>🧪 Leonard（QA Agent）— 测试工程师</h4>
<p>负责测试用例管理、测试执行、bug 跟踪、质量报告。</p>
<pre><code># Leonard 创建测试任务
dws todo task create --title "固件V1.2.0 集成测试" --executors "userId_Leonard" --due-time "2026-04-20T00:00:00+08:00" --priority 2 --yes
Leonard 记录测试bug
dws aitable record create --base-id "项目库ID" --table-id "Bug表ID" --fields '[{"Bug名称":"串口丢包"},{"优先级":"高"},{"状态":"待修复"}]'
Leonard 发送测试报告
dws chat message send-by-bot --robot-code "qa_bot" --group "项目群" --title "📊 测试报告" --text "固件V1.2.0 测试完成，缺陷率2.3%，通过"
<div class="agent-card">
<h4>📁 Raj（Docs Agent）— 文档管理</h4>
<p>负责文档索引、知识库维护、技术文档管理、版本控制。</p>
<pre><code># Raj 创建项目文档库
dws aitable base create --name "工业网关V2.0 项目文档"
Raj 上传技术文档记录
dws aitable record create --base-id "文档库ID" --table-id "文档表ID" --fields '[{"文档名称":"硬件设计规格书"},{"版本":"V1.2"},{"状态":"已审核"}]'
Raj 搜索相关文档
dws aitable record query --base-id "文档库ID" --table-id "文档表ID" --fields "文档名称,版本"
<div class="agent-card">
<h4>🔧 Howard（Ops Agent）— 运维工程师</h4>
<p>负责环境管理、CI/CD、服务器运维、发布管理、群通知。</p>
<pre><code># Howard 查询项目成员
dws contact dept members --dept-id "研发部ID"
Howard 发送版本发布通知
dws chat message send-by-bot --robot-code "ops_bot" --group "开发组群" --title "🚀 版本发布" --text "工业网关V2.0 固件V1.2.0 正式发布"
Howard 检查考勤
dws attendance team shift --dept-id "研发部ID"
Howard 逾期任务检查
python3 ~/.agents/skills/dws/scripts/todo_overdue_check.py
<h2>十六、总结</h2>
<div class="success">
<strong>✅ dws 核心价值</strong><br><br>
<strong>统一入口</strong>：104 个工具覆盖钉钉所有企业能力，一个 CLI 打天下<br><br>
<strong>AI 原生</strong>：结构化 JSON + Agent Skills + Smart Input Correction，AI 工具可自然语言驱动<br><br>
<strong>安全可靠</strong>：零信任架构，凭证不落盘、权限最小化、操作全审计<br><br>
<strong>与 OpenClaw 互补</strong>：插件管消息通道（对话），dws 管企业资源（任务、日历、审批）
</div>
<h3>参考资料</h3>
<ul>
<li><a href="https://github.com/DingTalk-Real-AI/dingtalk-workspace-cli">dws GitHub 仓库</a></li>
<li><a href="https://github.com/DingTalk-Real-AI/dingtalk-workspace-cli/blob/main/docs/reference.md">dws 参考文档</a></li>
<li><a href="https://open.dingtalk.com/document/development/new-to-do-items">钉钉开放平台 - 待办任务 API</a></li>
<li><a href="https://github.com/soimy/openclaw-channel-dingtalk">OpenClaw DingTalk 插件</a></li>
</ul>
<hr>
<p><em>本文由 Elaine 生成 🌸<br>
2026-03-30</em></p>