OpenClaw容器因3000端口被占而反复重启，需先用ss和docker ps排查占用进程，再kill或stop冲突实例；接着修改docker-compose.yml端口映射（如改3001或动态分配），或移除ports改用自定义网络；最后执行docker update禁用自动重启并查真实日志定位根因。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
OpenClaw容器启动后反复重启，日志里持续出现“port is already allocated”或“Bind for 0.0.0.0:3000 failed”，说明宿主机端口被占且容器因健康检查失败触发自动重启循环。
确认端口是否真被占用
先验证3000端口是否确实被其他进程持有，而不是Docker残留状态：
执行 ss -tuln | grep :3000，若输出非空，记下PID；若无输出，再运行 docker ps --format "table {{.Names}}\t{{.Ports}}" | grep 3000 查是否有其他容器悄悄映射了该端口。
注意：某些系统（如Ubuntu）可能有 【sshd.socket】 占用22端口的同类机制，但3000端口不会受其影响——此处仅提醒你别混淆排查对象。
终止冲突进程或容器
若 ss 命令返回了PID（例如 12345），直接杀掉：sudo kill -9 12345。
若发现是另一个OpenClaw容器在运行，用 docker stop $(docker ps -q --filter ancestor=openhands/openclaw) 批量停止所有OpenClaw实例，避免漏掉后台静默运行的副本。
这一步操作起来很简单，直接把文件拖进去就行。
修改端口映射并重启
方法一：临时改端口（适合快速验证）
编辑 docker-compose.yml，将 - "3000:3000" 改为 - "3001:3000"，保存后执行 docker-compose down → docker-compose up -d。
方法二：动态端口分配（推荐开发环境）
OpenClaw专家 — 用于任何OpenClaw问题或需求，包括配置错误、网关崩溃、网关未启动、斜杠指令、频道路由等。
把端口配置改成 - "3000"（只写容器端口），Docker会自动分配一个高位空闲端口；启动后用 docker-compose port openclaw 3000 查看实际映射值。
方法三：彻底移除端口暴露（仅限内部调用场景）
删掉 ports: 区块，改用 networks: + 自定义bridge网络，让其他容器通过服务名 openclaw:3000 访问，完全绕过宿主机端口争抢。
防止重启循环的紧急干预
第一步：停止自动重启行为
执行 docker update --restart=no openclaw_container_name，立即切断无限重启链条。
第二步：查看真实错误原因
运行 docker logs openclaw_container_name --tail 50，重点找最后一段报错——此时看到的才是原始失败原因，不是重启掩盖后的假象。
第三步：清理残留网络资源
有时旧容器退出后iptables规则未清除，导致新容器无法绑定端口。运行 sudo iptables -t nat -L | grep 3000，若发现残留规则，用 sudo iptables -t nat -F 清空NAT表（【此操作会影响所有Docker端口映射，请确保无其他关键容器正在运行】）。
