OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Hosting

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 分

クイック手順

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

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

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

    bash
    ssh root@YOUR_VPS_IP

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

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

    bash
    apt-get updateapt-get install -y git curl ca-certificatescurl -fsSL https://get.docker.com | sh

    確認します。

    bash
    docker --versiondocker compose version

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

    bash
    git clone https://github.com/openclaw/openclaw.gitcd openclaw

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

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

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

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

  • 環境変数を設定する

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

    bash
    OPENCLAW_IMAGE=openclaw:latestOPENCLAW_GATEWAY_TOKEN=OPENCLAW_GATEWAY_BIND=lanOPENCLAW_GATEWAY_PORT=18789 OPENCLAW_CONFIG_DIR=/root/.openclawOPENCLAW_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 用のキーリングパスワードを生成します。

    bash
    openssl rand -hex 32

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

  • 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"    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 を確認し、次のように設定します。

    text
    AllowTcpForwarding local

    local は、サーバーからのリモートフォワーディングをブロックしながら、ノート PC からの ssh -L ローカルフォワーディングを許可します。no に設定すると、トンネルは次のエラーで失敗します。 channel 3: open failed: administratively prohibited: open failed

    TCP フォワーディングが有効であることを確認したら、SSH サービス（systemctl restart ssh）を再起動し、ノート PC からトンネルを実行します。

    bash
    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 トンネル設定

    リポジトリ:

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

    次のステップ

    関連項目

    Was this useful?
    On this page

    On this page