openclaw端口冲突导致502错误本质是目标端口被占用致连接失败，需用root权限查杀冲突进程或修改配置端口并同步更新nginx proxy_pass，最后通过systemctl状态、curl连通性及nginx错误日志三步验证修复效果。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
OpenClaw端口冲突导致502错误，本质是Nginx反向代理尝试连接后端服务时，因目标端口被其他进程占用而无法建立有效连接，日志中通常出现“connect() failed (111: Connection refused)”或“Address already in use”提示。
确认冲突端口与占用进程
执行 sudo ss -tlnp | grep ':8080'（将8080替换为OpenClaw实际配置的监听端口），查看是否已有进程绑定该端口。若输出非空，第一列PID后的程序名即为冲突源。
若无权限查看进程名，改用 sudo lsof -i :8080；若命令不存在，先运行 sudo yum install -y lsof（CentOS/RHEL）或 sudo apt install -y lsof（Ubuntu/Debian）。
【关键前提】必须使用root权限执行上述命令，普通用户无法读取其他进程的监听信息。
释放被占端口或迁移OpenClaw服务
方法一：终止占用进程
记下上一步查出的PID，执行 sudo kill -9 PID 强制结束。再检查端口是否已释放：ss -tln | grep ':8080' 应无输出。
本次更新实现飞书插件 npm 独立分发，新增 Ollama 本地模型配置及 openclaw 命令别名。引入 SQLite 持久化队列，支持断点续传。全面集成飞书、钉钉、企业微信及 QQ 官方渠道，优化阿里云百炼模型选择。修复多 Agent 路由、定时任务校验及配对授权等关键问题，提升系统稳定性与兼容性。
方法二：修改OpenClaw后端监听端口
编辑OpenClaw服务配置文件（常见路径如 /opt/openclaw/config.yaml 或 /etc/openclaw/settings.py），找到 port: 或 SERVER_PORT 字段，改为未被占用的端口（如8081）。保存后重启服务：sudo systemctl restart openclaw。
方法三：调整Nginx proxy_pass指向新端口
进入Nginx站点配置（如 /etc/nginx/conf.d/openclaw.conf），将 proxy_pass http://127.0.0.1:8080; 中的8080同步改为新端口，然后执行 sudo nginx -t && sudo nginx -s reload。
验证Nginx与后端连通性
第一步：确认OpenClaw服务进程已运行
执行 sudo systemctl status openclaw，状态必须为 active (running) 且无红色错误提示。
第二步：测试本地HTTP连通性
运行 curl -I http://127.0.0.1:8081（端口号与上一步一致），成功应返回 HTTP/1.1 200 OK 或类似健康响应头。若返回 Connection refused，说明服务未监听或配置未生效。
第三步：检查Nginx错误日志定位残留问题
执行 sudo tail -20 /var/log/nginx/error.log，重点搜索 upstream connect、connection refused 或 timeout 字样。日志无新报错且浏览器访问恢复正常，即完成修复。
