一键docker部署Openclaw中文版

Docker Compose 部署指南

以下为经过验证的 OpenClaw 容器化部署配置方案。该 docker-compose.yml 文件采用经典的初始化与服务分离设计，逻辑严谨，能够确保应用配置在启动前正确生成，保障核心网关服务的稳定运行。

volumes:
  openclaw-data:

services:
  openclaw-init:
    image: ghcr.io/1186258278/openclaw-zh:latest
    container_name: openclaw-init
    volumes:
      - openclaw-data:/root/.openclaw
    env_file:
      - .env
    command: >
      sh -c "
      echo '[OpenClaw] init start';
      if [ -f /root/.openclaw/openclaw.json ] && [ \"$OPENCLAW_FORCE_INIT\" != \"true\" ]; then
        echo '[OpenClaw] config exists, skip init';
        exit 0;
      fi;
      if [ \"$OPENCLAW_FORCE_INIT\" = \"true\" ]; then
        echo '[OpenClaw] force init, removing old config';
        rm -f /root/.openclaw/openclaw.json;
      fi;
      openclaw setup --non-interactive;
      openclaw config set gateway.mode local;
      openclaw config set gateway.bind lan;
      openclaw config set gateway.auth.token \"$OPENCLAW_TOKEN\";
      echo '[OpenClaw] init done';
      "
    restart: "no"

  openclaw:
    image: ghcr.io/1186258278/openclaw-zh:latest
    container_name: openclaw
    depends_on:
      openclaw-init:
        condition: service_completed_successfully
    volumes:
      - openclaw-data:/root/.openclaw
    ports:
      - \"18789:18789\"
    command: [\"openclaw\", \"gateway\", \"run\", \"--allow-unconfigured\"]
    restart: unless-stopped

环境变量配置文件

.env 文件是整个 Docker Compose 部署的核心控制面板。其中定义的两个关键变量，直接掌控着 OpenClaw 的初始化流程与身份认证机制。

# OpenClaw 网关认证令牌
OPENCLAW_TOKEN=fgewsfewBhuusisdghjsohgjLB

# 是否强制重新初始化配置
# true = 每次执行 docker compose up 时都会重新运行设置与配置
# false = 仅首次部署时执行初始化
OPENCLAW_FORCE_INIT=false

这种将配置外置于环境变量的设计，实现了部署逻辑与具体敏感信息的解耦，显著提升了安全性和运维灵活性。您仅需在 .env 文件中修改 OPENCLAW_TOKEN 即可完成密钥轮换；而将 OPENCLAW_FORCE_INIT 设为 true 则能充当一个高效的重置开关，在需要彻底刷新或排错时一键重建应用配置。