OpenClaw端口冲突解决方案：修改默认端口与防火墙配置详解

遇到OpenClaw启动报错“EADDRINUSE”或浏览器显示连接被拒绝？这通常指向两个核心问题：默认的18789端口已被占用，或系统防火墙策略阻止了该端口的通信。遵循以下排查路径，可以快速定位并解决问题。

一、终止占用18789端口的进程

最直接的解决方案是释放被占用的端口。此方法适用于处理由非核心应用或OpenClaw自身残留进程导致的端口冲突。操作前请确认目标进程，避免误终止关键服务。

首先，在Windows PowerShell或CMD中执行端口扫描命令：netstat -ano | findstr :18789。

命令输出结果的最后一列数字即为进程标识符（PID）。

随后，使用强制终止命令：taskkill /F /PID [PID]。请将[PID]替换为实际查到的数字。

最后，验证端口是否成功释放。再次运行netstat -ano | findstr :18789，若无任何输出，则表明端口已可用。

二、修改OpenClaw监听端口（配置文件方式）

若无法终止占用进程，或需永久变更端口，修改配置文件是标准做法。此方式适用于生产环境部署、多实例运行或规避特定端口扫描。建议操作前备份原配置文件。

首先，定位OpenClaw主配置文件。典型路径为：~/.openclaw/config.yaml（Linux/macOS）或%USERPROFILE%\.openclaw\config.yaml（Windows）。

使用文本编辑器打开文件，找到gateway:配置段下的port:字段。

将原值18789修改为一个未被占用的新端口，例如30089。确保端口号在1024至65535之间，并避开系统预留端口。

保存修改后，执行openclaw restart命令使新配置生效。

三、使用命令行参数临时指定端口

对于临时测试或快速验证，通过命令行参数指定端口更为灵活。此变更仅对当前会话有效，服务重启后将恢复默认或配置文件中的设置。

首先，停止当前运行的OpenClaw实例：openclaw stop。

随后，携带端口参数重新启动网关服务：openclaw gateway --port 28089。此处的28089可替换为任意可用端口。

启动成功后，服务访问地址将变更为http://127.0.0.1:28089。

四、开放系统防火墙入站规则

端口配置无误后，若仍无法从外部访问，需检查系统防火墙设置。此步骤旨在防火墙中创建规则，允许指定端口的入站流量，对于服务器部署至关重要。

在Linux系统中，若使用firewalld，执行：sudo firewall-cmd --permanent --add-port=28089/tcp；若使用iptables，则执行：sudo iptables -A INPUT -p tcp --dport 28089 -j ACCEPT。

添加规则后，需重载防火墙配置：firewalld使用sudo firewall-cmd --reload；iptables则需执行sudo iptables-sa ve以保存规则。

在Windows系统中，通过“高级安全Windows Defender防火墙”管理界面操作：创建新的入站规则，选择“端口”类型，输入新端口号，设置为“允许连接”，并完成规则创建向导。

五、配置云平台安全组放行端口

若OpenClaw部署于公有云（如阿里云、腾讯云）服务器，还需配置云服务商的安全组规则。安全组作为虚拟防火墙，规则未放行将导致外部请求在抵达服务器前被丢弃。

登录云服务商控制台，进入目标云服务器ECS实例的管理页面。

点击实例详情旁的“安全组”配置入口，进入规则管理界面。

在“入方向”规则中，点击“添加规则”。关键配置如下：协议类型：TCP；端口范围：28089（请替换为实际端口）；授权对象：0.0.0.0/0（允许所有IP访问，或根据最小权限原则设置为特定IP段）。

保存规则。云平台安全组规则通常即时生效，无需重启服务器实例。

完成上述五个步骤的排查与配置，从端口资源释放到应用层、操作系统层及网络层的访问控制，即可系统性地解决OpenClaw的端口与连接问题。

来源：互联网