openclaw启动失败因端口被占，需先查配置文件确认监听端口，再用ss/lsof检查占用情况，最后杀进程或改配置为未占用端口并重启服务。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
OpenClaw在云服务器上启动失败、服务无法访问或日志报“Address already in use”错误，通常是因为其默认监听的端口（如8080、3000或22）已被其他进程占用。必须定位冲突进程并释放端口，否则OpenClaw将拒绝绑定并退出。
确认OpenClaw实际监听端口
打开OpenClaw配置文件（常见路径：/opt/openclaw/config.yaml 或 ~/.openclaw/config.toml），查找类似 http_port、port、listen_port 或 ssh_port 的字段。注意：不同版本配置项名称不一致，不要凭经验跳过这步——【若直接改系统端口却没同步改OpenClaw配置，服务仍会尝试绑定原端口并失败】。
运行 grep -n "port" /opt/openclaw/config.yaml 2>/dev/null || grep -n "listen" ~/.openclaw/config.toml 2>/dev/null 快速定位。
检查目标端口是否被占用
假设配置中指定端口为8080，执行：
sudo ss -tuln | grep ':8080'
若输出非空，说明端口正被占用；若无输出，继续检查防火墙是否拦截（sudo ufw status 或 sudo iptables -L -n | grep 8080）。注意：云服务器厂商控制台（如阿里云安全组、腾讯云网络ACL）可能单独封锁该端口，需同步放行。
终止占用进程或更换OpenClaw端口
方法一：杀掉冲突进程（适用于临时调试）
发布后文档同步技能，自动将 README/ARCHITECTURE/CONTRIBUTING/CLAUDE.md 与实际变更对齐，清理待办事项，完善变更记录。
① 获取占用进程PID：sudo lsof -i :8080 2>/dev/null | awk 'NR==2 {print $2}'
② 强制终止：sudo kill -9 PID号
③ 验证释放：sudo ss -tuln | grep ':8080' 应无输出
方法二：修改OpenClaw配置使用空闲端口（推荐长期部署）
编辑配置文件，将原端口值（如8080）改为一个未被占用的高位端口，例如31234。可用命令快速筛查：for p in {30000..32000}; do ss -tuln | grep ":$p" >/dev/null || echo "$p free"; break; done。改完后保存，重启OpenClaw服务：sudo systemctl restart openclaw。
方法三：若冲突来自系统级SSH（端口22），且OpenClaw需启用内置SSH模块，则必须停用系统openssh-server或将其移至其他端口——【切勿让OpenClaw与openssh-server共用22端口，二者无法共存】。
