OpenClaw本地部署连接不上服务怎么办?

云磊吖_6725

云磊吖_6725

2026-07-31

465人浏览

原创

openclaw本地部署后浏览器打不开是因为服务未监听127.0.0.1:18789,需依次验证服务状态、node.js版本、启动模式(必须含--mode local)、网关绑定地址(应设为0.0.0.0)、端口占用及ollama连通性,并修复ssrf策略限制。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

openclaw本地部署连接不上服务怎么办?

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”,端口也可能未真正监听。先验证:

OpenClaw Ops
OpenClaw Ops

运维命令——OpenClaw 部署的仪表盘、监控与管理

下载

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 自动校验并备份旧配置,再重启网关。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
OpenClaw如何卸载
OpenClaw如何卸载

《OpenClaw如何卸载?OpenClawAI小龙虾安全卸载最新指南》为您提供详尽、安全的卸载步骤,帮助用户彻底移除OpenClaw及其相关组件。本指南针对Windows与macOS系统分别说明操作流程,涵盖停止后台进程、清除配置文件、删除残留数据等关键环节,确保无痕卸载,避免系统冲突或隐私泄露。无论您是因更换工具、解决兼容问题,还是出于安全考虑,本文都将助您高效、安心地完成卸载操作。请务必按照最新版本指引执行,以保障设备稳定与数据安

2026.03.19

140

11

OpenClaw安装部署教程
OpenClaw安装部署教程

本合集涵盖2026最新版OpenClaw(小龙虾)本地部署全流程,适用于Windows系统,包含环境配置、模型接入、Web界面启动及飞书/Telegram/QQ等多平台对接。无论你是小白还是开发者,10分钟内即可完成安装,快速体验AI智能体“长手干活”的强大能力!

2026.03.19

201

11

OpenClaw初学者教程:如何使用和设置
OpenClaw初学者教程:如何使用和设置

《OpenClawAI初学者教程:如何使用和设置》是一套面向新手的入门指南,涵盖环境搭建、基础配置、模型加载及简单推理操作。通过本教程,你将快速掌握OpenClawAI的核心功能,轻松开启AI开发之旅。

2026.03.19

141

13

OpenClawAI技能系统基础介绍:OpenClawAISkills是什么
OpenClawAI技能系统基础介绍:OpenClawAISkills是什么

OpenClawAI Skills 是 OpenClaw 智能体的核心功能模块,用于定义和管理 AI 可执行的具体能力,如查询天气、发送消息、操作文件等。通过技能系统,用户可灵活扩展智能体功能,实现高度定制化的自动化任务。

2026.03.20

898

20

龙虾OpenClaw安全使用指南
龙虾OpenClaw安全使用指南

围绕龙虾OpenClawAI使用中的安全风险,本合集系统梳理常见漏洞与隐患,提供实用防护方法与最新安全指南,帮助用户在稳定运行的同时规避风险,提升整体使用安全性与体验。

2026.03.20

149

11

openclaw养虾硬件指南最新版
openclaw养虾硬件指南最新版

《OpenClawAI硬件指南最新版》合集聚焦AI硬件入门与进阶,从核心组件解析到实战搭建,系统讲解算力配置、设备选型与优化方案。内容通俗易懂,适合开发者与科技爱好者快速掌握AI硬件要点,构建高效稳定的智能计算环境。

2026.03.20

448

28

OpenClaw从新手到中级完整教程
OpenClaw从新手到中级完整教程

本专题专为零基础用户设计,带你从环境搭建到实战应用,系统掌握开源AI Agent OpenClaw。内容涵盖Node.js/Docker安装、API配置、Skills技能扩展及多平台集成,通过整理文件、自动化办公等真实案例,助你快速上手。无论你是想提升效率的职场人还是技术爱好者,都能在此找到从入门到精通的完整路径,打造专属的本地化AI助手。

2026.05.06

1022

32

OpenClaw免费大模型调用指南
OpenClaw免费大模型调用指南

PHP中文网特设OpenClaw免费大模型专区,提供详尽调用指南。涵盖免费API申请、模型配置及本地部署教程,助您零成本畅享AI智能体验。无论是新手入门还是进阶应用,这里都有实用干货,轻松跨越创作门槛,开启高效智能办公新方式。

2026.06.29

139

10

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程