78 lines
2.7 KiB
Markdown
78 lines
2.7 KiB
Markdown
## 06 常见问题（FAQ）
|
||
|
||
> [OpenClaw 控制台使用手册](README.md) > 常见问题（FAQ）
|
||
|
||
---
|
||
|
||
## 6.1 控制面板打不开怎么办？
|
||
|
||
**现象**：访问 `http://127.0.0.1:18789/config` 显示无法连接。
|
||
|
||
可能原因与处理：
|
||
|
||
| 原因 | 处理方式 |
|
||
|------|----------|
|
||
| 网关未启动 | 按「02 快速入门」中的方式启动网关：`openclaw gateway start` 或启动相关 Docker 容器。 |
|
||
| 端口被占用或改动 | 确认实际网关端口（例如配置为其他端口），按实际端口访问；或调整为 18789。 |
|
||
| 本机防火墙限制 | 临时关闭或放行本地 18789 端口后重试。 |
|
||
|
||
---
|
||
|
||
## 6.2 对话返回 500 或报错信息
|
||
|
||
**现象**：在控制面板中对话报 500，或 Cloud Boot 上看到「系统错误」。
|
||
|
||
排查顺序：
|
||
|
||
1. 查看 OpenClaw 的「日志」模块，找到最近一条错误。
|
||
2. 根据错误信息判断是 Provider 报错还是网关自身异常。
|
||
3. 若是 v0 相关错误：
|
||
- 检查 baseUrl 是否为 `https://api.v0.dev/v1`；
|
||
- 检查模型 ID 是否为 `v0-1.5-md` 或 `v0-1.5-lg`；
|
||
- 检查 API Key 是否有效，Billing/配额是否正常。
|
||
4. 若是 Ollama 报错：
|
||
- 使用 `curl -s http://localhost:11434/api/tags` 确认服务与模型是否正常。
|
||
|
||
---
|
||
|
||
## 6.3 模型似乎没变，仍然是旧模型
|
||
|
||
**现象**：在「配置 → Models」中修改了默认模型，但对话中感觉没变化。
|
||
|
||
处理方式：
|
||
|
||
- 修改默认模型后，**新建一个会话** 测试；
|
||
- 在使用统计或调试信息中确认 `model:` 字段是否为预期值；
|
||
- 如仍无变化，检查 `~/.openclaw/openclaw.json` 中是否有覆盖默认配置的字段。
|
||
|
||
---
|
||
|
||
## 6.4 飞书/Cloud Boot 收不到回复
|
||
|
||
**现象**：Cloud Boot/飞书消息发送成功，但长时间没有任何回复。
|
||
|
||
排查建议：
|
||
|
||
1. 确认 `start_feishu_frpc.sh` 是否已执行，桥接服务是否在运行；
|
||
2. 在浏览器访问 `http://127.0.0.1:8888/`（若有提供状态页）查看桥接健康状态；
|
||
3. 检查 frpc 日志，确认外网穿透是否正常；
|
||
4. 检查飞书开发者后台中配置的回调 URL 与签名设置是否与本地配置匹配；
|
||
5. 在 OpenClaw 日志中查看是否有收到对应请求。
|
||
|
||
---
|
||
|
||
## 6.5 如何确认当前到底用的是本机小模型还是云端模型？
|
||
|
||
- 在控制面板中查看会话的使用信息：
|
||
- 若显示 `provider: ollama` 且 `model: ollama/qwen2.5:3b`，则在用本机小模型。
|
||
- 若显示 v0 或其他云端 Provider，则为云端模型。
|
||
- 也可以直接在对话中提问，例如：
|
||
- “你当前使用的 Provider 和模型名称是什么？”
|
||
|
||
---
|
||
|
||
上一篇：[05 飞书与 Cloud Boot 集成](05-飞书与CloudBoot集成.md) | 下一篇：无
|
||
|
||
返回 [章节目录](README.md)
|
||
|