OpenClaw端口冲突后配置不生效如何办？

OpenClaw端口配置失效需按顺序排查：先用--show-config-path确认真实配置路径，再检查启动脚本是否硬编码端口，接着验证环境变量是否覆盖，最后排查Windows服务双重监听问题。

OpenClaw启动时提示端口被占用或连接失败，但修改配置文件后仍无法生效，说明配置未被正确加载或存在多层覆盖。

确认OpenClaw实际加载的配置文件路径

OpenClaw默认不会读取任意位置的config.yaml，它有固定查找顺序：先检查当前工作目录下的config.yaml，再查~/.openclaw/config.yaml，最后 fallback 到安装目录内置配置。直接在桌面新建一个config.yaml是无效的。

打开终端，进入OpenClaw可执行文件所在目录（不是你双击启动的快捷方式目录），运行：./openclaw --show-config-path → 查看输出的真实配置路径。

【必须用该命令输出的路径编辑，否则改了也白改】

检查端口是否被硬编码在启动脚本中

某些Windows/Linux打包版本会把端口写死在shell脚本或bat文件里，绕过config.yaml。

方法一：查看启动脚本内容

Linux/macOS：用cat $(which openclaw)或head -n 20 /path/to/openclaw；Windows：右键快捷方式→“属性”→“目标”字段，看是否包含--port=2222之类参数。

方法二：启动时强制指定端口

终端中直接运行：openclaw --port 2223 → 若此时能启动且端口可用，证明原配置被忽略，问题出在启动入口而非config.yaml。

验证配置是否被环境变量覆盖

OpenClaw支持通过环境变量覆盖配置项，优先级高于config.yaml。

第一步：检查是否有OPENCLAW_PORT变量

Linux/macOS运行：env | grep -i openclaw；Windows运行：set | findstr /i openclaw。

第二步：若输出含OPENCLAW_PORT=22，说明环境变量正在强行锁定端口。

临时清除：Linux/macOS执行unset OPENCLAW_PORT，Windows执行set OPENCLAW_PORT=（注意等号后无空格）。

第三步：重启OpenClaw验证。

排查Windows服务模式下的双重监听

如果OpenClaw以Windows服务方式安装（如通过openclaw install-service），它可能和前台进程同时运行，两个实例争夺同一端口。

① 打开任务管理器→“服务”选项卡→找到openclaw服务→右键→“停止”。

② 再打开“详细信息”选项卡→筛选所有名为openclaw.exe的进程→全部结束。

③ 此时再用命令行启动：openclaw --port 2224，观察是否成功。

若成功，说明之前是服务实例占着端口没释放。后续要么禁用服务，要么统一用服务方式管理并只改服务配置。