OpenClaw 局域网访问 Web 界面完整教程

🚀 OpenClaw 局域网访问 Web 界面完整教程

在默认情况下，OpenClaw 的 Web 管理界面通常只能在本机访问。如果你希望在局域网内其他设备（电脑 / 手机）访问管理后台，可以通过简单配置实现。

本教程将手把手教你完成配置 👇

📌 一、功能说明

配置完成后，你可以通过以下方式访问：

1
http://宿主机IP:18789

✔ 局域网任意设备访问
✔ 浏览器直接打开
✔ 通过密码登录管理

⚙️ 二、前置条件

在开始之前，请确保：

  • 已成功安装 OpenClaw
  • 网关（Gateway）可以正常运行
  • 知道当前机器的局域网 IP（如 192.168.1.100）

🧩 三、配置步骤

🔧 Step 1：修改 Gateway 配置

运行配置向导：

1
openclaw configure

按照如下方式选择👇

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
Where will the Gateway run?
→ Local (this machine)

Select sections to configure
→ Gateway

Gateway port
→ 18789

Gateway bind mode
→ LAN (All interfaces)

Gateway auth
→ Password

Tailscale exposure
→ Off

Gateway password
→ 自定义强密码（不要用123456）

⚠️ 重要提醒：
请务必设置复杂密码，避免被局域网他人访问！

🔧 Step 2：开放访问权限（关键）

编辑配置文件：

1
sudo nano ~/.openclaw/openclaw.json

找到 "controlUi"，修改为：

1
2
3
4
"controlUi": {
  "dangerouslyAllowHostHeaderOriginFallback": true,
  "dangerouslyDisableDeviceAuth": true
}

💡 说明：

参数 作用
dangerouslyAllowHostHeaderOriginFallback 允许跨主机访问
dangerouslyDisableDeviceAuth 关闭设备限制

保存后，Gateway 会自动重启。

✅ 四、验证是否成功

在局域网其他设备打开浏览器：

1
http://宿主机IP:18789

输入刚才设置的密码即可登录。

🛠 五、常用网关命令

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
# 安装服务
openclaw gateway install

# 启动服务
openclaw gateway start

# 停止服务
openclaw gateway stop

# 重启服务
openclaw gateway restart

# 卸载服务
openclaw gateway uninstall

# 查看状态
openclaw gateway status

❗ 六、常见问题排查

❓ 1. 无法访问 Web 页面？

请检查：

1
openclaw gateway status

确保服务为运行状态 ✅

同时确认：

  • 端口是否被防火墙拦截
  • IP 是否填写正确
  • 局域网设备是否在同一网段

❓ 2. 可以修改端口吗？

可以 👍

重新运行：

1
openclaw configure

修改：

1
Gateway port

⚠️ 修改后记得：

  • 防火墙放行新端口
  • 使用新端口访问

🔐 七、安全建议（强烈建议）

如果你用于生产环境：

  • 不要使用弱密码（如 123456）
  • 尽量限制局域网访问范围
  • 可以结合反向代理（Nginx）增加认证
  • 避免暴露到公网

🎯 总结

通过以上配置，你已经实现：

✅ OpenClaw Web UI 局域网访问
✅ 多设备管理
✅ 密码保护登录

这对于远程控制、团队协作、自动化运维非常实用 👍