openclaw本地连接失败需四步排查：①用openclaw gateway status确认服务运行状态，僵死进程须强制kill；②检查config.yaml中gateway.bind_address是否为0.0.0.0；③验证18789端口是否被占用并释放或改端口；④确保gateway.auth.token存在、格式正确且非空。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
OpenClaw 本地服务连接失败时，浏览器提示 “This site can’t be reached 127.0.0.1 refused to connect”，说明客户端已发起连接请求，但 OpenClaw 核心服务未在指定端口监听或未能正常启动，必须从服务状态、监听地址、端口占用、认证配置四方面逐层验证。
确认 OpenClaw 网关服务是否真实运行
别信 UI 上的“正在启动”提示，先用命令确认进程是否存活：执行 openclaw gateway status。若返回 offline 或报错 command not found，说明服务根本没跑起来，或者命令路径损坏。
立即执行强制停服：openclaw gateway stop。如果命令无响应，证明进程已僵死，必须手动清空：
macOS/Linux 下运行：ps aux | grep openclaw-gateway | awk '{print $2}' | xargs kill -9；Windows 用户打开任务管理器 → 搜索 “openclaw-gateway” → 全部结束任务。
【不清理残留进程直接重启，90%概率复现离线】
检查 config.yaml 中 gateway.bind_address 配置
OpenClaw 默认可能绑定到 127.0.0.1，该地址仅允许本机进程访问，在 Docker 或某些系统配置下会导致外部（包括本机浏览器）无法建立连接。
打开配置文件 ~/.openclaw/config.yaml，查找 gateway.bind_address 字段，确认其值为 0.0.0.0 而非 127.0.0.1。
若字段不存在，手动添加一行：bind_address: 0.0.0.0，并确保缩进与同级字段一致。
保存后执行 openclaw restart 生效。
排查 18789 端口是否被其他进程占用
18789 端口被其他进程占用时，OpenClaw 启动会失败且不报显式错误，表现为服务看似运行但实际未监听。
第一步：Linux/macOS 执行 lsof -i :18789 或 netstat -tuln | grep 18789；Windows 执行 netstat -ano | findstr :18789。
第二步：若发现 PID，用 kill -9 [PID]（macOS/Linux）或 taskkill /F /PID [PID]（Windows）释放端口。
第三步：若不想改其他程序，可临时更换 OpenClaw 监听端口——编辑 config.yaml，在 gateway: 下添加 port: 18790，再重启服务。
验证 gateway.auth.token 是否存在且有效
方法一：检查配置文件中 gateway.auth.token 字段是否已填写，值是否为 32 位以上随机字符串（不能是空值、null 或纯数字）。
方法二：若 token 是手动注入的，确认它未被 YAML 解析器误读——例如带减号的 token 必须用双引号包裹：token: "a1b2-c3d4-e5f6-..."，否则会被识别为数组。
方法三：执行 openclaw gateway token reset 自动生成新 token 并写入配置，避免手输错误。
