openclaw本地部署后gateway默认仅监听127.0.0.1:18789,需手动设为0.0.0.0并确认端口、模型id与路由严格匹配,否则局域网设备无法接入;推荐用openclaw config set gateway.host 0.0.0.0修改。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

OpenClaw本地部署后,Gateway服务默认可能未启动或监听范围受限,导致前端无法连接、模型调用失败、局域网设备无法接入,必须手动确认端口、绑定地址与模型路由三者严格匹配才能正常通信。
确认Gateway是否已运行
打开终端(PowerShell / Terminal),执行:
openclaw gateway status
若返回 【Gateway offline】 或命令未识别,说明Gateway未安装或PATH未生效——此时不能直接改配置,必须先运行 openclaw onboard 或 openclaw gateway install 完成初始化。
返回 green OK 但状态为 “not ready”:说明服务进程存在,但核心依赖(如模型服务、认证模块)尚未加载完成,需等待30秒再重查。
修改Gateway监听地址与端口
Gateway默认只绑定 127.0.0.1:18789,这意味着仅本机浏览器能访问。想让手机、另一台电脑通过局域网访问,必须放开绑定地址。
方法一:用CLI快速设置(推荐)
openclaw config set gateway.host 0.0.0.0 → openclaw config set gateway.port 18789
PHP中文网提供Qwen-1.0.2.6 MacOS官方客户端下载,专为苹果电脑优化的阿里通义千问桌面应用。本版本深度适配Mac系统,支持本地高效运行与多模态交互,集成超长上下文处理、AI写作、代码生成及智能体构建等核心功能。通过官方渠道下载,确保安全稳定,助您实现智能办公与创作升级。
方法二:手动编辑配置文件
用VS Code打开 ~/.openclaw/config.yaml,找到 gateway 节点,将 host 改为 "0.0.0.0",port 改为你需要的值(如 3000)。【注意:host 值必须带英文双引号,否则YAML解析失败】
改完立刻生效,无需重启——OpenClaw支持热重载配置。但若修改后仍连不上,检查Windows防火墙是否放行该端口。
配置模型路由与认证模式
第一步:确认 models 数组中模型ID拼写完全一致
例如你填了 model: "qwen2.5-7b",那么 routes 下对应项的 model 字段也必须是 qwen2.5-7b,大小写、点号、连字符一个都不能错。
第二步:设置 auth.token(生产环境强制要求)
在 .env 文件里添加 AUTH_TOKEN=your_secure_token_here;若本地调试临时禁用,设 AUTH_ENABLED=false ——但【禁用后务必关闭防火墙外网暴露,否则任何人可直连你的AI执行任意系统命令】
第三步:验证路由是否注册成功
启动后访问 http://localhost:18789/routes,页面应列出全部可用模型路径。如果为空,说明 models 和 routes 的 model 字段不匹配,或模型服务本身未启动。









