Fly.io デプロイ¶

目的: 永続ストレージ、自動 HTTPS、Discord/チャンネルアクセスを備えた Fly.io マシン上で OpenClaw Gateway（ゲートウェイ）を実行します。

必要なもの¶

flyctl CLI がインストールされていること
Fly.io アカウント（無料枠で可）
モデル認証: Anthropic API キー（または他のプロバイダーのキー）
チャンネル認証情報: Discord ボットトークン、Telegram トークンなど

初心者向けクイックパス¶

リポジトリをクローン → fly.toml をカスタマイズ
アプリ + ボリュームを作成 → シークレットを設定
fly deploy でデプロイ
SSH で接続して設定を作成、または Control UI を使用

1) Fly アプリの作成¶

# Clone the repo
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# Create a new Fly app (pick your own name)
fly apps create my-openclaw

# Create a persistent volume (1GB is usually enough)
fly volumes create openclaw_data --size 1 --region iad

ヒント： 近くの地域を選んでください。一般的なオプション: lhr (ロンドン), iad (バージニア州), sjc (サンノゼ).

2. fly.toml の設定¶

アプリ名と要件に合わせて fly.toml を編集します。

セキュリティノート: デフォルトの設定は公開URLを公開します。 セキュリティ注意: デフォルト設定では公開 URL が公開されます。公開 IP を持たない堅牢化デプロイについては、Private Deployment を参照するか、fly.private.toml を使用してください。

app = "my-openclaw"  # Your app name
primary_region = "iad"

[build]
  dockerfile = "Dockerfile"

[env]
  NODE_ENV = "production"
  OPENCLAW_PREFER_PNPM = "1"
  OPENCLAW_STATE_DIR = "/data"
  NODE_OPTIONS = "--max-old-space-size=1536"

[processes]
  app = "node dist/index.js gateway --allow-unconfigured --port 3000 --bind lan"

[http_service]
  internal_port = 3000
  force_https = true
  auto_stop_machines = false
  auto_start_machines = true
  min_machines_running = 1
  processes = ["app"]

[[vm]]
  size = "shared-cpu-2x"
  memory = "2048mb"

[mounts]
  source = "openclaw_data"
  destination = "/data"

主要設定:

設定	理由
`--bind lan`	Fly のプロキシがゲートウェイに到達できるよう `0.0.0.0` にバインド
`--allow-unconfigured`	設定ファイルなしで起動（後で作成）
`internal_port = 3000`	Fly のヘルスチェックのため `--port 3000`（または `OPENCLAW_GATEWAY_PORT`）と一致する必要
`memory = "2048mb"`	512MB は小さすぎるため、2GB を推奨
`OPENCLAW_STATE_DIR = "/data"`	ボリューム上に状態を永続化

3. シークレットの設定¶

# Required: Gateway token (for non-loopback binding)
fly secrets set OPENCLAW_GATEWAY_TOKEN=$(openssl rand -hex 32)

# Model provider API keys
fly secrets set ANTHROPIC_API_KEY=sk-ant-...

# Optional: Other providers
fly secrets set OPENAI_API_KEY=sk-...
fly secrets set GOOGLE_API_KEY=...

# Channel tokens
fly secrets set DISCORD_BOT_TOKEN=MTQ...

注記:

非ループバックバインド（--bind lan）では、セキュリティのため OPENCLAW_GATEWAY_TOKEN が必要です。
これらのトークンはパスワードと同様に扱ってください。
**すべての API キーとトークンに対して設定ファイルよりも env vars を優先します。これにより、誤って公開されたりログに記録されたりすることのできる openclaw.json の秘密が保持されます。

4. デプロイ¶

fly deploy

初回デプロイでは Docker イメージをビルドします（約 2～3 分）。以降のデプロイは高速です。その後のデプロイが速くなります。

デプロイ後、次を確認します。

fly status
fly logs

表示する必要があります:

[gateway] listening on ws://0.0.0.0:3000 (PID xxx)
[discord] logged in to discord as xxx

5. 設定ファイルの作成¶

SSH でマシンに接続し、適切な設定を作成します。

fly ssh console

設定ディレクトリとファイルを作成します。

mkdir -p /data
cat > /data/openclaw.json << 'EOF'
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "anthropic/claude-opus-4-6",
        "fallbacks": ["anthropic/claude-sonnet-4-5", "openai/gpt-4o"]
      },
      "maxConcurrent": 4
    },
    "list": [
      {
        "id": "main",
        "default": true
      }
    ]
  },
  "auth": {
    "profiles": {
      "anthropic:default": { "mode": "token", "provider": "anthropic" },
      "openai:default": { "mode": "token", "provider": "openai" }
    }
  },
  "bindings": [
    {
      "agentId": "main",
      "match": { "channel": "discord" }
    }
  ],
  "channels": {
    "discord": {
      "enabled": true,
      "groupPolicy": "allowlist",
      "guilds": {
        "YOUR_GUILD_ID": {
          "channels": { "general": { "allow": true } },
          "requireMention": false
        }
      }
    }
  },
  "gateway": {
    "mode": "local",
    "bind": "auto"
  },
  "meta": {
    "lastTouchedVersion": "2026.1.29"
  }
}
EOF

注記: OPENCLAW_STATE_DIR=/data を使用している場合、設定パスは /data/openclaw.json です。

注記: Discord トークンは次のいずれかから取得できます。

環境変数: DISCORD_BOT_TOKEN（シークレットには推奨）
設定ファイル: channels.discord.token

env var を使用する場合は、config にトークンを追加する必要はありません。ゲートウェイは DISCORD_BOT_TOKEN を自動的に読み込みます。

適用するため再起動します。

exit
fly machine restart <machine-id>

6. Gateway（ゲートウェイ）へのアクセス¶

制御UI¶

ブラウザーで開きます。

fly open

または https://my-openclaw.fly.dev/ にアクセスします。

OPENCLAW_GATEWAY_TOKEN から取得したゲートウェイトークンを貼り付けて認証します。

ログ¶

fly logs              # Live logs
fly logs --no-tail    # Recent logs

SSH コンソール¶

fly ssh console

トラブルシューティング¶

「App is not listening on expected address」¶

ゲートウェイが 0.0.0.0 ではなく 127.0.0.1 にバインドしています。

対処: fly.toml のプロセスコマンドに --bind lan を追加してください。

ヘルスチェック失敗 / connection refused¶

設定されたポートで Fly がゲートウェイに到達できません。

対処: internal_port がゲートウェイのポートと一致していることを確認してください（--port 3000 または OPENCLAW_GATEWAY_PORT=3000 を設定）。

OOM / メモリ問題¶

コンテナは再起動または殺され続けます。コンテナが再起動を繰り返す、または強制終了されます。兆候: SIGABRT、v8::internal::Runtime_AllocateInYoungGeneration、または無言の再起動。

対処: fly.toml のメモリを増やします。

[[vm]]
  memory = "2048mb"

または既存のマシンを更新します。

fly machine update <machine-id> --vm-memory 2048 -y

注意： 512MBが小さすぎます。 1GBは動作するかもしれませんが、負荷下または冗長ロギングでOOMすることができます。 2GB を推奨します。

Gateway ロックの問題¶

「already running」エラーで Gateway（ゲートウェイ）が起動しません。

これは、コンテナが再起動しても PID ロックファイルがボリュームに残る場合に発生します。

対処: ロックファイルを削除します。

fly ssh console --command "rm -f /data/gateway.*.lock"
fly machine restart <machine-id>

ロックファイルは /data/gateway.*.lock（サブディレクトリではありません）にあります。

設定が読み込まれない¶

--allow-unconfigured を使用する場合、ゲートウェイは最小限の設定を作成します。 --allow-unconfigured を使用している場合、ゲートウェイは最小限の設定を作成します。再起動時に /data/openclaw.json のカスタム設定が読み込まれるはずです。

設定の存在を確認します。

fly ssh console --command "cat /data/openclaw.json"

SSH 経由での設定書き込み¶

fly ssh console -C コマンドはシェルのリダイレクトをサポートしていません。設定ファイルを書き込むには次を使用します。設定ファイルを書き込む:

# Use echo + tee (pipe from local to remote)
echo '{"your":"config"}' | fly ssh console -C "tee /data/openclaw.json"

# Or use sftp
fly sftp shell
> put /local/path/config.json /data/openclaw.json

注記: ファイルが既に存在する場合、fly sftp は失敗することがあります。先に削除してください。最初に削除:

fly ssh console --command "rm /data/openclaw.json"

状態が永続化されない¶

再起動後に認証情報やセッションが失われる場合、状態ディレクトリがコンテナのファイルシステムに書き込まれています。

対処: fly.toml に OPENCLAW_STATE_DIR=/data が設定されていることを確認し、再デプロイしてください。

更新¶

# Pull latest changes
git pull

# Redeploy
fly deploy

# Check health
fly status
fly logs

マシンコマンドの更新¶

完全な再デプロイなしで起動コマンドを変更する必要がある場合:

# Get machine ID
fly machines list

# Update command
fly machine update <machine-id> --command "node dist/index.js gateway --port 3000 --bind lan" -y

# Or with memory increase
fly machine update <machine-id> --vm-memory 2048 --command "node dist/index.js gateway --port 3000 --bind lan" -y

注記: fly deploy の後、マシンコマンドは fly.toml に記載の内容へリセットされる場合があります。手動変更を行った場合は、デプロイ後に再適用してください。手動で変更を加えた場合は、デプロイ後に再度適用します。

Private Deployment（堅牢化）¶

デフォルトでは、Fly は公開 IP を割り当て、ゲートウェイは https://your-app.fly.dev でアクセス可能になります。便利ですが、インターネットスキャナー（Shodan、Censys など）に発見される可能性があります。これは便利ですが、インターネットスキャナー(Shodan、Censysなど)で展開を確認できることを意味します。

公開なしの堅牢化デプロイには、プライベートテンプレートを使用してください。

プライベートデプロイを使用する場合¶

アウトバウンド の呼び出し/メッセージのみを行う（インバウンド Webhook なし）
Webhook コールバックに ngrok または Tailscale トンネルを使用
ブラウザーではなく SSH、プロキシ、または WireGuard 経由でゲートウェイにアクセス
デプロイを インターネットスキャナーから隠したい

セットアップ¶

標準設定の代わりに fly.private.toml を使用します。

# Deploy with private config
fly deploy -c fly.private.toml

または既存のデプロイを変換します。

# List current IPs
fly ips list -a my-openclaw

# Release public IPs
fly ips release <public-ipv4> -a my-openclaw
fly ips release <public-ipv6> -a my-openclaw

# Switch to private config so future deploys don't re-allocate public IPs
# (remove [http_service] or deploy with the private template)
fly deploy -c fly.private.toml

# Allocate private-only IPv6
fly ips allocate-v6 --private -a my-openclaw

この後、fly ips list には private タイプの IP のみが表示されるはずです。

VERSION  IP                   TYPE             REGION
v6       fdaa:x:x:x:x::x      private          global

プライベートデプロイへのアクセス¶

公開 URL がないため、次のいずれかを使用します。

オプション 1: ローカルプロキシ（最も簡単）

# Forward local port 3000 to the app
fly proxy 3000:3000 -a my-openclaw

# Then open http://localhost:3000 in browser

オプション 2: WireGuard VPN

# Create WireGuard config (one-time)
fly wireguard create

# Import to WireGuard client, then access via internal IPv6
# Example: http://[fdaa:x:x:x:x::x]:3000

オプション 3: SSH のみ

fly ssh console -a my-openclaw

プライベートデプロイでの Webhook¶

公開なしで Webhook コールバック（Twilio、Telnyx など）が必要な場合: 公開されることなく

ngrok トンネル - コンテナ内またはサイドカーとして ngrok を実行
Tailscale Funnel - Tailscale 経由で特定パスを公開
アウトバウンドのみ - 一部プロバイダー（Twilio）は Webhook なしでもアウトバウンドで問題なく動作

ngrok を使用した音声通話設定の例:

{
  "plugins": {
    "entries": {
      "voice-call": {
        "enabled": true,
        "config": {
          "provider": "twilio",
          "tunnel": { "provider": "ngrok" },
          "webhookSecurity": {
            "allowedHosts": ["example.ngrok.app"]
          }
        }
      }
    }
  }
}

ngrok トンネルはコンテナ内で実行され、Fly アプリ自体を公開せずに公開 Webhook URL を提供します。転送される Host ヘッダーを受け入れるため、webhookSecurity.allowedHosts を公開トンネルのホスト名に設定してください。 webhookSecurity.allowedHostsをパブリックトンネルホスト名に設定すると、転送されたホストヘッダが受け入れられます。

セキュリティ上の利点¶

観点	公開	非公開
インターネットスキャナー	検出可能	非公開
直接攻撃	可能	ブロック
Control UI アクセス	ブラウザー	プロキシ/VPN
Webhook 配信	直接	トンネル経由

注記¶

Fly.io は x86 アーキテクチャ を使用（ARM ではありません）
Dockerfile は両方のアーキテクチャに対応しています
WhatsApp/Telegram のオンボーディングには fly ssh console を使用してください
永続データは /data のボリュームに保存されます
Signal には Java + signal-cli が必要です。カスタムイメージを使用し、メモリは 2GB 以上を維持してください。

コスト¶

推奨設定（shared-cpu-2x、2GB RAM）では:

使用状況により月額約 $10～15
無料枠には一定の割当が含まれます

詳細は Fly.io pricing を参照してください。

Install overview

Other install methods

Maintenance

Hosting and deployment

Advanced

Fly.io

Fly.io デプロイ¶

必要なもの¶

初心者向けクイックパス¶

1) Fly アプリの作成¶

2. fly.toml の設定¶

3. シークレットの設定¶

4. デプロイ¶

5. 設定ファイルの作成¶

6. Gateway（ゲートウェイ）へのアクセス¶

制御UI¶

ログ¶

SSH コンソール¶

トラブルシューティング¶

「App is not listening on expected address」¶

ヘルスチェック失敗 / connection refused¶

OOM / メモリ問題¶

Gateway ロックの問題¶

設定が読み込まれない¶

SSH 経由での設定書き込み¶

状態が永続化されない¶

更新¶

マシンコマンドの更新¶

Private Deployment（堅牢化）¶

プライベートデプロイを使用する場合¶

セットアップ¶

プライベートデプロイへのアクセス¶

プライベートデプロイでの Webhook¶

セキュリティ上の利点¶

注記¶

コスト¶

Install overview

Other install methods

Maintenance

Hosting and deployment

Advanced

Fly.io デプロイ¶

必要なもの¶

初心者向けクイック パス¶

1) Fly アプリの作成¶

2. fly.toml の設定¶

3. シークレットの設定¶

4. デプロイ¶

5. 設定ファイルの作成¶

6. Gateway（ゲートウェイ）へのアクセス¶

制御UI¶

ログ¶

SSH コンソール¶

トラブルシューティング¶

「App is not listening on expected address」¶

ヘルスチェック失敗 / connection refused¶

OOM / メモリ問題¶

Gateway ロックの問題¶

設定が読み込まれない¶

SSH 経由での設定書き込み¶

状態が永続化されない¶

更新¶

マシン コマンドの更新¶

Private Deployment（堅牢化）¶

プライベート デプロイを使用する場合¶

セットアップ¶

プライベート デプロイへのアクセス¶

プライベート デプロイでの Webhook¶

セキュリティ上の利点¶

注記¶

コスト¶

初心者向けクイックパス¶

マシンコマンドの更新¶

プライベートデプロイを使用する場合¶

プライベートデプロイへのアクセス¶

プライベートデプロイでの Webhook¶