karuo-ai/开发文档/10、使用手册/OpenClaw控制台/06-常见问题.md

06 常见问题（FAQ）

OpenClaw 控制台使用手册 > 常见问题（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 集成 | 下一篇：无

返回 章节目录