在钉钉会话中通过 dws CLI 管理钉钉产品能力(AI表格/日历/通讯录/群聊与机器人/待办/审批/考勤/日志/DING消息/工作台等)。 当用户需要操作表格数据、管理日程会议、查询通讯录、管理群聊、机器人发消息、创建待办、提交审批、查看考勤、提交日报周报时使用。
通过 dws 命令管理钉钉产品能力。所有命令由 openclaw 在终端中执行,agent 负责生成正确的 CLI 命令。
使用本 skill 前,需确认 dws CLI 已安装并完成授权:
dws --version,确认版本 >= 1.0.6dws auth status,确认已登录DWS_CHANNEL=openclaw — 标识调用来源为 openclaw connectorDWS_CLIENT_ID=<clientId> — 当前钉钉应用的 Client IDDWS_CLIENT_SECRET=<clientSecret> — 当前钉钉应用的 Client Secret如果 CLI 未安装或未授权,请引导用户完成对应操作(详见下方错误处理章节)。
--format json 以获取可解析输出--yes 执行| 产品 | 用途 | 参考文件 |
|---|---|---|
aitable | AI表格:表格/数据表/字段/记录增删改查/模板搜索 | aitable.md |
approval | 审批:审批表单/发起实例/审批/撤销 | simple.md |
attendance | 考勤:打卡记录/排班查询 | attendance.md |
calendar | 日历:日程/参与者/会议室/闲忙查询 | calendar.md |
chat | 群聊与机器人:搜索群/建群/群成员管理/改群名/机器人群发/单聊/撤回/Webhook/机器人搜索 | chat.md |
contact | 通讯录:用户查询(当前用户/搜索/详情)/部门查询(搜索/子部门/成员列表) | contact.md |
devdoc | 开放平台文档:搜索开发文档 | simple.md |
ding | DING消息:发送/撤回(应用内/短信/电话) | ding.md |
report | 日志:按模版创建/收件箱/已发送/模版查看/详情/已读统计 | report.md |
todo | 待办:创建(含优先级/截止时间)/查询/修改/标记完成/删除 | todo.md |
workbench | 工作台:应用管理 | workbench.md |
用户提到"表格/多维表/AI表格/记录/数据" → aitable
用户提到"审批/请假/报销/出差/加班" → oa
用户提到"考勤/打卡/排班" → attendance
用户提到"日程/日历/会议室/约会" → calendar
用户提到"群聊/建群/群成员/群管理/机器人发消息/Webhook/机器人群发/机器人单聊/通知" → chat
用户提到"通讯录/同事/部门/组织架构" → contact
用户提到"开发/API/调用错误 文档" → devdoc
用户提到"DING/紧急消息/电话提醒" → ding
用户提到"日志/日报/周报/日志统计/写日报/提交周报/发日志/填日志" → report
用户提到"待办/TODO/任务提醒" → todo
用户提到"工作台/应用管理" → workbench
关键区分: aitable(数据表格) vs todo(待办任务) 关键区分: report(钉钉日志/日报周报) vs todo(待办任务) 关键区分: chat send-by-bot(机器人身份发消息) vs send-by-webhook(自定义机器人Webhook告警)
更多易混淆场景见 intent-guide.md
以下操作为不可逆或高影响操作,执行前必须先向用户展示操作摘要并获得明确同意,同意后才加 --yes 执行。
| 产品 | 命令 | 说明 |
|---|---|---|
aitable | base delete | 删除整个 AI 表格,含全部数据表和记录 |
aitable | record delete | 删除记录(支持批量) |
calendar | event delete | 删除日程,所有参与者同步取消 |
calendar | participant delete | 移除日程参与者 |
calendar | room delete | 取消会议室预定 |
chat | group members remove | 移除群成员 |
todo | task delete | 删除待办 |
Step 1 → 展示操作摘要(操作类型 + 目标对象 + 影响范围)
Step 2 → 用户明确回复确认(如 "确认" / "好的")
Step 3 → 加 --yes 执行命令
作为一个智能助手,你的首要任务是理解用户的真实、完整的意图,而不是简单地执行命令。在选择 dws 的产品命令前,必须严格遵循以下四步流程:
| 错误信号 | 识别方式 | 处理策略 |
|---|---|---|
| CLI 未安装 | stderr 包含 "command not found: dws" | 引导用户安装:npm i -g dingtalk-workspace-cli 或 curl -fsSL .../install.sh | sh |
| CLI 未登录 | stderr 包含 "请先执行 dws login" 或 "dws auth login" | 引导用户执行 dws auth login 完成 OAuth 扫码授权 |
| Token 过期 | stderr 包含 "token expired" | 提示用户重新执行 dws auth login |
| 权限不足 | stderr 包含 "permission denied" 或 HTTP 403 | 提示用户联系管理员开通对应权限 |
| Recovery 事件 | stderr 包含 RECOVERY_EVENT_ID=<event_id> | 按 recovery-guide.md 执行 recovery 闭环 |
| 其他错误 | 非零退出码 + 无法识别的 stderr | 加 --verbose 重试一次 → 仍失败则报告完整错误信息给用户 |
--verbose 重试一次RECOVERY_EVENT_ID=<event_id>,优先按 recovery-guide.md 执行 recovery 闭环RECOVERY_EVENT_ID、execute/finalize 规范