用途:通过 dws 命令管理钉钉产品能力,所有命令由 openclaw 在终端执行,agent 负责生成正确的 CLI 命令。覆盖 AI 表格、审批、考勤、日历、群聊与机器人、通讯录、开放平台文档、DING 消息、日志、待办、工作台。
前置条件:需确认 dws CLI 已安装并授权。安装检查执行 dws --version,确认版本 >= 1.0.6;授权检查执行 dws auth status,确认已登录。connector 运行时会自动注入 DWS_CHANNEL、DWS_CLIENT_ID、DWS_CLIENT_SECRET 环境变量,dws CLI 自动读取,无需手动设置。
主要能力:按意图路由到对应产品,如表格/记录走 aitable,审批/请假/报销走 oa,考勤/打卡/排班走 attendance,日程/会议室走 calendar,群聊/机器人发消息走 chat,通讯录/部门走 contact,开发文档走 devdoc,DING 走 ding,日志/日报周报走 report,待办走 todo,工作台走 workbench。
使用方式:所有命令必须加 --format json 获取可解析输出;危险操作(如删除表格、删除记录、删除日程、移除群成员、取消会议室、删除待办)须先展示操作摘要并获得用户明确同意,再加 --yes 执行;单次批量操作不超过 30 条记录;不得编造 UUID/ID,须从命令返回中提取;不得猜测字段名或参数值,操作前先查询确认;禁止使用 curl、HTTP API、浏览器等 dws 以外方式。
错误处理:CLI 未安装时引导执行 npm i -g dingtalk-workspace-cli 或 curl -fsSL .../install.sh | sh;未登录时引导执行 dws auth login;Token 过期提示重新登录;权限不足提示联系管理员;出现 RECOVERY_EVENT_ID 时按 recovery-guide.md 执行闭环;其他错误加 --verbose 重试一次,仍失败则报告完整错误。
限制:需已安装并授权 dws CLI;部分操作不可逆;批量上限 30 条;具体产品参数格式须参考对应产品文档,资料未提供完整命令细节。