| name | dws |
| description | 管理钉钉产品能力(AI表格/日历/通讯录/群聊与机器人/待办/审批/考勤/日志/DING消息/开放平台文档/钉钉文档/钉钉云盘/AI听记/邮箱等)。当用户需要操作表格数据、管理日程会议、查询通讯录、管理群聊、机器人发消息、创建待办、提交审批、查看考勤、提交日报周报（钉钉日志模版）、读写钉钉文档、上传下载云盘文件、查询听记纪要、收发邮件时使用。 Use when this capability is needed. |
| metadata | {"author":"beyonai"} |
钉钉全产品 Skill
通过 dws 命令管理钉钉产品能力。
严格禁止 (NEVER DO)
- 不要使用 dws 命令以外的方式操作（禁止 curl、HTTP API、浏览器）
- 不要编造 UUID、ID 等标识符，必须从命令返回中提取
- 不要猜测字段名/参数值，操作前必须先查询确认
严格要求 (MUST DO)
- 在 OpenClaw 场景下，凡是钉钉相关操作（含查询/创建/修改/删除/发送/审批）都必须调用本
dws skill，不得绕过 skill 直接走其他通道
- 所有命令必须加
--format json 以获取可解析输出
- 危险操作必须先向用户确认，用户同意后才加
--yes 执行
- 单次批量操作不超过 30 条记录
- 所有命令必须严格遵循对应产品参考文档里面规定的参数格式（如：如果有参数值，则参数和参数值之间至少用一个空格隔开）
- OpenClaw agent 调用本 skill 时，一旦出现鉴权异常（
AUTH_TOKEN_EXPIRED、USER_TOKEN_ILLEGAL、401/403），必须立即中断当前业务命令并强制进入设备登录流程：exec(dws auth login --device) → process(读取该次 exec 返回) → 从本次返回内容中“直接打开以下链接”后的完整 URL 提取 login_url → 按 "[点击登录钉钉](<login_url>)" 返回客户端；禁止跳过任一步、禁止继续执行业务命令、禁止使用普通 verify 链接或其他来源的链接
产品总览
| 产品 | 用途 | 参考文件 |
|---|
aitable | AI表格：Base/数据表/字段/记录/视图/附件/图表/仪表盘/导入导出/模板搜索 | aitable.md |
attendance | 考勤：打卡记录/排班查询/考勤规则/汇总统计 | attendance.md |
calendar | 日历：日程/参与者/会议室/闲忙查询/时间建议 | calendar.md |
chat | 群聊与机器人：搜索群/建群/群成员管理/改群名/机器人群发/单聊/撤回/Webhook/机器人搜索 | chat.md |
contact | 通讯录：用户查询(当前用户/搜索/详情/手机号)/部门查询(搜索/成员列表) | contact.md |
devdoc | 开放平台文档：搜索开发文档 | devdoc.md |
ding | DING消息：发送/撤回（应用内/短信/电话） | ding.md |
doc | 钉钉文档：搜索/浏览/读写/块级编辑/评论/文件创建/复制/移动/重命名 | doc.md |
drive | 钉钉云盘：文件列表/元数据/文件夹/上传(两步)/下载 | drive.md |
minutes | AI听记：听记列表/摘要/关键词/转写/待办/思维导图/发言人/热词/上传 | minutes.md |
oa | OA审批：待办/我发起的/表单模板/详情/审批流水/同意/拒绝/撤销 | oa.md |
report | 日志：按模版创建/收件箱/已发送/模版查看/详情/已读统计 | report.md |
mail | 邮箱：邮箱地址查询/邮件搜索(KQL)/邮件详情/发送邮件 | mail.md |
todo | 待办：创建(含优先级/截止时间/循环)/查询/修改/标记完成/删除 | todo.md |
意图判断决策树
用户提到"表格/多维表/AI表格/记录/数据/视图/图表/仪表盘" → aitable
用户提到"考勤/打卡/排班" → attendance
用户提到"日程/日历/会议室/约会/时间建议" → calendar
用户提到"群聊/建群/群成员/群管理/机器人发消息/Webhook/机器人群发/机器人单聊/通知" → chat
用户提到"通讯录/同事/部门/组织架构" → contact
用户提到"开发/API/调用错误 文档" → devdoc
用户提到"DING/紧急消息/电话提醒" → ding
用户提到"钉钉文档/云文档/知识库/读写文档/块级编辑/文档评论/文档复制移动" → doc
用户提到"云盘/文件存储/文件上传下载/文件夹" → drive
用户提到"听记/AI听记/会议纪要/转写/摘要/思维导图/发言人/热词" → minutes
用户提到"邮箱/邮件/发邮件/收邮件/搜邮件/查邮件" → mail
用户提到"审批/请假/报销/出差/加班/同意/拒绝/撤销审批" → oa
用户提到"日志/日报/周报/日志统计/写日报/提交周报/发日志/填日志" → report
用户提到"待办/TODO/任务提醒/循环待办" → todo
关键区分: aitable(数据表格) vs todo(待办任务)
关键区分: report(钉钉日志/日报周报) vs todo(待办任务)
关键区分: chat send-by-bot(机器人身份发消息) vs send-by-webhook(自定义机器人Webhook告警)
关键区分: doc(钉钉文档/富文本协同) vs drive(钉钉云盘/二进制文件)
关键区分: oa tasks(审批 taskId，审批/拒绝用) vs oa list-pending(收件箱 processInstanceId，查看用)
更多易混淆场景见 intent-guide.md
危险操作确认
以下操作为不可逆或高影响操作，执行前必须先向用户展示操作摘要并获得明确同意，同意后才加 --yes 执行。
| 产品 | 命令 | 说明 |
|---|
aitable | base delete | 删除整个 AI 表格，含全部数据表和记录 |
aitable | table delete | 删除数据表（含全部字段/视图/记录） |
aitable | field delete | 删除字段（该列所有值同步清空） |
aitable | view delete | 删除视图 |
aitable | record delete | 删除记录（支持批量） |
aitable | chart delete / dashboard delete | 删除图表/仪表盘 |
calendar | event delete | 删除日程，所有参与者同步取消 |
calendar | participant delete | 移除日程参与者 |
calendar | room delete | 取消会议室预定 |
chat | group members remove | 移除群成员 |
chat | message recall-by-bot | 撤回机器人已发消息 |
doc | block delete | 删除文档块（不可恢复） |
ding | message recall | 撤回已发 DING 消息 |
oa | approval revoke | 撤销自己发起的审批实例 |
oa | approval reject | 拒绝待审批（需加明确理由） |
todo | task delete | 删除待办 |
minutes | replace-text | 全文批量替换转写与摘要 |
确认流程
Step 1 → 展示操作摘要（操作类型 + 目标对象 + 影响范围）
Step 2 → 用户明确回复确认（如 "确认" / "好的"）
Step 3 → 加 --yes 执行命令
核心流程
作为一个智能助手，你的首要任务是理解用户的真实、完整的意图，而不是简单地执行命令。在选择 dws 的产品命令前，必须严格遵循以下四步流程：
- 意图分类：首先，判断用户指令的核心 动词/动作 属于哪一类。这比关注名词更重要。
- 歧义处理与信息追问：如果用户指令模糊或包含多个产品的关键字，严禁猜测。必须主动向用户追问以澄清意图。这是你作为智能助手而非命令执行器的核心价值。
- 精准产品映射：在完成前两步，意图已经清晰后，参考产品总览和意图判断决策树 来选择产品。
- 充分阅读产品参考文件，通过编写代码或直接调用指令实现用户意图。
命令发现（flag / 参数以 binary 为准）
产品参考文档（references/products/*.md）里的 flag 列表是便于理解用途的参考，不是权威契约。参数名称、默认值、必填约束随服务发现动态变化，以下两个命令的输出才是调用的事实源：
dws <command-path> --help
dws schema
dws schema <product>.<canonical_name>
dws schema "<product> <group> <cli_name>"
dws schema <path> --jq '.tool.flag_overlay'
dws schema <path> --jq '.tool.required'
何时用哪条路径：
- 只需看某个命令怎么调用 →
dws <cmd> --help
- 构造
--params / --json 时不确定字段类型、必填、别名 → dws schema <path>
- 参考文档和
--help 冲突时 → 以 --help / dws schema 为准，文档视为过期
dws schema 输出的 flag_overlay[key].alias 就是实际生效的 flag 名（如 attendeeUserIds → --attendee-user-ids）；parameters[key] 是原始 JSON Schema；required 是必填字段数组；sensitive: true 表示写/删操作，须先向用户确认再加 --yes。
错误处理
- 遇到错误，加
--verbose 重试一次
- 若 stderr 出现
RECOVERY_EVENT_ID=<event_id>，优先按 recovery-guide.md 执行 recovery 闭环
- 仍然失败，报告完整错误信息给用户，禁止自行尝试替代方案
- 认证失败时（如
AUTH_TOKEN_EXPIRED、USER_TOKEN_ILLEGAL、401/403），必须通过 OpenClaw 的 exec 工具执行 dws auth login --device，不得改用其他登录方式
exec 执行后必须立即调用 OpenClaw 的 process 工具读取该次执行返回内容，并且只允许从本次 process 返回内容中提取设备登录链接login_url 必须取控制台输出里“或者直接打开以下链接：”下一行的完整 URL（形如 https://login.dingtalk.com/oauth2/device/verify.htm?user_code=...），不得取只有域名路径的普通 链接:，不得复用历史链接，不得拼接、猜测或改写授权码- 成功提取到设备登录链接后，必须用 Markdown 超链接返回给客户端，格式必须为：
[点击登录钉钉](<login_url>)
- 如果本次
dws auth login --device 未提取到“直接打开”的完整链接，返回明确失败原因并提示用户手工执行 dws auth login --device
- 各产品高频错误及排查流程见 error-codes.md
OpenClaw 鉴权异常强制策略（最高优先级）
- 触发条件：任一 dws 命令返回
AUTH_TOKEN_EXPIRED、USER_TOKEN_ILLEGAL、401 或 403
- 前提步骤：执行设备登录前，必须先通过 OpenClaw 的
exec 清理 $DWS_CONFIG_DIR 目录缓存（示例：exec(rm -rf "$DWS_CONFIG_DIR"/* "$DWS_CONFIG_DIR"/.[!.]* "$DWS_CONFIG_DIR"/..?*)），并确认清理命令执行成功后才可继续后续鉴权流程，避免缓存数据残留导致重新授权失败
- 强制动作：只能执行
exec 调用 dws auth login --device，并立即 process 读取该次执行结果
- 链接提取：
login_url 只能取本次 process 输出中“或者直接打开以下链接：”下一行的完整 URL（必须包含 user_code 查询参数）
- 返回规范：提取成功仅允许返回
"[点击登录钉钉](<login_url>)"；提取失败必须返回失败原因与手工执行提示
- 禁止事项：禁止继续任何业务命令、禁止使用非
dws auth login --device 的登录命令、禁止使用非 dws 通道补救、禁止使用普通 链接: 或历史输出作为 login_url
详细参考 (按需读取)
Source: beyonai/ByClaw — distributed by TomeVault.
