OpenClaw 常见问题
本页适用于 OpenClaw。
先按报错判断
| 报错 | 优先处理 |
|---|---|
model_not_found / 当前服务暂不支持该模型 | 检查模型名称和分组 |
403 Forbidden | 检查令牌的「模型可用列表」 |
| 配置没生效 | 确认 openclaw gateway 与 openclaw tui 都在新开的终端里运行 |
找不到 openclaw 命令
openclaw --version
提示找不到命令，说明 PATH 还没刷新：
- 关掉终端重新打开
- 仍不行就重新执行安装脚本：
curl -fsSL https://openclaw.ai/install.sh | bash
- 用 npm 装的则重新全局安装：
npm install -g openclaw@latest
TUI 起不来
OpenClaw 需要两个进程：先起 gateway，再开 tui。
| 窗口 | 命令 |
|---|---|
| 第一个 | openclaw gateway |
| 第二个 | openclaw tui |
如果 gateway 窗口报错，tui 自然连不上。先看 gateway 窗口的输出。
配置没生效
OpenClaw 的供应商配置通常由 CC-Switch 写入。检查：
- CC-Switch 里切到了 OpenClaw 页签
- 供应商已保存并启用
- API 端点是
https://187api.com/v1（带/v1） - API 协议选的是 OpenAI Completions
- 「发送 User-Agent」保持开启
- 改完重开终端再跑
openclaw tui
返回 403：该令牌无权访问模型
「模型可用列表」不包含当前请求的模型。建议在 令牌管理 里留空；必须限制时，填写与 模型广场 完全一致的模型名。
排错
| 现象 | 检查 |
|---|---|
| 404 | API 端点少了 /v1 |
| 401 | API Key 不完整，或误填了带 Bearer 前缀的内容 |
| 模型不支持 | 模型名与模型广场不一致 |
相关：OpenClaw 配置 · CC-Switch 配置 · 常见问题总览