OpenClaw · 报错与FAQ

① command not found: openclaw → PATH 未刷新或 Node 版本低，重开终端、node -v 确认 ≥22
② sharp/原生模块编译失败 → SHARP_IGNORE_GLOBAL_LIBVIPS=1 或 pnpm approve-builds -g 用预构建二进制
③ Windows 直接装失败 → 转 WSL2（Ubuntu）重走 Linux 流程最稳
④ 安装脚本连不上 → 网络问题，换镜像或手动 npm 安装

① 智能体不回复 → 先看网关日志（守护进程状态），再看模型 Key 是否有效——大部分"不回话"是 Key 401
② 渠道消息收不到 → Token 过期/机器人没上线；WhatsApp 扫码登录失效需重新扫
③ 搜索总说搜不到 → 没配 Brave Search Key，openclaw configure 补上
④ 引导卡住 → --no-onboard 跳过后手动 configure

Q：免费吗？软件开源免费，但模型 API 按用量收费（这是大头，选便宜模型+控制对话长度）。
Q：数据在哪？本地 ~/.openclaw/，不上传第三方（除了你调用的模型 API 本身）。
Q：能接微信/QQ吗？官方不直接支持，社区有非官方方案但风险自担；要国内 IM 官方级支持请看 Octop。
Q：和 Hermes 什么关系？同类竞品，Hermes 主打技能自进化+跨会话记忆，官方提供一键迁移工具，见迁移指南。
Q：怎么升级？npm 安装的 npm update -g openclaw；升级前备份 ~/.openclaw/。