openclaw本地部署后浏览器打不开是因为服务未监听127.0.0.1:18789,需依次验证服务状态、node.js版本、启动模式(必须含--mode local)、网关绑定地址(应设为0.0.0.0)、端口占用及ollama连通性,并修复ssrf策略限制。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

OpenClaw本地部署后浏览器打不开 http://127.0.0.1:18789,终端提示 “Connection refused” 或 “This site can’t be reached”,说明服务未在预期端口监听或根本未启动,必须按路径逐层验证。
确认 OpenClaw 服务是否真正运行
执行 openclaw status 查看当前状态。若返回 inactive 或 command not found,说明服务未启动或命令不可用。
若提示 command not found,先检查 Node.js 是否已安装并可用:运行 node -v,确保输出为 v18.x 或 v20.x;若无输出,需重新安装 Node.js(推荐直接下载 v22 官方安装包双击安装,避开 Homebrew 卡死陷阱)。
确认环境就绪后,运行 openclaw start --mode local 启动服务。注意:【--mode local 参数不可省略】,否则默认以云端模式启动,不会启用本地网关。
检查网关绑定地址是否允许本机访问
OpenClaw 默认可能绑定到 127.0.0.1,这会导致浏览器虽在同一台机器却无法连接——因为部分系统或容器化环境会将 localhost 解析为隔离网络栈。
打开配置文件 ~/.openclaw/config.yaml,查找 gateway.bind_address 字段。
若值为 127.0.0.1,改为 0.0.0.0;若该字段不存在,手动添加一行:bind_address: 0.0.0.0,注意缩进与周围字段对齐(YAML 对空格敏感)。
保存后执行 openclaw restart 使配置生效。
排查 18789 端口是否被占用或未监听
即使服务显示“running”,端口也可能未真正监听。先验证:
Linux/macOS 执行:lsof -i :18789;Windows 执行:netstat -ano | findstr :18789。
若无任何输出,说明 OpenClaw 没有成功监听该端口,大概率是前两步未完成;若有 PID 输出,记下进程号,用 kill -9 [PID](Linux/macOS)或 taskkill /PID [PID] /F(Windows)终止冲突进程。
也可临时更换端口避让:在 config.yaml 中添加 port: 18790(缩进与 bind_address 一致),然后访问 http://127.0.0.1:18790 测试。
验证本地模型服务连通性(Ollama/Omlx)
如果仪表板能打开但模型始终显示 “unavailable”,问题可能出在本地 AI 服务连接环节。
方法一:用 curl 直接测试 Ollama 是否响应:curl http://127.0.0.1:11434/api/tags。若返回 JSON 列表,说明 Ollama 正常;若超时或报错,则需单独启动 Ollama(ollama serve)。
方法二:检查 SSRF 安全策略拦截。运行 openclaw config get browser.ssrfPolicy,若返回空或不包含 allowedHostnames 字段,说明新版 OpenClaw 默认阻止了对 localhost 的请求。
立即修复:执行 openclaw config set browser.ssrfPolicy.dangerouslyAllowPrivateNetwork true,再执行 openclaw config set browser.ssrfPolicy.allowedHostnames '["127.0.0.1","localhost"]'。
最后运行 openclaw doctor --fix 自动校验并备份旧配置,再重启网关。










