更新与排障
自检
对 Agent 说“帮我看看为什么用不了”，Skill 会运行 whobot doctor。你也可以自己在终端运行：
whobot status --skill 2.0.0
whobot doctor --pretty
常见问题
| 现象 | 处理 |
|---|---|
whobot: command not found |
确认 Node.js 20+ 可用，运行 npx --yes @whobot/cli@latest install，新开终端再试 |
| 一句话安装失败 | 确认 Agent 能联网、能运行命令；或按各平台页面手动安装 |
npx skills 安装失败 |
安装工具需要 Node.js 22.20+；或改用手动复制 |
| 预检提示需要升级 | 按 Skill 给出的确认卡升级 CLI 或 Skill，然后新开会话 |
安装输出 PREVIOUS_CLI_MISSING 或 CREDENTIAL_ORIGIN_MISMATCH |
原来的程序被清理或服务地址已变。同意后用安装命令加 --reset-local 重装，再重新登录一次；员工和数据在服务端不受影响 |
| 显示已登录却不能用 | 说“为什么显示已登录却不能用”，Skill 会查询状态，必要时引导重置 |
| 等待中被宿主打断 | 回复“继续”或“刚才那通怎么样”，Skill 会查询同一个任务，不会重复操作 |
| 同一句话触发了两个 Skill | 停用旧版 openclaw-whobot |
更新
- CLI：说“CLI 要不要更新”，Skill 运行
whobot update展示当前版本和目标版本，确认后才更新。有正在进行的网页通话时，更新会被拒绝并提示先结束通话。 - Skill：用原来的安装渠道更新，例如
npx skills update、Claude Code 的/plugin、openclaw skills的更新命令；或重新复制最新文件。更新后新开会话。
联系客服
说“我要反馈问题”，Skill 会运行 whobot support，把报告放进代码块交给你，并在有客服二维码时一起展示。把这份报告直接发给客服即可。