内网共享访问OpenClaw操作指南

作者:技术拾光

时间:2026-05-06

浏览:513

错误修复或者配置办法 背景 很多朋友初次部署 OpenClaw Gateway 时可能会遇到一个常见情况:它默认只监听本机回环地址(127.0.0.1)。这意味着,如果你试图从同一局域网内的另一台电脑或手机去访问,通常会直接吃个“闭门羹”。这份指南的目的,就是帮你一步步调整配置,让网关顺利对局域网内

文章目录

错误修复或者配置办法

背景

很多朋友初次部署 OpenClaw Gateway 时可能会遇到一个常见情况:它默认只监听本机回环地址(127.0.0.1)。这意味着,如果你试图从同一局域网内的另一台电脑或手机去访问,通常会直接吃个“闭门羹”。这份指南的目的,就是帮你一步步调整配置,让网关顺利对局域网内的其他设备敞开大门。

可解决的问题即过程中遇到的错误

在配置过程中,你大概率会碰到下面这几个“拦路虎”,别担心,它们都有对应的解法:

1. 局域网访问被拒:直接在浏览器输入运行 OpenClaw 那台电脑的内网 IP 地址,页面打不开,并提示“origin not allowed (open the Control UI from the gateway host or allow it in gateway.controlUi.allowedOrigins)”。这其实就是跨域访问被拒绝了。

2. HTTPS 要求:解决了第一个问题后,可能会又遇到新提示:“control ui requires device identity (use HTTPS or localhost secure context)”。这是系统在要求你必须通过 HTTPS 安全连接来访问控制界面。

3. 设备配对问题:配置好 HTTPS 后,满以为能打开了,结果却显示“pairing required”。这说明新设备需要先获得授权,才能建立连接。

4. 授权后依然无法访问:有时候,即便完成了授权,可能由于缓存或配置未完全生效,访问依旧不成功。这种情况通常需要检查配置或重启服务。

剩下的缺点

需要提前说明的是,完成以下配置后,会有一个功能上的折损:**OpenClaw Browser Relay 将无法使用**。原因是 Browser Relay 目前并不支持 HTTPS 协议。这一点需要在规划使用时纳入考量。

步骤 1:修改网关绑定模式为局域网

首先,我们需要修改核心配置文件,告诉网关允许监听局域网地址并启用 HTTPS。手动编辑 ~/.openclaw/openclaw.json 文件,找到 gateway 配置段,关键修改点已加粗:

"gateway": {
    "port": 18789,
    "mode": "local",
    "bind": "lan",
    "controlUi": {
      "allowedOrigins": [
        "https://内网ip地址:18789",
        "http://localhost:18789",
        "http://127.0.0.1:18789"
      ]
    },
    "tls": {
      "enabled": true,
      "autoGenerate": true,
      "allowHttp": true
    }
  },

这里有几个要点:将 bind 改为 "lan" 是允许绑定局域网 IP 的关键;在 allowedOrigins 中添加你计划使用的内网 HTTPS 地址;同时启用 tls 以自动生成证书,并设置 allowHttp: true 确保本地回环的 HTTP 访问依然可用。

步骤 2:允许内网设备访问控制面板

配置文件改好后,接下来需要对试图访问的新设备进行授权。这需要用到两个命令:

  1. 执行 openclaw devices list
    这个命令会列出所有已识别(无论是否已配对)的设备,你可以从中找到那个状态为“未配对”的设备ID。
  2. 执行 openclaw devices approve [DeviceID]
    将上一步查到的目标设备ID替换掉 [DeviceID],运行此命令即可完成授权批准。

步骤 3:重启网关使配置生效

所有配置和授权操作完成后,必须重启网关服务,让改动生效。执行以下命令:

openclaw gateway restart

重启完成后,就可以在局域网内的其他设备上,使用 https://内网ip地址:18789 这个地址进行访问了。首次访问时,浏览器可能会提示证书不安全(因为是自签名证书),选择“继续前往”或“接受风险”即可,随后输入密钥,就能成功打开控制面板了。

实用工具推荐

电子包浆

绿化、压缩、噪点和虚拟水印,自由调节做旧程度。

使用 ›
图片压缩

选择画质和输出格式,预览压缩前后的大小。

使用 ›