openclaw端口冲突会导致服务启动失败、web界面无法访问或api请求超时，需先定位冲突进程（如sudo lsof -i :8080），再同步修改配置文件、docker参数或.env变量，并更新nginx代理、证书验证及客户端访问地址。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
OpenClaw端口冲突会导致服务启动失败、Web界面无法访问或API请求超时，尤其在Docker容器复用宿主机22/80/443端口、或与Nginx/SSH/Gitea共存时高频发生。必须先确认冲突源再迁移，不能直接改配置硬重启。
第一步：定位真实冲突进程
执行命令查谁占着目标端口（以常见冲突端口8080为例）：
【必须用sudo执行，否则可能漏掉root进程】 sudo lsof -i :8080 2>/dev/null || sudo netstat -tuln | grep :8080
若输出为空，说明端口未被占用——此时不是端口冲突，而是OpenClaw自身未监听；若返回类似 node 12345 user 27u IPv6 1234567 0t0 TCP *:http-alt (LISTEN)，记下PID（本例为12345）和程序名（node），这就是真凶。
杀掉冲突进程：sudo kill -9 12345。注意：如果是systemd服务（如nginx），应改用sudo systemctl stop nginx而非kill，避免残留socket。
本次更新实现飞书插件 npm 独立分发，新增 Ollama 本地模型配置及 openclaw 命令别名。引入 SQLite 持久化队列，支持断点续传。全面集成飞书、钉钉、企业微信及 QQ 官方渠道，优化阿里云百炼模型选择。修复多 Agent 路由、定时任务校验及配对授权等关键问题，提升系统稳定性与兼容性。
第二步：修改OpenClaw服务端口配置
OpenClaw的端口定义分散在多个位置，需全部同步修改，否则前端连不上后端或反向代理失效：
方法一：修改主配置文件（适用于源码部署）
编辑config.yaml或settings.json，找到server.port字段，改成未被占用的端口（推荐8081–8999区间）：
server:<br> port: 8081
方法二：Docker环境强制指定（适用于容器化部署）
在docker run命令中加入-p 8081:8081，同时覆盖容器内环境变量：docker run -e SERVER_PORT=8081 -p 8081:8081 openclaw/app
【SERVER_PORT必须与-p后的容器端口一致，否则容器内应用监听错端口】
方法三：通过.env文件注入（适用于Docker Compose）
在.env中写SERVER_PORT=8081，再确保docker-compose.yml里service的environment块引用了它：
environment:<br> - SERVER_PORT=${SERVER_PORT}
第三步：检查并更新依赖链路
① 若OpenClaw前端通过Nginx反向代理访问，必须同步改Nginx配置：
编辑/etc/nginx/conf.d/openclaw.conf，把proxy_pass http://127.0.0.1:8080改为proxy_pass http://127.0.0.1:8081，然后sudo nginx -t && sudo systemctl reload nginx。
② 若使用HTTPS证书（Let’s Encrypt），acme.sh或certbot的域名验证路径不变，但HTTP验证端口需匹配新端口——检查acme.sh --issue命令中是否硬编码了--httpport 8080，如有则替换为--httpport 8081。
③ 若客户端（如浏览器书签、curl脚本、Postman集合）硬编码了:8080，需批量替换为新端口。这一步不做，用户访问会直接报ERR_CONNECTION_REFUSED。
重启OpenClaw服务：sudo systemctl restart openclaw（systemd）或docker-compose up -d（Compose）。
