Docker 部署

生产环境推荐使用 Docker 部署 OpenClaw。

快速部署

git clone https://github.com/openclaw/openclaw.git
cd openclaw
./docker-setup.sh

使用预构建镜像

docker pull ghcr.io/openclaw/openclaw:latest

Docker Compose 配置

version: '3.8'

services:
  openclaw:
    image: ghcr.io/openclaw/openclaw:latest
    container_name: openclaw
    restart: unless-stopped
    ports:
      - "18789:18789"  # Gateway + Dashboard
    volumes:
      - openclaw-data:/root/.openclaw
    env_file:
      - .env
    environment:
      - NODE_ENV=production

volumes:
  openclaw-data:

环境变量文件

创建 .env：

# AI 模型 API Key
ANTHROPIC_API_KEY=sk-ant-xxx

# 或其他模型
# OPENAI_API_KEY=sk-xxx
# OPENROUTER_API_KEY=sk-or-xxx

启动

docker compose up -d

# 查看日志
docker compose logs -f openclaw

# 进入容器执行命令
docker exec -it openclaw openclaw doctor
docker exec -it openclaw openclaw channels list

配合反向代理

如果需要远程访问 Dashboard，配合 nginx 反向代理：

server {
    listen 443 ssl;
    server_name openclaw.example.com;

    ssl_certificate /path/to/cert.pem;
    ssl_certificate_key /path/to/key.pem;

    location / {
        proxy_pass http://127.0.0.1:18789;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
    }
}

更新

docker compose pull
docker compose up -d

数据备份

OpenClaw 数据存储在 Docker Volume 中：

# 备份
docker run --rm -v openclaw-data:/data -v $(pwd):/backup \
  alpine tar czf /backup/openclaw-backup.tar.gz -C /data .

# 恢复
docker run --rm -v openclaw-data:/data -v $(pwd):/backup \
  alpine tar xzf /backup/openclaw-backup.tar.gz -C /data