帮助支持
约 662 字大约 2 分钟
常见问题FAQ
快速解答及真实场景的深度故障排除（本地开发、VPS、多智能体、OAuth/API 密钥、模型故障转移）。
目录
- 快速开始与首次运行设置
- 什么是 OpenClaw
- 技能与自动化
- 沙箱与记忆
- 磁盘存储位置
- 配置基础
- 远程网关与节点
- 会话与多聊天
- 模型：默认、选择、别名、切换
- 网关：端口、"already running"、远程模式
- 日志与调试
- 安全与访问控制
故障排查
60秒快速诊断
按顺序运行以下命令：
openclaw status
openclaw status --all
openclaw gateway probe
openclaw logs --follow如果网关可达，运行深度探测：
openclaw status --deep常见问题
openclaw: command not found
几乎总是 Node/npm PATH 问题。请参阅：安装说明
安装程序失败（或需要完整日志）
以详细模式重新运行安装程序：
curl -fsSL https://openclaw.bot/install.sh | bash -s -- --verboseBeta 安装：
curl -fsSL https://openclaw.bot/install.sh | bash -s -- --beta --verbose也可以设置 OPENCLAW_VERBOSE=1 环境变量。
网关 "unauthorized"、无法连接或持续重连
请参阅：
Control UI 在 HTTP 上失败（需要设备身份）
请参阅：
docs.openclaw.ai 显示 SSL 错误 (Comcast/Xfinity)
部分 Comcast/Xfinity 连接会通过 Xfinity Advanced Security 错误地阻止 docs.openclaw.ai。
解决方法：禁用 Advanced Security 或将 docs.openclaw.ai 添加到白名单。
- Xfinity Advanced Security 帮助：https://www.xfinity.com/support/articles/using-xfinity-xfi-advanced-security
- 快速检查：尝试使用移动热点或 VPN 确认是否为 ISP 级别过滤
服务显示运行中，但 RPC 探测失败
请参阅：
模型/认证失败（速率限制、计费、"all models failed"）
请参阅：
/model 提示 model not allowed
这通常意味着 agents.defaults.models 配置为白名单模式。当非空时，只有这些 provider/model 键可以被选择。
- 检查白名单：
openclaw config get agents.defaults.models - 添加你想要的模型（或清空白名单）然后重试
/model - 使用
/models浏览允许的 providers/models
提交 Issue
粘贴安全报告：
openclaw status --all如果可以，请附上 openclaw logs --follow 的相关日志。