更新OpenClaw.json配置实现局域网访问

2026-04-01 20:50 已关闭评论

🔧 方案 B：修改内容详单

今天我想和大家分享一个我最近遇到的真实需求：如何让我的OpenClaw助手在局域网内也能被访问。默认情况下，它只允许本机访问，但有时候，比如我想用手机上的浏览器来操作它，或者让同个WiFi下的平板也能调用它的语音功能，这就行不通了。经过一番摸索，我发现只需要修改一个配置文件里的关键参数就能搞定。下面我就把具体的操作步骤和我的经验分享给大家。

1. 修改目标文件

我们需要动刀的文件路径是：

C:\Users\teach\.openclaw\openclaw.json

这个文件通常在你的用户目录下的 .openclaw 文件夹里，它掌管着OpenClaw的核心配置。

2. 具体修改内容

修改的核心在于 gateway 配置项下的 bind 参数。让我来对比一下修改前后的区别。

当前配置（仅本地访问）：

"gateway": {
  "port": 18789,
  "mode": "local",
  "bind": "loopback",  // ← 只监听 127.0.0.1，局域网无法访问
  ...
}

看到那个 "loopback" 了吗？这就是问题的根源。它意味着服务只绑定在回环地址（127.0.0.1）上，所以只有你电脑本地的程序能连上它。

修改后（允许局域网访问）：

"gateway": {
  "port": 18789,
  "mode": "local", 
  "bind": "0.0.0.0",  // ← 监听所有网卡，局域网可访问
  ...
}

我们把 bind 的值从 "loopback" 改成 "0.0.0.0"。这个 "0.0.0.0" 是一个特殊的IP地址，它代表“监听本机所有可用的网络接口”。这样一来，服务不仅监听127.0.0.1，也监听你的有线网卡、无线网卡（WiFi）的IP地址，局域网内的其他设备自然就能发现了。

3. 修改后的效果

修改保存配置文件后，记得重启一下OpenClaw服务，让新配置生效。之后，访问方式就变得灵活多了：
- 电脑浏览器：http://localhost:18789 依然可以正常访问，和以前一样。
- 手机浏览器：输入 http://[你的电脑局域网IP]:18789（例如我的电脑IP是192.168.1.6，就是 http://192.168.1.6:18789）就可以成功访问了！✅
- 最棒的是，手机可以直接用语音输入和我的OpenClaw交互，体验瞬间提升。

4. 安全风险 ⚠️

在享受便利的同时，我们必须清醒地认识到开放网络访问带来的安全风险。这也是我决定分享这个方案时，觉得必须重点强调的部分。
- 同一局域网内的其他设备现在都能访问你的OpenClaw界面了。如果你的室友、家人也在同一个WiFi下，他们理论上可以通过浏览器连接到你的服务。
- 如果家里的WiFi密码被破解或者有人蹭网，那么这些未经授权的设备也可能尝试连接。不过，好在OpenClaw通常会有Token之类的身份验证机制，这算是一道防线。
- 风险最高的是公共WiFi环境，比如咖啡馆、机场。在这种环境下开启 "0.0.0.0" 绑定是非常危险的，因为和你连接在同一个热点下的陌生人都可能成为潜在的访问者。

所以，我的建议是：仅在可信任的私人局域网（如家庭或办公室内网）中使用此配置。