Hetzner

耐久性のある状態、組み込み済みバイナリ、安全な再起動動作を備えた永続的な OpenClaw Gateway を、Docker を使用して Hetzner VPS 上で実行します。 Hetzner の料金は変更される可能性があります。要件を満たす最小の Debian/Ubuntu VPS を選び、OOM が発生した場合はスケールアップしてください。 Gateway には、ノート PC から SSH ポートフォワーディング経由でアクセスできます。また、ファイアウォールとトークンを自身で管理する場合は、ポートを直接公開してアクセスすることもできます。セキュリティモデルに関する注意事項:

全員が同じ信頼境界内にいて、ランタイムが業務専用である場合、会社で共有するエージェントを使用しても問題ありません。
厳格に分離してください。専用の VPS/ランタイムと専用アカウントを使用し、そのホスト上では個人用の Apple/Google/ブラウザー/パスワードマネージャーのプロファイルを使用しないでください。
ユーザー同士が敵対的である場合は、Gateway/ホスト/OS ユーザーごとに分離してください。

セキュリティおよびVPS ホスティングを参照してください。このガイドでは、Hetzner 上の Ubuntu または Debian を前提としています。別の Linux VPS では、パッケージを適宜読み替えてください。一般的な Docker の手順については、Dockerを参照してください。

必要なもの

root アクセス権を持つ Hetzner VPS
ノート PC からの SSH アクセス
Docker と Docker Compose
モデル認証資格情報
任意のプロバイダー資格情報（WhatsApp QR、Telegram ボットトークン、Gmail OAuth）
約 20 分

クイック手順

Hetzner VPS をプロビジョニングする
Docker をインストールする
OpenClaw リポジトリをクローンする
永続的なホストディレクトリを作成する
.env と docker-compose.yml を設定する
必要なバイナリをイメージに組み込む
docker compose up -d
永続性と Gateway へのアクセスを確認する

VPS をプロビジョニングする

Hetzner で Ubuntu または Debian VPS を作成し、root として接続します。

ssh root@YOUR_VPS_IP

VPS は使い捨てのインフラストラクチャではなく、状態を保持するものとして扱ってください。

Docker をインストールする（VPS 上）

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

確認します。

docker --version
docker compose version

OpenClaw リポジトリをクローンする

git clone https://github.com/openclaw/openclaw.git
cd openclaw

このガイドではカスタムイメージをビルドするため、組み込んだすべてのバイナリが再起動後も維持されます。

永続的なホストディレクトリを作成する

Docker コンテナは一時的なものです。長期間保持するすべての状態はホスト上に保存する必要があります。

mkdir -p /root/.openclaw/workspace

# 所有者をコンテナユーザー（uid 1000）に設定:
chown -R 1000:1000 /root/.openclaw

環境変数を設定する

リポジトリのルートに .env を作成します。

OPENCLAW_IMAGE=openclaw:latest
OPENCLAW_GATEWAY_TOKEN=
OPENCLAW_GATEWAY_BIND=lan
OPENCLAW_GATEWAY_PORT=18789

OPENCLAW_CONFIG_DIR=/root/.openclaw
OPENCLAW_WORKSPACE_DIR=/root/.openclaw/workspace

GOG_KEYRING_PASSWORD=
XDG_CONFIG_HOME=/home/node/.openclaw

.env を通じて安定した Gateway トークンを管理するには OPENCLAW_GATEWAY_TOKEN を設定します。それ以外の場合は、再起動後もクライアントを使用する前に gateway.auth.token を設定してください。どちらも設定されていない場合、OpenClaw はその起動時にのみ有効なトークンを使用します。GOG_KEYRING_PASSWORD 用のキーリングパスワードを生成します。

openssl rand -hex 32

このファイルをコミットしないでください。 このファイルには、OPENCLAW_GATEWAY_TOKEN などのコンテナ/ランタイム環境変数が含まれます。保存されたプロバイダーの OAuth/API キー認証情報は、マウントされた ~/.openclaw/agents/<agentId>/agent/auth-profiles.json に格納されます。

Docker Compose の設定

docker-compose.yml を作成または更新します。

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"
    command:
      [
        "node",
        "dist/index.js",
        "gateway",
        "--bind",
        "${OPENCLAW_GATEWAY_BIND}",
        "--port",
        "${OPENCLAW_GATEWAY_PORT}",
        "--allow-unconfigured",
      ]

--allow-unconfigured はブートストラップを容易にするためだけのものであり、適切な Gateway 設定の代わりにはなりません。デプロイ環境に合わせて、認証（gateway.auth.token またはパスワード）と安全なバインドモードを設定してください。

共有 Docker VM ランタイムの手順

共通の Docker ホスト手順については、共有ランタイムガイドに従ってください。

Hetzner 固有のアクセス

共有のビルドおよび起動手順を完了したら、トンネルを開きます。前提条件: VPS の sshd 設定で TCP フォワーディングが許可されていることを確認してください。SSH 設定を強化している場合は、/etc/ssh/sshd_config を確認し、次のように設定します。

AllowTcpForwarding local

local は、サーバーからのリモートフォワーディングをブロックしながら、ノート PC からの ssh -L ローカルフォワーディングを許可します。no に設定すると、トンネルは次のエラーで失敗します。 channel 3: open failed: administratively prohibited: open failedTCP フォワーディングが有効であることを確認したら、SSH サービス（systemctl restart ssh）を再起動し、ノート PC からトンネルを実行します。

ssh -N -L 18789:127.0.0.1:18789 root@YOUR_VPS_IP

http://127.0.0.1:18789/ を開き、設定した共有シークレットを貼り付けます。このガイドではデフォルトで Gateway トークンを使用します。パスワード認証に切り替えた場合は、代わりに設定したパスワードを使用してください。

共有の永続化マップについては、Docker VM ランタイムを参照してください。

Infrastructure as Code（Terraform）

Infrastructure as Code ワークフローを使用するチーム向けに、コミュニティが保守する Terraform セットアップでは次の機能が提供されています。

リモート状態管理を備えたモジュール式 Terraform 設定
cloud-init による自動プロビジョニング
デプロイスクリプト（ブートストラップ、デプロイ、バックアップ/復元）
セキュリティ強化（ファイアウォール、UFW、SSH のみのアクセス）
Gateway アクセス用の SSH トンネル設定

リポジトリ:

インフラストラクチャ: openclaw-terraform-hetzner
Docker 設定: openclaw-docker-config

この方法は、再現可能なデプロイ、バージョン管理されたインフラストラクチャ、自動化された災害復旧によって、上記の Docker セットアップを補完します。

コミュニティによって保守されています。問題の報告やコントリビューションについては、上記のリポジトリリンクを参照してください。

次のステップ

メッセージングチャネルを設定する: チャネル
Gateway を設定する: Gateway の設定
OpenClaw を最新の状態に保つ: 更新

Install overview

Maintenance

Containers

Hosting

Advanced setup

必要なもの

クイック手順

Infrastructure as Code（Terraform）

次のステップ

関連項目

​必要なもの

​クイック手順

​Infrastructure as Code（Terraform）

​次のステップ

​関連項目

必要なもの

クイック手順

Infrastructure as Code（Terraform）

次のステップ

関連項目