OpenClaw端口冲突如何修改Docker端口？

OpenClaw启动时端口被占用需手动修改映射端口：先用netstat或lsof查占用进程，避免kill dockerd；再修改docker-compose.yml中ports配置（如改为"8081:8080"），执行docker-compose down && up -d重建容器；调试时可用docker run -p覆盖或sudo fuser -k释放端口。

OpenClaw启动时提示端口被占用，Docker容器无法绑定默认的8080或3000端口，必须手动修改映射端口才能正常运行。

确认当前端口占用情况

在宿主机终端执行 netstat -tuln | grep :8080 或 lsof -i :8080，查出哪个进程占用了目标端口。若返回为空，说明该端口未被占用，问题可能出在 Docker Compose 配置或容器重启残留上。

如果看到类似 LISTEN 状态的 PID，用 kill -9 [PID] 强制终止——但【切勿直接 kill Docker daemon 进程（如 dockerd）】，否则整个容器环境会瘫痪。

修改 docker-compose.yml 中的端口映射

打开 OpenClaw 项目根目录下的 docker-compose.yml 文件。

定位到 services → openclaw → ports 区块，原始配置通常类似：

- "8080:8080" 或 - "3000:3000"

将左侧宿主机端口改为未被占用的可用端口，例如改成 - "8081:8080"，表示把容器内 8080 映射到宿主机 8081；也可改用 8000、9000 等常见空闲端口。

保存文件后，在同一目录下执行 docker-compose down && docker-compose up -d 重建容器。这一步必须先停掉旧容器，否则新端口不会生效。

临时跳过端口检查快速启动（仅调试用）

方法一：用命令行覆盖端口映射

执行 docker run -p 8082:8080 -v $(pwd)/config:/app/config -it --rm openclaw:latest，其中 -p 8082:8080 直接指定新映射，不依赖 compose 文件。

方法二：强制释放被占端口（Linux/macOS）

运行 sudo fuser -k 8080/tcp 可一键杀掉所有占用 8080 TCP 的进程——【此操作无确认提示，会直接中断正在使用该端口的服务】。