根據(jù)OpenClaw最新官方文檔（截至2026年3月），以下是更新后的局域網(wǎng)訪問(wèn)配置指南，整合了網(wǎng)絡(luò)架構(gòu)、安全加固和自動(dòng)化配對(duì)等新特性：

一、核心配置命令（基于新版網(wǎng)關(guān)協(xié)議）

1. 啟用LAN多接口監(jiān)聽(tīng)
   使用新參數(shù) bind=lan 自動(dòng)綁定所有局域網(wǎng)接口（替代舊版 0.0.0.0）：

   openclaw config set gateway.bind lan

2. 智能本地配對(duì)策略
   新增自動(dòng)批準(zhǔn)本地連接（同主機(jī)或同一Tailnet內(nèi)設(shè)備）：

   openclaw config set gateway.pairing.autoApproveLocal true
   

3. 動(dòng)態(tài)認(rèn)證令牌管理
   生成帶時(shí)效性的Token（推薦每24小時(shí)輪換）：

   openclaw config set gateway.auth.token $(openclaw doctor --generate-tmp-token 86400)
   

4. 強(qiáng)化安全基線
   啟用TLS加密和嚴(yán)格的CORS策略：

   openclaw config set gateway.security.tls.enabled true
   openclaw config set gateway.http.corsAllowedOrigins "['https://*.yourdomain.com']"
   

二、高級(jí)網(wǎng)絡(luò)配置（文檔新增模塊）

1. Bonjour服務(wù)發(fā)現(xiàn)優(yōu)化
   自動(dòng)注冊(cè)mDNS服務(wù)名（默認(rèn) openclaw.local）：

   openclaw config set discovery.bonjour.enabled true
   

2. Tailscale集成（零配置內(nèi)網(wǎng)穿透）
   通過(guò)Tailnet ID自動(dòng)建立安全隧道：

   openclaw config set remoteAccess.tailnetId TAILNET_ID_FROM_TAILSCALE
   

3. 混合云部署支持
   配置混合傳輸協(xié)議（QUIC+WebSocket）：

   openclaw config set transport.mixedMode.enabled true
   

三、驗(yàn)證與調(diào)試流程（含新診斷工具）

1. 網(wǎng)關(guān)健康檢查
   使用新版診斷命令：

   openclaw doctor network --verbose
   

   關(guān)鍵指標(biāo)：Gateway API accessible at https://[LAN_IP]:18789

2. 跨設(shè)備訪問(wèn)測(cè)試
   在另一臺(tái)設(shè)備瀏覽器訪問(wèn)：

   https://openclaw.local:18789  # 優(yōu)先Bonjour解析
   或
   https://[LAN_IP]:18789

3. 故障排查命令
   新增網(wǎng)絡(luò)層專用排障工具：

   openclaw debug network-packet-capture
   openclaw debug connectivity-matrix
   

四、安全加固建議（基于MITRE ATLAS框架）

1. 最小權(quán)限原則
   限制網(wǎng)關(guān)進(jìn)程權(quán)限：

   sudo setcap cap_net_bind_service=+ep /usr/bin/openclaw-gateway
   

2. 持續(xù)監(jiān)控告警
   配置異常流量檢測(cè)規(guī)則：

   # 示例：在Prometheus配置中添加
   - alert: HighGatewayLatency
     expr: gateway_response_time_seconds > 5
     for: 1m
     labels:
       severity: warning

3. 物理層防護(hù)
   通過(guò)udev規(guī)則限制網(wǎng)卡綁定：

   echo 'SUBSYSTEM=="net", ACTION=="add", ATTR{address}=="XX:XX:XX:XX:XX:XX", RUN+="/sbin/ip link set $IFACE up mtu 1400"' | sudo tee /etc/udev/rules.d/99-openclaw.rules
   

五、版本兼容性矩陣

通過(guò)以上更新，OpenClaw局域網(wǎng)訪問(wèn)方案已實(shí)現(xiàn)：
? 零配置內(nèi)網(wǎng)穿透（Bonjour/Tailscale）
? 自動(dòng)化安全加固（TLS+RBAC）
? 生產(chǎn)級(jí)可觀測(cè)性（Prometheus集成）

建議立即升級(jí)至v2.2+版本以獲得完整功能集，并參考官方Security Hub獲取威脅情報(bào)更新。

遇到這個(gè)報(bào)錯(cuò)，說(shuō)明你已經(jīng)成功解決了跨域問(wèn)題，但撞上了 OpenClaw 另一道更硬核的安全防線——設(shè)備身份驗(yàn)證。

?? 為什么會(huì)報(bào)這個(gè)錯(cuò)？

OpenClaw 在 2026+ 版本 做了一個(gè)重要升級(jí)：Control UI 強(qiáng)制要求在 安全上下文（Secure Context） 中運(yùn)行。

什么是安全上下文？只有這兩種情況才算：

當(dāng)你用 http://IP:18789 訪問(wèn)時(shí)，瀏覽器會(huì)判定這是非安全上下文，直接屏蔽 Web Crypto API——而 OpenClaw 恰恰依賴這個(gè) API 來(lái)生成設(shè)備身份，做認(rèn)證配對(duì)。認(rèn)證做不了，網(wǎng)關(guān)只能無(wú)情拒絕你的連接。

?? 關(guān)鍵提醒：即使你配置了 allowInsecureAuth: true，也繞不過(guò)這一關(guān)！ 因?yàn)闉g覽器層面的限制是硬性的，不是網(wǎng)關(guān)能決定的。

??? 三種解決方案，按推薦程度排序

?? 方案一：SSH 隧道轉(zhuǎn)發(fā)（強(qiáng)烈推薦 ?）

這是最優(yōu)雅、最安全的方案，不需要改任何配置、不需要 SSL 證書(shū)，一行命令搞定。

原理：在你自己的電腦上建立一條 SSH 隧道，把遠(yuǎn)程服務(wù)器的 18789 端口"搬"到你本地，然后你用 localhost 訪問(wèn)——瀏覽器認(rèn)為是安全上下文，一切順理成章。

# 在本地終端執(zhí)行（Windows用PowerShell/WSL，Mac/Linux用Terminal）
ssh -L 18789:localhost:18789 username@服務(wù)器IP

舉個(gè)例子，如果你的樹(shù)莓派/服務(wù)器 IP 是 192.168.1.100，用戶名叫 pi：

ssh -L 18789:localhost:18789 pi@192.168.1.100

然后保持這個(gè)終端窗口不要關(guān)，在瀏覽器打開(kāi)：

http://127.0.0.1:18789/?token=你的Token

完美解決！

?? 不知道 Token？在服務(wù)器上運(yùn)行：

openclaw config get auth.token

?? 方案二：配置 HTTPS（適合固定域名訪問(wèn)）

如果你有域名并且想長(zhǎng)期穩(wěn)定地通過(guò)域名訪問(wèn)，這是最佳路徑。

最簡(jiǎn)單的方式是使用 Tailscale Serve（Tailscale 自帶的 HTTPS 反向代理功能），它會(huì)自動(dòng)幫你搞定 SSL 證書(shū)。

如果你有自己的域名和 SSL 證書(shū)，也可以在 Nginx/Caddy 等反向代理上配置 HTTPS，然后把網(wǎng)關(guān)綁定的 IP 加到 gateway.trustedProxies 中，讓 OpenClaw 正確識(shí)別真實(shí)客戶端 IP。

?? 方案三：暴力禁用設(shè)備身份驗(yàn)證（僅限緊急/測(cè)試場(chǎng)景 ??）

?? 這是一個(gè)嚴(yán)重的安全降級(jí)，官方明確警告不建議在生產(chǎn)環(huán)境使用。

修改 ~/.openclaw/openclaw.json 配置文件：

{
  "gateway": {
    "port": 18789,
    "bind": "lan",
    "controlUi": {
      "allowedOrigins": [
        "http://127.0.0.1:18789",
        "http://你的IP:18789"
      ],
      "allowInsecureAuth": true,
      "dangerouslyDisableDeviceAuth": true
    }
  }
}

保存后重啟網(wǎng)關(guān)：

openclaw gateway restart

這樣網(wǎng)關(guān)就不再檢查設(shè)備身份了，直接用 Token 認(rèn)證，瀏覽器也不會(huì)再攔你了。

?? 方案對(duì)比一覽

總結(jié)一句話：能用 SSH 隧道就用 SSH 隧道，既安全又省事；有域名就配 HTTPS；實(shí)在不行才考慮禁用設(shè)備認(rèn)證。千萬(wàn)別把 dangerouslyDisableDeviceAuth 開(kāi)著不管——官方的安全審計(jì)工具會(huì)專門(mén)檢測(cè)這個(gè)配置并報(bào)警告。

到此這篇關(guān)于OpenClaw局域網(wǎng)訪問(wèn)配置的實(shí)現(xiàn)的文章就介紹到這了,更多相關(guān)OpenClaw局域網(wǎng)訪問(wèn)內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

最新評(píng)論