OpenClaw FAQ 汇总

说明

这份 FAQ 不是替代完整手册，而是帮助你快速定位高频问题。

1. 为什么 http://127.0.0.1:18791/ 打不开？

答：

• 当前机器正确的 Dashboard 主地址是 http://127.0.0.1:18789/
• 18791 虽然被监听，但直接访问会返回 401 Unauthorized

优先执行：

openclaw status
openclaw dashboard --no-open

2. 为什么会提示 gateway token mismatch？

答：

常见原因是：

• 浏览器缓存了旧 token
• 打开的不是当前正确的完整 Dashboard 链接

处理方法：

1. 关闭当前页面
2. 运行 openclaw dashboard --no-open
3. 用新复制的完整链接在无痕窗口打开

3. 为什么已经接好 Codex 了，聊天还提示没有 API key？

答：

通常是：

• Gateway 还在使用旧的认证快照

处理方法：

openclaw gateway restart

然后重新打开 Dashboard。

4. 为什么 doctor 还提示 embedding provider 没配置？

答：

因为：

• Codex 默认模型接好，不等于 memory search 的 embedding provider 也配置好了

影响：

• 不影响基础聊天
• 会影响 memory search 等高级功能

5. 为什么不建议一开始就开 sandbox？

答：

因为你当前这台机器：

• 不装 Docker

而 OpenClaw 的 sandbox 是 Docker-based。现在直接开，很可能让非主会话不可用。

6. 为什么不建议把 Gateway 暴露到局域网？

答：

因为当前这套配置更适合：

• 本机个人使用
• loopback + token 边界

一旦开放到局域网，安全和信任边界会立刻复杂很多。

7. 个人用户最稳的配置是什么？

答：

当前推荐：

• gateway.mode = local
• gateway.bind = loopback
• gateway.auth.mode = token
• tools.elevated.allowFrom.webchat = []
• sandbox.mode = off
• 默认模型走 openai-codex/gpt-5.3-codex

详见：06-个人本机推荐配置模板

8. 我应该先看 ClawPanel 还是 Claw-Empire？

答：

如果你当前重点是：

• 安装
• 配置
• 管理
• 排障

优先看：

• ClawPanel

如果你后面重点是：

• 多 Agent 协作
• 任务流
• 会议与报告

再看：

• Claw-Empire

9. 这套手册最推荐的阅读顺序是什么？

答：

优先按这个顺序：

1. 01-OpenClaw 标准安装步骤
2. 04-OpenClaw 接入 Codex
3. 02-OpenClaw 故障排查
4. 06-个人本机推荐配置模板

详见：11-对外公开阅读顺序指南

分类：OpenClaw