OpenClaw 树莓派部署:Gateway 仪表盘登录与网络配置排查
在树莓派上部署 OpenClaw 时,不少开发者会碰上一连串'拦路虎':从局域网无法访问,到跨域报错,再到 HTTPS 安全上下文限制,最后是设备配对验证。
这里复盘了我遇到的四个核心问题及其解决方案,按发生顺序排列,助您一次性打通所有关卡,顺利运行 AI 代理网关。
第一关:局域网无法访问(端口监听问题)
现象描述
树莓派上的 OpenClaw Gateway 服务已启动,日志显示正常监听 18789 端口。但在同一局域网的其他电脑浏览器中输入 http://<树莓派 IP>:18789,却显示无法连接或连接超时。
原因分析
默认情况下,某些服务可能只绑定在 localhost (127.0.0.1) 上,这意味着它只接受来自树莓派内部的请求,拒绝外部局域网设备的访问。
解决方案:修改 Bind 模式
需要修改网关配置文件,将其监听地址改为 0.0.0.0(允许所有网卡接口访问)。
编辑配置文件(通常位于 ~/.openclaw/openclaw.json):
sudo vi ~/.openclaw/openclaw.json
找到 gateway 的 bind 部分,将 mode 设为 local,bind 设为 lan:
"gateway":{"port":18789,"mode":"local","bind":"lan"}
保存并重启服务:
sudo openclaw gateway restart
现在应该可以在局域网其他设备上通过 http://:18789 访问了(虽然接下来可能会报跨域错误,但这证明网络通了)。
第二关:跨域错误 CORS(白名单配置)
现象描述
网页能打开了,但会话界面显示错误信息,页面功能异常,提示类似:
origin not allowed (open the Control UI from the gateway host or allow it in gateway.controlUi.allowedOrigins)
原因分析
浏览器的同源策略 (Same-Origin Policy) 阻止了网页向不同源(即使只是 IP 不同)发起请求。OpenClaw 默认可能只允许特定的域名访问,或者未配置允许的 Origin 列表。
解决方案:配置 Gateway 白名单
在配置文件中明确添加您的局域网 IP 或允许所有来源(测试环境)。
再次编辑配置文件:
vi ~/.openclaw/openclaw.json


