OpenClaw本地部署后网关异常问题源于配置错误，只需精准修改端口、监听地址、模型路由及认证参数，或通过openclaw onboard向导生成配置，再经openclaw doctor验证无误后启动即可解决。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
OpenClaw本地部署完成后，网关无法响应请求、Dashboard打不开、模型调用报502或token missing——这些问题几乎都卡在配置环节。你不需要重装，只需精准修改几处关键参数，就能让网关真正跑起来。
确认配置文件位置并打开编辑
配置文件默认藏在~/.openclaw/目录下，可能是openclaw.json、config.yaml或.env，具体取决于你的安装方式和版本。用VS Code直接打开该目录最稳妥，避免记事本乱码或隐藏文件漏看。
如果不确定路径，运行openclaw config file命令，它会准确输出当前生效的配置文件绝对路径。
【注意：不要手动新建或复制配置文件，否则openclaw doctor可能无法识别】
用交互式向导快速生成可用配置
新手推荐走这条路径，避免手改出错：
第一步：执行openclaw onboard --install-daemon启动向导；
第二步：遇到安全警告时选Yes（这是正常提示，不是错误）；
第三步：按回车选择“快速启动”，向导会自动生成含基础端口、本地绑定、token认证的最小可行配置；
这一步做完，配置文件就已写入且格式正确，不用再手动补字段。
手动修改核心参数
老手或需定制化部署时，直接编辑配置文件：
方法一：端口与监听地址
找到gateway.port字段，改为未被占用的端口（如18789）；
将gateway.host设为127.0.0.1（仅本机访问）或0.0.0.0（局域网可访问）；
【必须确保host值与实际网络需求一致，填错会导致Dashboard根本打不开】
方法二：模型路由对齐
检查models数组里的每个id，再核对routes中引用的modelId——二者必须完全一致，包括大小写和连字符；
例如"id": "qwen2-7b"不能写成"qwen2:7b"或"Qwen2-7b"，否则路由失败直接返回404。
方法三：认证开关
开发调试时可临时设auth.mode: "none"，但生产环境务必启用auth.mode: "token"并配好auth.token值；
token建议用openssl rand -hex 32生成，别用简单字符串。
验证配置并启动网关
改完配置后，立刻执行健康检查：openclaw doctor；
如果有报错，它会明确指出哪一行、哪个字段有问题，比如“missing required field models”或“port already in use”；
修复所有报错后，运行openclaw gateway start启动服务；
再执行openclaw dashboard --no-open，拿到含#token=的完整URL；
把这串URL直接粘贴进浏览器地址栏，页面加载成功即表示网关配置完成。
