openclaw端口配置失效需按顺序排查：先用--show-config-path确认真实配置路径，再检查启动脚本是否硬编码端口，接着验证环境变量是否覆盖，最后排查windows服务双重监听问题。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
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。
本次更新实现飞书插件 npm 独立分发，新增 Ollama 本地模型配置及 openclaw 命令别名。引入 SQLite 持久化队列，支持断点续传。全面集成飞书、钉钉、企业微信及 QQ 官方渠道，优化阿里云百炼模型选择。修复多 Agent 路由、定时任务校验及配对授权等关键问题，提升系统稳定性与兼容性。
验证配置是否被环境变量覆盖
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，观察是否成功。
若成功，说明之前是服务实例占着端口没释放。后续要么禁用服务，要么统一用服务方式管理并只改服务配置。
