OpenClaw 局域网访问配置文档
OpenClaw 局域网访问配置文档
概述
本文档详细说明了如何配置 OpenClaw 以允许局域网内的其他设备访问，包括所有相关配置参数的作用和说明。
当前配置状态
网关服务信息
- 服务端口: 18789
- 绑定模式: lan (局域网访问)
- 认证方式: password (密码认证)
- 访问密码: xxxxxx
详细配置参数说明
1. 网关基础配置 (gateway)
1.1 端口配置 (gateway.port)
"port":18789参数作用:
- 指定 OpenClaw 网关服务监听的 TCP 端口号
- 该端口用于 Web 控制界面、API 接口和 WebSocket 连接
配置建议:
- 使用专用的端口号，避免与其他服务冲突
- 端口号范围: 1024-65535
- 如需修改，确保防火墙规则同步更新
当前值: 18789
1.2 运行模式 (gateway.mode)
"mode":"local"参数作用:
"local": 本地运行模式，channels 和 agent runtime 都在当前主机运行"remote": 远程模式，通过远程传输连接到另一个 runtime 主机
配置说明:
- 除非有特殊的多主机部署需求，否则保持
"local"即可 - 局域网访问配置不影响此参数的设置
当前值: local
1.3 绑定模式 (gateway.bind)
"bind":"lan"参数作用: 控制网关服务的网络绑定接口，决定了哪些网络可以访问
可选值:
"loopback": 仅绑定到 localhost (127.0.0.1)，只能本机访问"lan": 绑定到所有局域网接口，局域网内设备可以访问"auto": 自动选择合适的绑定方式"custom": 使用自定义绑定地址（需配合customBindHost参数）"tailnet": 通过 Tailscale 网络提供服务
配置说明:
- 关键参数: 局域网访问的核心配置
"lan"模式会绑定到主机的所有局域网网络接口- 配置为
"lan"后，局域网内的其他设备可以通过主机的 IP 地址访问
当前值: lan (已配置为允许局域网访问)
2. 认证配置 (gateway.auth)
2.1 认证模式 (gateway.auth.mode)
"mode":"password"参数作用: 指定网关的认证方式
可选值:
"none": 无需认证，任何人都可以访问（不安全，仅用于测试）"token": 使用 token 进行认证，token 每次重启可能变化"password": 使用固定密码进行认证，重启后密码保持不变"trusted-proxy": 信任上游代理提供的身份信息
配置说明:
- 推荐使用
"password"模式，因为：- 密码固定，重启服务后无需重新配置
- 局域网内所有设备可以使用同一密码访问
- 安全性比
"none"高，管理比"token"方便