OpenClaw Docker启动失败或无法访问的端口冲突需系统排查：先检查宿主机端口占用（lsof/netstat），再查所有容器（含已停止）的端口映射（docker ps -a），最后验证OpenClaw自身配置（inspect或docker-compose.yml），并清理残留绑定。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
排查OpenClaw服务在Docker中因端口映射冲突导致启动失败或无法访问的问题，需系统性验证宿主机端口占用、运行中容器端口分配、已停止容器残留绑定以及OpenClaw自身配置是否重叠。不能只看docker ps，因为已退出但未清理的容器仍可能持有端口映射规则。
检查宿主机是否已有进程占用了OpenClaw目标端口
执行 sudo lsof -i :3000（将3000替换为OpenClaw实际配置的宿主机端口，如未改则默认是3000）。若返回结果含PID和COMMAND，说明该端口正被非Docker进程（如node、python、另一个OpenClaw实例）独占。
若无输出，再运行 sudo netstat -tulnp | grep :3000 二次确认——【lsof有时因权限漏报，netstat可补盲】。
若两个命令都无结果，说明宿主机层面该端口空闲，冲突源一定来自Docker内部。
列出所有Docker容器（含已停止）并筛选端口映射
运行 docker ps -a --format "table {{.Names}}\t{{.Status}}\t{{.Ports}}" | grep -E "(3000|:3000)"。这一步必须加 -a 参数，否则会遗漏已退出但未删除的容器——它们的端口映射规则仍在iptables中生效，会导致新容器启动时提示“port is already allocated”。
若发现名称含 openclaw 或状态为 Exited 却仍显示 0.0.0.0:3000->3000/tcp 的条目，立即执行 docker rm 容器名或ID 彻底清除残留绑定。
验证OpenClaw容器的实际端口映射配置
方法一：查看正在运行的OpenClaw容器网络详情
执行 docker inspect openclaw | jq '.[0].NetworkSettings.Ports."3000/tcp"[0].HostPort'（需安装jq），直接提取宿主机映射端口号。若报错或返回null，说明容器未用-p参数暴露3000端口，或是映射到了其他端口（比如写成了 -p 8080:3000）。
方法二：检查docker-compose.yml中的ports字段
打开OpenClaw项目根目录下的 docker-compose.yml，定位到openclaw服务块，确认 ports: 下是否写为 - "3000:3000"。若写成 - "3000"（仅容器端口），Docker会随机分配宿主机端口，此时必须用 docker-compose port openclaw 3000 查实际映射值，不能假定是3000。
批量扫描全部容器的端口占用情况
第一步：获取所有容器ID列表docker ps -aq
第二步：对每个ID执行端口提取并过滤3000相关行for id in $(docker ps -aq); do echo "== $id =="; docker inspect $id 2>/dev/null | grep -A 5 "Ports" | grep -E "(3000|HostPort|3000/tcp)"; done | grep -B1 -A1 "3000"
这串命令会暴露出所有容器（无论运行或停止）中与3000相关的端口绑定记录，包括隐藏在复杂JSON结构里的HostPort字段。一旦发现重复HostPort值，就锁定冲突容器ID。
第三步：停用并删除冲突容器docker stop 冲突ID && docker rm 冲突ID
