为保障openclaw ai远程访问稳定,需为其宿主机配置静态ip:一、识别网络接口与网段;二、linux用netplan或nmtui配置;三、windows通过网络属性设置;四、macos在系统设置中手动配置;五、验证监听并放行18789端口。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您已成功部署 OpenClaw AI,但其运行所在的主机(Windows / macOS / Linux)使用的是动态获取的 IP 地址,则每次网络重连后 Web UI 访问地址(如 http://192.168.x.x:18789)可能变化,导致远程访问中断或飞书/钉钉等通道配对失效。以下是为 OpenClaw 所在宿主系统设置静态 IP 的具体操作步骤:
一、确认当前网络接口名称与网段信息
设置静态 IP 前,需准确识别目标网络接口(如 eth0、ens33、Wi-Fi、以太网)及其所在子网范围,避免配置冲突或断网。不同系统获取方式如下:
1、在 Linux 系统中执行:ip -c addr show,查找处于 UP 状态的接口及当前 inet 行中的 IPv4 地址与掩码(如 192.168.1.100/24)。
2、在 Windows 系统中执行:ipconfig /all,查找“以太网适配器”或“无线局域网适配器”下的 IPv4 地址、子网掩码、默认网关和 DNS 服务器。
3、在 macOS 系统中执行:ifconfig | grep "inet " | grep -v 127.0.0.1,结合系统偏好设置→网络中对应服务的详细信息确认网关与 DNS。
二、Linux 系统设置静态 IP(以 Ubuntu/Debian 和 CentOS/RHEL 为例)
OpenClaw 常部署于 Linux 服务器,静态 IP 配置需修改网络管理服务所用的配置文件,确保重启后持久生效。
1、对于使用 Netplan(Ubuntu 18.04+、Debian 11+)的系统:编辑配置文件,通常位于 /etc/netplan/*.yaml,用 sudo 权限打开。
2、将原 DHCP 配置替换为静态配置,示例内容如下(请按实际网段修改 addresses、gateway4、nameservers):
3、执行 sudo netplan apply 应用变更,随后运行 ip a 确认新 IP 已生效且无重复地址冲突。
4、对于使用 NetworkManager 或传统 ifconfig 的系统(如 CentOS 7),可执行:nmtui 进入图形化界面,选择对应连接→Edit→IPv4 Configuration→Manual,填入地址、掩码、网关、DNS,保存并 Activate。
三、Windows 系统设置静态 IP
Windows 下静态 IP 配置通过图形界面或 PowerShell 完成,无需重启,适用于运行 OpenClaw 的 Windows 主机或 WSL2 宿主环境。
1、右键任务栏网络图标 → “打开网络和 Internet 设置” → “更改适配器选项”。
2、右键目标网络连接(如“以太网”或“WLAN”)→ “属性” → 双击“Internet 协议版本 4 (TCP/IPv4)”。
3、勾选“使用下面的 IP 地址”,输入:IP 地址(如 192.168.1.150)、子网掩码(如 255.255.255.0)、默认网关(如 192.168.1.1)。
4、勾选“使用下面的 DNS 服务器地址”,填写首选 DNS(如 114.114.114.114)与备用 DNS(如 8.8.8.8)。
5、点击“确定”保存,执行 ipconfig 验证新配置是否已加载。
四、macOS 系统设置静态 IP
macOS 使用图形化网络配置,静态 IP 设置后立即生效,适用于本地开发或 Mac Mini 部署场景。
1、打开“系统设置” → “网络”,在左侧列表中选择当前活跃连接(如“Wi-Fi”或“以太网”)。
2、点击右下角“详情…” → 切换至“IPv4”标签页。
3、将“IPv4 地址”配置方式由“使用 DHCP”改为“手动”,填写:IP 地址、子网掩码、路由器(即网关)。
4、在“DNS”标签页中,点击“+”号添加 DNS 服务器地址,推荐输入 223.5.5.5 与 114.114.114.114。
5、点击“完成” → “应用”,系统将自动切换至新 IP 并保持网络连通。
五、验证 OpenClaw 服务绑定与防火墙放行
静态 IP 设置完成后,OpenClaw 默认仍监听 0.0.0.0:18789,但需确保其服务可被该 IP 访问,且系统防火墙未拦截端口。
1、检查 OpenClaw 是否正常监听:sudo lsof -i :18789(Linux/macOS)或 netstat -ano | findstr :18789(Windows)。
2、在 Linux 上放行端口:sudo ufw allow 18789(Ubuntu)或 sudo firewall-cmd --permanent --add-port=18789/tcp(CentOS/RHEL),随后重载规则。
3、在 Windows 上,进入“控制面板→Windows Defender 防火墙→高级设置”,新建入站规则,协议类型 TCP,端口号 18789,作用域设为“任何 IP 地址”。
4、从同一局域网内另一设备浏览器访问:http://[新静态IP]:18789,确认 Web UI 正常加载且 Token 登录可用。










