OpenClawSkills
GitHub
平台 • 5 分钟阅读

Hetzner

在便宜的 Hetzner VPS (Docker) 上 24/7 运行 OpenClaw Gateway，具有持久化状态和内置二进制文件

Tutorial.step

目标

在 Hetzner VPS 上使用 Docker 运行持久化的 OpenClaw Gateway，具有持久化状态、内置二进制文件和安全的重启行为。

如果您想要 "OpenClaw 24/7，约 $5"，这是最简单的可靠设置。

Hetzner 定价会变化；选择最小的 Debian/Ubuntu VPS，如果遇到 OOM 则升级。

Tutorial.step

我们要做什么（简单术语）？

- 租用一台小型 Linux 服务器（Hetzner VPS）

- 安装 Docker（隔离的应用运行时）

- 在 Docker 中启动 OpenClaw Gateway

- 在主机上持久化 ''~/.openclaw'' + ''~/.openclaw/workspace''（在重启/重建后保留）

- 通过 SSH 隧道从笔记本电脑访问控制 UI

Gateway 可以通过以下方式访问：

- 从笔记本电脑进行 SSH 端口转发

- 如果您自己管理防火墙和令牌，则直接暴露端口

本指南假设 Hetzner 上使用 Ubuntu 或 Debian。

如果您使用其他 Linux VPS，请相应地映射软件包。

对于通用 Docker 流程，请参阅 ''Docker''。

Tutorial.step

您需要什么

- 具有 root 访问权限的 Hetzner VPS

- 从笔记本电脑进行 SSH 访问

- 基本的 SSH + 复制/粘贴操作

- 约 20 分钟

- Docker 和 Docker Compose

- 模型认证凭据

- 可选的提供商凭据

- WhatsApp QR

- Telegram 机器人令牌

- Gmail OAuth

Tutorial.step

2）安装 Docker（在 VPS 上）

Bash
apt-get update
apt-get install -y git curl ca-certificates
curl -fsSL https://get.docker.com | sh

验证：

Bash
docker --version
docker compose version
Tutorial.step

4）创建持久化主机目录

Docker 容器是临时的。

所有长期状态必须存在于主机上。

Bash
mkdir -p /root/.openclaw
mkdir -p /root/.openclaw/workspace

chown -R 1000:1000 /root/.openclaw
chown -R 1000:1000 /root/.openclaw/workspace
Tutorial.step

6）Docker Compose 配置

创建或更新 ''docker-compose.yml''。

Yaml
services:
  openclaw-gateway:
    image: ${OPENCLAW_IMAGE}
    build: .
    restart: unless-stopped
    env_file:
      - .env
    environment:
      - HOME=/home/node
      - NODE_ENV=production
      - TERM=xterm-256color
      - OPENCLAW_GATEWAY_BIND=${OPENCLAW_GATEWAY_BIND}
      - OPENCLAW_GATEWAY_PORT=${OPENCLAW_GATEWAY_PORT}
      - OPENCLAW_GATEWAY_TOKEN=${OPENCLAW_GATEWAY_TOKEN}
      - GOG_KEYRING_PASSWORD=${GOG_KEYRING_PASSWORD}
      - XDG_CONFIG_HOME=${XDG_CONFIG_HOME}
      - PATH=/home/linuxbrew/.linuxbrew/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
    volumes:
      - ${OPENCLAW_CONFIG_DIR}:/home/node/.openclaw
      - ${OPENCLAW_WORKSPACE_DIR}:/home/node/.openclaw/workspace
    ports:
      # 推荐：在 VPS 上保持 Gateway 仅回环；通过 SSH 隧道访问。
      # 要公开暴露它，请删除 `127.0.0.1:` 前缀并相应地配置防火墙。
      - "127.0.0.1:${OPENCLAW_GATEWAY_PORT}:18789"

      # 可选：仅当您针对此 VPS 运行 iOS/Android 节点并需要 Canvas 主机时。
      # 如果您公开暴露它，请阅读 /gateway/security 并相应地配置防火墙。
      # - "18793:18793"
    command:
      [
        "node",
        "dist/index.js",
        "gateway",
        "--bind",
        "${OPENCLAW_GATEWAY_BIND}",
        "--port",
        "${OPENCLAW_GATEWAY_PORT}",
      ]
Tutorial.step

8）构建和启动

Bash
docker compose build
docker compose up -d openclaw-gateway

验证二进制文件：

Bash
docker compose exec openclaw-gateway which gog
docker compose exec openclaw-gateway which goplaces
docker compose exec openclaw-gateway which wacli

预期输出：

终端
/usr/local/bin/gog
/usr/local/bin/goplaces
/usr/local/bin/wacli
Tutorial.step

什么在哪里持久化（事实来源）

OpenClaw 在 Docker 中运行，但 Docker 不是事实来源。

所有长期状态必须在重启、重建和重新启动后保留。

| 组件 | 位置 | 持久化机制 | 备注 |

| Gateway 配置 | ''/home/node/.openclaw/'' | 主机卷挂载 | 包括 ''openclaw.json''、令牌 |

| 模型认证配置文件 | ''/home/node/.openclaw/'' | 主机卷挂载 | OAuth 令牌、API 密钥 |

| 技能配置 | ''/home/node/.openclaw/skills/'' | 主机卷挂载 | 技能级状态 |

| 代理工作区 | ''/home/node/.openclaw/workspace/'' | 主机卷挂载 | 代码和代理制品 |

| WhatsApp 会话 | ''/home/node/.openclaw/'' | 主机卷挂载 | 保留 QR 登录 |

| Gmail 密钥环 | ''/home/node/.openclaw/'' | 主机卷 + 密码 | 需要 ''GOG_KEYRING_PASSWORD'' |

| 外部二进制文件 | ''/usr/local/bin/'' | Docker 镜像 | 必须在构建时烘焙 |

| Node 运行时 | 容器文件系统 | Docker 镜像 | 每次镜像构建时重建 |

| 操作系统软件包 | 容器文件系统 | Docker 镜像 | 不要在运行时安装 |

| Docker 容器 | 临时 | 可重启 | 可以安全销毁 |