openclaw网关离线需三步修复：第一步强制清理残留进程，第二步删除令牌、释放端口并强制重装，第三步启动验证并查日志或注入有效token。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
OpenClaw网关离线会导致模型调用失败、自动化任务卡死、控机功能完全失效，你刚点开界面就看到红色“Offline”提示，对话框发不出消息，连本地Ollama模型都调不动——这不是网络波动，而是服务进程或认证链路已中断。
第一步：确认网关真实状态并强制清理残留
别信界面上的“正在启动”，先看它到底有没有真跑起来：
执行 openclaw gateway status，如果返回 offline 或报错 command not found，说明服务没活或命令路径异常。
立即执行强制停服：openclaw gateway stop。
若命令无响应，说明进程已僵死，必须手动清空：
Linux/macOS下运行 ps aux | grep openclaw-gateway | awk '{print }' | xargs kill -9；
Windows下打开任务管理器 → 搜索“openclaw-gateway” → 全部结束任务。
【注意：不清理残留进程直接重启，90%概率复现离线】
第二步：删令牌、查端口、换配置
方法一：重置认证凭据
删除令牌文件：rm -f ~/.openclaw/.gateway-token（macOS/Linux）；
Windows用户请前往 %USERPROFILE%\.openclaw\.gateway-token 手动删除该文件。
方法二：释放冲突端口
默认端口18666若被占用，网关根本无法绑定监听。运行：
macOS/Linux：lsof -i :18666；
Windows：netstat -ano | findstr :18666。
查到PID后立刻杀掉，再删掉 ~/.openclaw/openclaw.json 里 "gateway.port" 字段，让服务自动选可用端口。
方法三：跳过配置校验强制重装
执行 openclaw gateway install --force，此操作会覆盖损坏的二进制和配置模板，但保留用户技能数据。
第三步：验证与兜底修复
① 启动服务：openclaw gateway start。
② 立即验证：openclaw gateway status，输出必须含 active (running) 且无 error 字样。
③ 若仍失败，直取日志定位：tail -n 50 ~/.openclaw/logs/gateway.log，重点搜 ERR、token、bind 关键词。
④ 最终手段：手动注入远程令牌（仅当使用云端模型时需要）：openclaw config set gateway.remote.token "your_actual_token_here"，【此处必须填入有效且未过期的token，无效token会导致服务启动后秒退】。
执行完这一步，网关应恢复正常连接状态。
