Docker Compose 启动失败：容器反复重启或退出

症状

运行 docker-compose up -d 后容器立即退出或反复重启：

openclaw-gateway exited with code 1
openclaw-gateway | Error: Cannot find module...

原因

常见原因：

1. 挂载目录权限不对 — 容器内进程无法读写宿主机目录
2. 配置文件缺失 — 没有运行 openclaw onboard 初始化
3. 端口冲突 — 18789 或 3000 被其他容器占用

解法

方案一：修复目录权限

# 确保挂载目录存在且有权限
mkdir -p ~/.openclaw ~/openclaw/workspace
chmod -R 755 ~/.openclaw ~/openclaw/workspace

在 docker-compose.yml 中添加 user：

services:
  openclaw:
    user: "1000:1000"
    volumes:
      - ~/.openclaw:/root/.openclaw
      - ~/openclaw/workspace:/workspace

方案二：查看容器日志

docker-compose logs openclaw-gateway
# 根据具体错误信息排查

方案三：完全重建

docker-compose down -v
docker-compose pull
docker-compose up -d

验证修复

docker-compose ps
# 应显示 Status: Up