SuperAPI AI 工具集

dingtalk-troubleshoot

通用与其它

查看项目

更新于 10-15 21:10

技能介绍

用途:该技能用于排查钉钉连接器(dingtalk-openclaw-connector)相关问题,当 dws 命令执行失败、授权异常或连接中断时自动激活,提供常见错误处理、授权排查与连接故障诊断。

主要能力与用法:

  1. 命令未找到:提示 command not found: dws 时,安装 dws CLI:npm i -g dingtalk-workspace-cli,或使用一键安装脚本:curl -fsSL https://github.com/open-dingtalk/dingtalk-workspace-cli/releases/latest/download/install.sh | sh,并用 dws --version 验证(应 >= 1.0.6)。
  2. 未登录:提示请先执行 dws login 时,执行 dws auth login,用钉钉扫码完成 OAuth 授权后重试。
  3. token 过期:提示 token expired 时,重新执行 dws auth login 刷新授权后重试。
  4. 权限不足:提示 permission denied 或 HTTP 403 时,确认所需权限范围,联系组织管理员开通后重试。
  5. 扫码后机器人未上线:检查 openclaw 日志连接错误、确认钉钉开放平台已启用机器人能力、核对 clientId/clientSecret 与开放平台一致,并尝试重启 openclaw。

错误处理流程:当 stderr 出现 RECOVERY_EVENT_ID=<event_id> 时,提取该值,执行 dws recovery execute --event-id <event_id> --format json 获取恢复计划,按计划执行后用 dws recovery finalize --event-id <event_id> 完成闭环。通用重试:首次失败加 --verbose 重试,匹配已知错误模式则按 FAQ 处理,未匹配则将完整错误信息报告用户,禁止自行猜测替代方案。错误码速查见 dws-cli skill 的 error-codes.md,恢复规范见 recovery-guide.md。

适用场景:dws CLI 使用过程中的安装、授权、权限与连接问题排查。

限制:资料未提供其他平台支持、收费或价格信息;具体错误码与恢复细节需参考对应文档。