OpenClaw默认端口修改与防火墙配置解决冲突指南

启动OpenClaw时遇到“EADDRINUSE: address already in use”错误，或者浏览器提示“连接被拒绝”？这通常意味着两个核心问题：一是默认的18789端口已被其他应用程序占用，二是系统防火墙或安全策略阻止了该端口的网络通信。别担心，这是部署OpenClaw时的常见问题，解决路径非常清晰。本文将为你提供一套完整的排查与修复方案，帮助你快速恢复服务。

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

这是最直接的解决方案——释放被占用的端口资源。该方法适用于确认端口被非关键应用（如测试程序、残留进程）占用的情况。操作前请务必核对进程信息，避免误终止重要的系统服务或数据库连接。

首先，以管理员身份打开Windows PowerShell或命令提示符(CMD)，输入端口检测命令：netstat -ano | findstr :18789。

命令执行后，观察输出结果的最后一列数字，即进程标识符(PID)。

接下来，执行强制终止进程命令：taskkill /F /PID [PID]。请将[PID]替换为你查询到的实际进程ID。

最后，验证端口是否成功释放。再次运行netstat -ano | findstr :18789，若命令行无任何输出，则表明端口18789已处于空闲状态，可供OpenClaw使用。

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

如果无法终止占用进程，或希望永久变更服务端口以避免未来冲突，修改OpenClaw的默认监听端口是最佳选择。通过调整配置文件，可以实现服务启动时自动绑定新端口，特别适合生产环境部署、多实例运行或规避特定端口扫描。修改前强烈建议备份原始配置文件。

第一步，定位OpenClaw的主配置文件。通常位于以下路径：~/.openclaw/config.yaml（Linux或macOS系统）或%USERPROFILE%\.openclaw\config.yaml（Windows系统）。

使用记事本、VS Code等文本编辑器打开该文件，找到gateway:配置节点，其下应包含port:字段。

将原有值18789修改为一个未被占用的新端口号，例如30089或42100。请注意，端口号需在1024至65535之间，并避开80、443、3306等常见服务端口。

保存配置文件，然后执行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部署在阿里云、腾讯云、AWS等公有云服务器上，还需检查最后一道网络屏障——云安全组。安全组是云服务商提供的虚拟防火墙，规则未配置正确，所有外部请求将在抵达服务器前被拦截。

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

在实例详情页找到“安全组”配置选项，进入规则管理界面。

选择“入方向”规则，点击“添加规则”。关键配置信息如下：协议类型：选择TCP；端口范围：填写28089（或你实际使用的端口）；授权对象：可设置为0.0.0.0/0（允许所有IP访问，测试用），或根据最小权限原则设置为特定IP段以提升安全性。

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

遵循以上五个步骤，从端口冲突排查、服务配置调整，到系统防火墙与云安全组设置，你已全面打通OpenClaw服务的网络访问通道。按顺序逐一检查，即可高效解决OpenClaw启动与连接问题。