logo

コミュニティ

icon

OpenClaw 🦞

OpenClaw 🦞（旧 Clawdbot、Moltbot）は、ローカルで実行され、WebSocket ベースの Gateway アーキテクチャを介して複数のメッセージングプラットフォーム（WhatsApp、Telegram、Slack、Discord など）に接続する個人用 AI アシスタントです。

template cover
展開済み36433 回
発行者zeaburZeabur
作成日2026-01-26
サービス
service icon
最小構成2 Cores4 GB
推奨構成4 Cores8 GB
タグ
AIAssistantChatbotWhatsAppTelegramSlackDiscord

OpenClaw 🦞

OpenClaw 🦞（旧 Clawdbot、Moltbot）は、ローカルで実行され、WebSocket ベースの Gateway アーキテクチャを介して複数のメッセージングプラットフォームに接続する個人用 AI アシスタントです。

⚠️ 本テンプレートは ghcr.io/openclaw/openclaw:2026.3.24 を使用しています。OpenClaw 🦞 は急速に開発中のため、未発見のバグがある可能性があります。バージョンを変更した場合も安定性を保証できません。

⚠️ 問題が発生した場合は、GitHub issues で解決策を探したり、新しい問題を報告したりしてください。Zeabur プラットフォーム関連の問題については、Zeabur サポートにお問い合わせください。

⚠️ このテンプレートは Zeabur の専用サーバーが必要です。共有クラスターでは実行できません。

⚠️ 本テンプレートは事前設定済みですぐに使用できます。openclaw onboard を実行する必要はありません。実行した場合は、対応する設定を手動で修正する必要があります。詳細は公式ドキュメントを参照してください。

デプロイ変数

デプロイ時に以下の変数を入力します：

変数必須説明
ドメインはいOpenClaw にアクセスするためのサブドメイン（例：my-openclaw → my-openclaw.zeabur.app）。loopback モードに切り替え後は削除可能。
Control UI を有効化はいtrue（デフォルト）— 公開ドメイン経由で Control UI を有効化。false — ローカルループバックのみ、公開 Web アクセスなし（より安全、Tailscale や Tailscale や Telegram 等の対応チャンネルと併用）
Zeabur AI Hub API キーいいえ空欄でスキップ可能。スキップした場合、デフォルトモデルは anthropic/claude-opus-4-6（別途 API キーが必要）。AI Hub を使うと Gemini、GPT、Claude、DeepSeek を利用可能。後から「変数」タブで追加できます。

推奨リソース

  • 最小構成：2 vCPU / 4 GB RAM
  • 推奨構成：4 vCPU / 8 GB RAM

機能拡張

  • ブラウザ：ブラウザ機能（Web ブラウジング、スクリーンショットなど）が必要な場合は、Browser テンプレートをデプロイしてください
  • Devbox：多言語コード実行（Python、Go、Rust、C/C++）が必要な場合は、Devbox テンプレートを同じプロジェクトにデプロイしてください

使用方法

  1. デプロイ後、ネットワークタブからサービス URL を開く。ログインページで Gateway Token（手順タブまたは環境変数 → OPENCLAW_GATEWAY_TOKEN で確認）を貼り付け、Connect をクリック
  2. AI モデルを設定（いずれかを選択）：
    • Zeabur AI Hub（デフォルトモデル：glm-4.7-flash）：デプロイ時に API Key を入力済みの場合、ステップ 3 へ進む。後から Zeabur ダッシュボードの変数タブで ZEABUR_AI_HUB_API_KEY を追加も可能（追加後はサービスを再起動）。
    • 他のプロバイダー（Anthropic、OpenAI など）：Zeabur AI Hub API Key を入力しなかった場合、デフォルトモデルは anthropic/claude-opus-4-6 です。Control UI Settings または環境変数で API キーを追加してください。詳細：https://docs.openclaw.ai/providers/anthropic
  3. Chat ページで AI モデルが正常に動作しているかテスト
  4. （オプション）Telegram、WhatsApp などのメッセージングプラットフォームを設定

AI モデル設定については公式ドキュメントをご覧ください。

モデル切り替えと Failover

このテンプレートにはフェイルオーバーモデルが含まれており、プライマリモデルが利用できない場合に自動的に切り替わります。デフォルトチェーン：glm-4.7-flash → grok-4-fast-non-reasoning → minimax-m2.5 → kimi-k2.5 → qwen-3-235b → gpt-5-mini。

Control UI Chat または Zeabur ダッシュボードのコマンドからモデルを管理できます。

Control UI Chat から — チャットボックスに slash command を直接入力：

  • /model zeabur-ai/glm-4.7-flash — プライマリモデルを変更
  • /model — 現在のモデルを確認
  • /models — モデルプロバイダー一覧
  • /models <provider> — 指定プロバイダーのモデル一覧（例：/models zeabur-ai）

コマンドから（Zeabur ダッシュボード）— ターミナルで同じコマンドを実行：

openclaw models set zeabur-ai/glm-4.7-flash
openclaw models status
openclaw models list --all
openclaw models fallbacks list
openclaw models fallbacks add zeabur-ai/gpt-5-mini
openclaw models fallbacks remove zeabur-ai/gpt-5-mini
openclaw models fallbacks clear

または設定ファイルを直接編集（~/.openclaw/config.json5）：

"agents": {
  "defaults": {
    "model": {
      "primary": "zeabur-ai/glm-4.7-flash",
      "fallbacks": ["zeabur-ai/grok-4-fast-non-reasoning", "zeabur-ai/minimax-m2.5"]
    }
  }
}

設定ファイル編集後はサービスを再起動してください。

外部モデルプロバイダーの追加

Zeabur AI Hub 以外に、Anthropic、OpenAI、Google などの外部プロバイダーを追加できます。

方法 1：環境変数 — Zeabur ダッシュボードの変数タブで API キーを追加：

  • ANTHROPIC_API_KEY — Claude モデル
  • OPENAI_API_KEY — GPT モデル
  • GOOGLE_API_KEY — Gemini モデル

追加後サービスを再起動し、モデルを切り替え：

  • Control UI Chat：/model anthropic/claude-opus-4-6
  • コマンド：openclaw models set anthropic/claude-opus-4-6

方法 2：Auth token — Zeabur ダッシュボードのコマンドを開く：

# プロバイダーの API キーを貼り付け
openclaw models auth paste-token --provider anthropic

# またはインタラクティブ認証ヘルパーを使用
openclaw models auth add

方法 3：設定ファイル — ~/.openclaw/config.json5 を編集：

"models": {
  "providers": {
    "anthropic": { "apiKey": "sk-ant-..." },
    "openai": { "apiKey": "sk-..." }
  }
}

対応プロバイダーの一覧は公式ドキュメントをご覧ください。

Telegram ボット設定

BotFather からトークンを取得：

  1. Telegram を開いて @BotFather を検索
  2. /newbot を送信して新しいボットを作成
  3. プロンプトに従ってボットの名前とユーザー名を設定
  4. BotFather がトークンを送信します（例：123456789:ABCdefGHIjklMNOpqrsTUVwxyz）

Zeabur にトークンを追加：

  1. Zeabur ダッシュボードのサービス変数タブに移動
  2. TELEGRAM_BOT_TOKEN を追加してトークンを入力
  3. サービスを再起動
  4. 再起動後、Settings → Config で Telegram プラグインを有効にしてください："plugins": { "entries": { "telegram": { "enabled": true } } }。無効にするには enabled を false に設定します。

Telegram アカウントのペアリング：

  1. Telegram でボットに /start を送信
  2. ボットがペアリングコードを返信（例：JN4MSY23）
  3. 以下のいずれかの方法でペアリングを承認：
    • Web Chat：OpenClaw のウェブインターフェースのチャットボックスに openclaw pairing approve telegram <コード> を入力
    • ターミナル：Zeabur ダッシュボードのコマンドを開き、openclaw pairing approve telegram <コード> を実行
  4. Approved telegram sender <user-id>. と表示されればペアリング完了
  5. ボットとの会話を開始できます！

WhatsApp セットアップ

ステップ 1：WhatsApp チャンネルを設定 OpenClaw Control UI（Settings → Config）またはチャットに貼り付けて以下の設定を追加：

"channels": {
  "whatsapp": {
    "selfChatMode": true,
    "dmPolicy": "allowlist",
    "allowFrom": ["+15551234567"]
  }
}

+15551234567 をあなたの WhatsApp 電話番号（国番号付き）に置き換えてください。保存後にサービスを再起動してください。

ステップ 2：WhatsApp をリンク

  1. Zeabur ダッシュボードでコマンドを開いてコンテナターミナルにアクセス
  2. 実行：openclaw channels login
  3. QR コードが表示されます - スマートフォンの WhatsApp でスキャンしてください
  4. 接続完了！WhatsApp で自分自身にメッセージを送ると OpenClaw と会話できます

LINE ボット設定

LINE Messaging API チャンネルの作成：

  1. LINE 公式アカウントをまだ作成していない場合は、先に作成してください
  2. LINE Developers Console にアクセス
  3. Provider を作成または選択
  4. 新しい Messaging API チャンネルを作成し、LINE 公式アカウントにリンク
  5. Messaging API タブで Channel access token（長期有効）を発行
  6. Basic settings タブで Channel secret をコピー

Zeabur に認証情報を追加：

  1. Zeabur ダッシュボードのサービス変数タブに移動
  2. LINE_CHANNEL_ACCESS_TOKEN を追加して Channel access token を入力
  3. LINE_CHANNEL_SECRET を追加して Channel secret を入力
  4. サービスを再起動
  5. 再起動後、Settings → Config で LINE プラグインを有効にしてください："plugins": { "entries": { "line": { "enabled": true } } }

Webhook の設定：

  1. 再起動後、Webhook URL は https://<your-domain>/line/webhook です
  2. LINE Developers Console でチャンネルの Messaging API タブに移動
  3. Webhook URL を https://<your-domain>/line/webhook に設定
  4. Use webhook を有効化
  5. （推奨）LINE 公式アカウントマネージャーで自動応答メッセージとあいさつメッセージを無効化

LINE アカウントのペアリング：

  1. LINE でボットを友だち追加し、任意のメッセージを送信
  2. ボットがペアリングコードを返信（例：JN4MSY23）
  3. 以下のいずれかの方法でペアリングを承認：
    • Web Chat：OpenClaw のウェブインターフェースのチャットボックスに openclaw pairing approve line <コード> を入力
    • ターミナル：Zeabur ダッシュボードのコマンドを開き、openclaw pairing approve line <コード> を実行
  4. Approved line sender <user-id>. と表示されればペアリング完了
  5. LINE でボットとの会話を開始できます！

その他のメッセージングプラットフォーム（Discord、Slack など）については、Channels ドキュメントをご覧ください。

AI モデル設定

セットアップの確認：

  1. デフォルトモデルはデプロイ方法に依存します：
    • Zeabur AI Hub API Key を入力した場合 → デフォルトモデル：zeabur-ai/glm-4.7-flash
    • 入力しなかった場合 → デフォルトモデル：anthropic/claude-opus-4-6（API キーが必要）
  2. Chat ページを開き、テストメッセージを送信
  3. 返答があれば → モデルは正常に動作しています
  4. エラーが出た場合 → API キーが正しく設定されているか確認

現在の会話のモデルを切り替え（チャットコマンドで）：

  • /models - 利用可能なモデルを表示
  • /model <model-id> - この会話のみモデルを切り替え（他の会話には影響しません）

全ての新しい会話のデフォルトモデルを変更（Control UI Settings で）：

  • Settings → Agents → Default model
  • ヒント： 低コストのモデルをデフォルトに設定しましょう（例：gemini-2.5-flash-lite、gpt-5-nano）。モデルが使用できなくなった場合、/new で新しい会話を開始すればデフォルトモデルに自動的に戻ります。

AI プロバイダーを追加（Control UI Settings または環境変数で）：

Zeabur AI Hub モデルを変更（Zeabur ダッシュボードで）：

  • 設定 → 設定ファイル → /opt/openclaw/providers/zeabur-ai-hub.json5 を編集し、サービスを再起動（変更は起動時に同期されます）
  • 旧バージョン（コマンドなし）：ファイル タブまたは Control UI Settings で /home/node/.openclaw/openclaw.json を編集。以下を models.providers.zeabur-ai.models 配列に追加：
{ "id": "gpt-5.2", "name": "GPT-5.2", "reasoning": false, "input": ["text", "image"], "cost": { "input": 1.75, "output": 14, "cacheRead": 0.18, "cacheWrite": 0 }, "contextWindow": 400000, "maxTokens": 8192 },
{ "id": "gpt-5.1", "name": "GPT-5.1", "reasoning": false, "input": ["text", "image"], "cost": { "input": 1.25, "output": 10, "cacheRead": 0.13, "cacheWrite": 0 }, "contextWindow": 400000, "maxTokens": 8192 },
{ "id": "gpt-5-nano", "name": "GPT-5 Nano", "reasoning": false, "input": ["text", "image"], "cost": { "input": 0.05, "output": 0.4, "cacheRead": 0.01, "cacheWrite": 0 }, "contextWindow": 400000, "maxTokens": 8192 },
{ "id": "glm-4.7", "name": "GLM-4.7", "reasoning": false, "input": ["text", "image"], "cost": { "input": 0.4, "output": 1.9, "cacheRead": 0.08, "cacheWrite": 0 }, "contextWindow": 204800, "maxTokens": 8192 },
{ "id": "glm-4.7-flash", "name": "GLM-4.7 Flash", "reasoning": false, "input": ["text", "image"], "cost": { "input": 0.06, "output": 0.4, "cacheRead": 0, "cacheWrite": 0 }, "contextWindow": 204800, "maxTokens": 8192 },
{ "id": "kimi-k2.5", "name": "Kimi K2.5", "reasoning": false, "input": ["text"], "cost": { "input": 0.45, "output": 2.25, "cacheRead": 0.07, "cacheWrite": 0 }, "contextWindow": 131072, "maxTokens": 8192 }

セキュリティに関する注意

Control UI は設定、監視、チャットのための管理ツールです — メッセージングプラットフォーム（Telegram、WhatsApp、Discord など）は Control UI なしで独立して動作します。インバウンド Webhook が不要なプラットフォーム（Telegram、WhatsApp、Discord、Signal、iMessage）のみを使用する場合は、Zeabur ダッシュボードのネットワークタブでドメインバインディングを削除し、Gateway をパブリックインターネットに公開しないようにできます。すべての管理操作は Zeabur のコマンドターミナルで CLI を使って実行できます（openclaw config set、openclaw models set など）。パブリックドメインなしで Control UI にアクセスするには、Tailscale プライベートネットワークアクセスを参照してください。さらに、変数タブで OPENCLAW_GATEWAY_BIND を loopback に設定し（設定後サービスを再起動）、Gateway をローカル接続のみに制限することもできます。

パブリックドメインが必要なプラットフォーム（インバウンド Webhook）：LINE、Slack、Google Chat。

データ永続化

すべてのデータは /home/node に保存：

  • /home/node/.openclaw - 設定、セッション、デバイス、認証情報
  • /home/node/.openclaw/workspace - ワークスペースとメモリファイル

バックアップと復元

💡 ヒント： 初期設定完了後や重要な設定変更後にバックアップを作成することをお勧めします。

バックアップ：

  • 方法1：Zeabur バックアップサービス（推奨） - Zeabur の組み込みバックアップ機能を使用。Zeabur バックアップドキュメントを参照。
  • 方法2：CLI バックアップ（v2026.3.8+） - コマンドを開く → openclaw backup create を実行 → ファイルタブの /home/node からダウンロード
    • 設定のみ：openclaw backup create --only-config
    • ワークスペース除外：openclaw backup create --no-include-workspace
    • アーカイブ検証：openclaw backup verify <バックアップファイル名>
    • 例：
    $ openclaw backup create
Backup archive: /home/node/2026-03-09T15-08-31.114Z-openclaw-backup.tar.gz
Included 1 path:
- state: ~/.openclaw
Skipped 1 path:
- workspace: ~/.openclaw/workspace (covered by ~/.openclaw)
Created /home/node/2026-03-09T15-08-31.114Z-openclaw-backup.tar.gz
  • 方法3：手動バックアップ - コマンドを開く → backup を実行 → ファイルタブの /home/node からダウンロード（例：backup-1430.tar.gz）
    • 旧バージョン（コマンドなし）：cd /home/node && tar -czvf backup.tar.gz .openclaw

復元：

  1. ファイルタブでバックアップファイルを /home/node フォルダにアップロード
  2. コマンドを開いて実行：
    • CLI バックアップ（v2026.3.8+）：restore <バックアップファイル名>（自動検出、例：restore 2026-03-09T15-08-31.114Z-openclaw-backup.tar.gz）
    • Zeabur バックアップサービス：restore <バックアップファイル名>（自動検出、例：restore data-2026-02-27.zip）
    • 手動バックアップのファイル：restore <バックアップファイル名>（例：restore backup-1430.tar.gz）
    • 旧バージョン（コマンドなし）：cd /home/node && tar -xzvf <バックアップファイル名>
  3. ファイルタブで /home/node にアップロードしたバックアップファイルを削除し、ディスク容量を解放
  4. サービスを再起動

⚠️ 復元すると、新サービス上の既存の設定とデータが上書きされます。関連する環境変数（例：TELEGRAM_BOT_TOKEN）も忘れずに設定してください。チャンネルのバックアップ復元は現在 Telegram と WhatsApp でのみテスト済みです。

トラブルシューティング

デフォルトの起動コマンド：/opt/openclaw/startup.sh && /opt/openclaw/start_gateway.sh

新規デプロイ（ヘルパーページあり）

Gateway が停止すると、サービスURLにエラー情報と修復手順を含むヘルパーページが表示されます：

  1. エラーログを確認 — ヘルパーページに最近のログが表示されます。完全なログは Zeabur Dashboard のログタブで確認
  2. 設定ファイルを修正 — Zeabur Dashboard のファイルタブで設定ファイル（/home/node/.openclaw/openclaw.json）を見つけて問題を修正
  3. Zeabur Dashboard で再起動をクリックして修正を適用

既存のデプロイ（ヘルパーページなし）

ヘルパーページがないデプロイの場合は、以下の手順に従ってください：

  1. Zeabur Dashboard のログタブでエラーを確認
  2. 設定 → コマンドで起動コマンドを sleep 3600 に変更し、再起動をクリック — コンテナが稼働し続けるため、ファイルを編集できます
  3. 設定ファイルを修正 — ファイルタブで設定ファイル（/home/node/.openclaw/openclaw.json）を見つけて問題を修正
  4. 起動コマンドを /opt/openclaw/startup.sh && /opt/openclaw/start_gateway.sh に戻し、再起動をクリック

💡 ヘルパーページを有効にするには、このテンプレートから再デプロイしてください。

OpenClaw バージョンの更新

  1. OpenClaw releases で最新バージョンを確認
  2. Zeabur Dashboard で設定 → サービスイメージソースへ移動
  3. イメージ：ghcr.io/openclaw/openclaw、タグ：現在のバージョン（例：2026.2.26）から新バージョン（例：2026.3.7）に変更
  4. 再起動をクリックして適用

⚠️ タグに latest の使用は避けてください — 再起動のたびに最新バージョンが取得され、破壊的な変更や予期しないエラーが発生する可能性があります。安定性のために特定のバージョンを固定してください。

  1. ログタブで Gateway が正常に起動したか確認

💡 スタートアップスクリプトは起動時に設定を自動移行します — 不足している設定（trustedProxies、dangerouslyDisableDeviceAuth など）は自動追加されます。既存の設定は上書きされません。

"device identity required"

Control UI がまだ Gateway Token で認証されていないことを意味します。修正方法：

  • サービス URL を開く — ログインページが表示されます。Gateway Token を貼り付けて Connect をクリックしてください。
  • Gateway Token は Zeabur Dashboard の手順タブまたは環境変数（OPENCLAW_GATEWAY_TOKEN）で確認できます。

Gateway Token は Zeabur Dashboard の手順タブまたは環境変数（OPENCLAW_GATEWAY_TOKEN）で確認できます。

"disconnected (1008): pairing required"

お使いのデバイス（ブラウザ/アプリ）がまだ Gateway とペアリングされていないことを意味します。ペアリング方法：

  1. Control UI を開き、Gateway Token 認証を完了します（上記を参照）
  2. Zeabur ダッシュボードのコマンドを開いてターミナルにアクセスし、以下を実行：
    • openclaw devices list — ペアリング待ちのリクエストを確認し、requestId を取得
    • openclaw devices approve <requestId> — デバイスを承認

"non-loopback Control UI requires gateway.controlUi.allowedOrigins"

イメージを 2026.2.23 以降にアップグレードした際、設定ファイルを更新しないとこのエラーが発生します。修正方法：/home/node/.openclaw/openclaw.json を編集し、gateway.controlUi に "dangerouslyAllowHostHeaderOriginFallback": true を追加：

{
  "gateway": {
    "controlUi": {
      "dangerouslyAllowHostHeaderOriginFallback": true
    }
  }
}

その後、サービスを再起動してください。このテンプレートからの新規デプロイにはこの設定が含まれています。

Tailscale プライベートネットワークアクセス（オプション）

⚠️ この機能は新規デプロイのみに対応しています。旧バージョンのデプロイには Tailscale 起動スクリプトが含まれていないため、この機能を使用するにはテンプレートを再デプロイしてください。

パブリックドメインの代わりに、Tailscale を使用して OpenClaw をプライベートネットワーク（tailnet）内のみでアクセス可能にできます。パブリックインターネットへの公開は不要です。

前提条件：

  • Tailscale アカウント（無料プランで OK）
  • Tailscale Admin Console で Auth Key を作成（Reusable + Ephemeral 推奨）

ステップ 1：環境変数を設定 Zeabur ダッシュボードの環境変数タブで追加：

  • TS_AUTHKEY（必須）：Tailscale Auth Key（tskey-auth-xxx）。Tailscale Admin Console → Keys で作成してください。未設定の場合、Tailscale セットアップは完全にスキップされます。
  • TS_HOSTNAME（任意）：tailnet 上のマシン名で、アクセス URL を決定します（https://<TS_HOSTNAME>.<tailnet>.ts.net）。未設定の場合、デフォルトは openclaw です。

ステップ 2：起動コマンドを切替 設定 → コマンド で以下に変更：

/opt/openclaw/startup.sh && /opt/openclaw/start_gateway_tailscale.sh

サービスを再起動します。

ステップ 3：デバイスに Tailscale をインストール OpenClaw にアクセスするデバイスに Tailscale をインストールし（macOS、Windows、iOS、Android、Linux）、Auth Key を作成した同じ Tailscale アカウントでログインしてください。

ステップ 4：Control UI に初回ログイン 起動後、ブラウザで開きます（同じ tailnet のデバイスで）：

https://<TS_HOSTNAME>.<your-tailnet>.ts.net

tailnet DNS 名は Tailscale 管理コンソール → DNS で確認できます。完全な URL は Zeabur ダッシュボードのサービスログでも確認できます。

以下のいずれかの方法でログインしてください：

  • URL にトークンを追加：https://<TS_HOSTNAME>.<your-tailnet>.ts.net?token=<GATEWAY_TOKEN>
  • Control UI の Overview ページで Gateway Token を入力

Gateway Token は Zeabur ダッシュボードの手順タブまたは環境変数（OPENCLAW_GATEWAY_TOKEN）で確認できます。

ステップ 5：OpenClaw アプリの接続（オプション、macOS の例）

  1. Mac に OpenClaw for macOS と Tailscale をインストール
  2. OpenClaw アプリ → Settings → General → Remote モードを選択
  3. Transport を Direct (ws/wss) に設定
  4. Gateway URL に wss://<TS_HOSTNAME>.<your-tailnet>.ts.net を入力
  5. 初回接続時はペアリング承認が必要です — Control UI の Nodes ページで approve をクリック

iOS と Android のセットアップについては、公式ドキュメントを参照してください。

パブリックドメインモードに戻す： 起動コマンドを /opt/openclaw/startup.sh && /opt/openclaw/start_gateway.sh に戻して再起動してください。

Zeabur 固有の設定

このテンプレートは Zeabur クラウド環境向けに以下の設定を事前構成しています：

  • gateway.trustedProxies：["10.0.0.0/8", "172.16.0.0/12"] に設定。Gateway が Zeabur リバースプロキシ背後のクライアント IP を正しく識別できるようにします。未設定の場合、Control UI に「device identity required」エラーが表示される可能性があります。
  • dangerouslyDisableDeviceAuth：Control UI デバイスペアリングを無効化（デバイスペアリングはローカルネットワーク向けの機能で、クラウドデプロイでは代わりに Gateway Token 認証を使用）。
  • /usr/local/bin シンボリックリンク：openclaw、backup、restore コマンドが /usr/local/bin にシンボリックリンクされ、Zeabur のコマンドターミナルで直接使用できます。
  • OPENCLAW_DISABLE_BONJOUR=1：mDNS/Bonjour を無効化。Zeabur コンテナのホスト名が 63 バイトの DNS ラベル制限を超える可能性があるため。mDNS はローカルネットワーク検出にのみ使用され、クラウド環境では不要です。
  • OPENCLAW_TELEGRAM_DISABLE_AUTO_SELECT_FAMILY=true：コンテナ環境での Telegram 接続問題を修正（イメージバージョン 2026.2.17 以降で必要）。
  • TZ（任意）：IANA タイムゾーン文字列でコンテナのタイムゾーンを設定（例：Asia/Tokyo、America/New_York、Europe/London）。Zeabur ダッシュボードの環境変数タブから追加。未設定の場合は UTC がデフォルト。

ドキュメント

変更履歴

2026/3/27

  • イメージを 2026.3.24 にアップグレード — Gateway OpenAI 互換 API エンドポイント（/v1/models、/v1/embeddings）、Microsoft Teams SDK 移行とストリーミング応答、動画生成インフラ、gateway チャンネル起動分離、Telegram フォーラムトピック・写真サイズ修正、Docker 新規インストール修正、sandbox メディアディスパッチセキュリティ強化、WhatsApp・Discord・Slack・Feishu・plugin SDK にわたる 60 以上の修正

2026/3/23

  • イメージを 2026.3.22 にアップグレード — gateway SIGTERM shutdown 強化、Telegram 返信コンテキスト・トピック配信修正、memory ツール独立登録、provider runtime lazy boundary 修正、exec approvals / pairing / ネットワーク探索のセキュリティ強化

2026/3/15

  • イメージを 2026.3.13-1 にアップグレード — plugin-sdk メモリ膨張修正（OOM クラッシュ解消）、ブラウザセッション強化、cron セッションターゲット、セキュリティ・Telegram・Discord・Windows・macOS・設定検証に関する 50 以上の修正
  • ENABLE_CONTROL_UI デプロイ変数を追加 — gateway バインドモード（lan vs loopback）と Control UI アクセスを制御。デフォルト true
  • NODE_OPTIONS=--max-old-space-size=2048 を追加し、低メモリサーバーでの OOM を防止
  • 起動スクリプトの冗長項目を削除：HEARTBEAT.md 初期化、heartbeat ターゲット自動検出、CLI ラッパー、不要な export/権限設定、MEMORY.md 初期化（すべて OpenClaw がネイティブに処理）
  • Gateway 起動コマンドを node dist/index.js から内蔵 openclaw コマンドに変更
  • デプロイ変数の説明を改善、デフォルトモデル情報と 6 言語のローカライズ対応

2026/3/13

  • イメージを 2026.3.12 にアップグレード — Control UI ダッシュボード v2、GPT-5.4/Claude 高速モード、Ollama/vLLM/SGLang プロバイダープラグイン、K8s デプロイドキュメント、20 以上のセキュリティ修正（WebSocket origin 検証、exec approval 強化、plugin 自動ロードロックダウン）、cron delivery 引き締めと openclaw doctor --fix 移行、60 以上の新機能と 100 以上の修正、4 リリース分（2026.3.9–2026.3.12）
  • ⚠️ 破壊的変更：cron delivery が厳格化 — アップグレード後にコマンドで openclaw doctor --fix を実行してレガシー cron ストレージを移行してください
  • コンテナタイムゾーン設定用の TZ 環境変数ドキュメントを追加
  • 全ドキュメントで「Web UI」を「Control UI」に改名
  • 起動スクリプトからチャンネル環境変数の自動同期を削除（チャンネルプラグインは Settings から手動設定に変更）
  • 起動スクリプトから gateway config マイグレーションを削除（初期設定に必要な項目がすべて含まれているため）
  • ログインフローを簡素化：「Web UI (with token)」URL を削除し、Control UI ログインページで Gateway Token を入力する方式に変更

2026/3/10

  • Add Homebrew pre-installation: touch /.dockerenv and Homebrew install script now run on every container startup, enabling brew package management inside the container
  • Add Go 1.22.3 pre-installation (persisted under /home/node/go)
  • Remove macOS software warning (Homebrew is now available)
  • Homebrew and Go are persisted on the mounted volume and skip re-installation on restart

2026/3/9

  • イメージを 2026.3.8 にアップグレード — CLI バックアップ（openclaw backup create / openclaw backup verify）、Talk モードサイレンスタイムアウト設定、Brave LLM-context ウェブ検索、ACP プロベナンスメタデータ、Telegram DM 重複排除、ブラウザ CDP 修正、gateway 再起動/設定ガード、30 以上の新機能と 40 以上の修正
  • バックアップドキュメントに openclaw backup create と openclaw backup verify の説明を追加（組み込み CLI バックアップ、設定のみモードとアーカイブ検証対応）

2026/3/8

  • イメージを 2026.3.7 にアップグレード — context engine プラグインインターフェース、ACP 永続チャネルバインディング、Telegram トピックエージェントルーティング、Docker マルチステージビルド、gateway SecretRef サポート、5 リリース（2026.3.3–2026.3.7）にわたる 30 以上の新機能と 40 以上の修正
  • ⚠️ 破壊的変更：gateway.auth.token と gateway.auth.password の両方が設定されている場合、gateway.auth.mode の明示的な設定が必要 — テンプレートは mode: "token" をプリセット（既存デプロイは起動時に自動移行）
  • Zeabur AI Hub モデル追加：gemini-3.1-pro-preview、gemini-3.1-flash-lite-preview、gemini-3.1-flash-image-preview、kimi-2.5
  • 明示的な gateway.auth.mode: "token" を設定（将来の gateway 認証変更への防御）
  • gateway 起動スクリプトから冗長な --port フラグを削除（ポートは環境変数/設定/デフォルトから自動解決）

2026/3/4

  • イメージを 2026.3.2 にアップグレード — PDF ツール、Ollama 埋め込み、Telegram ストリーミングデフォルトを partial に変更、コンテナヘルスエンドポイント（/healthz）、OpenAI WebSocket 優先トランスポート、3 リリース（2026.3.1、2026.3.2）にわたる 200 以上の修正と 20 以上のセキュリティ強化
  • ⚠️ 破壊的変更：api.registerHttpHandler(...) を使用するプラグインは api.registerHttpRoute(...) に移行が必要、Zalouser チャネルは再ログインが必要（openclaw channels login --channel zalouser）

2026/3/2

  • Zeabur AI Hub モデルサポート追加：claude-opus-4-6、minimax-m2.5、step-3.5-flash
  • モデル入替：llama-3.3-70b → llama-3.1-8b、qwen-3-32 → qwen-3-235b
  • API キーローテーション修正：ZEABUR_AI_HUB_API_KEY 変更後、再起動で反映（envsubst を削除、ランタイムで ${VAR} を解決）
  • Provider 設定ファイルを起動ごとに /opt から同期 — テンプレートのモデル更新や Configs 編集が再起動後に反映
  • セキュリティノートに OPENCLAW_GATEWAY_BIND=loopback のガイダンスを追加

2026/2/27

  • dangerouslyDisableDeviceAuth を追加 — クラウドデプロイでデバイスペアリングの代わりに Gateway Token 認証を使用
  • デフォルトモデル：zeabur-ai/glm-4.7-flash、フェイルオーバーチェーン（grok-4-fast-non-reasoning → minimax-m2.5 → kimi-k2.5 → qwen-3-235b → gpt-5-mini）
  • モデル切替、フェイルオーバー、外部プロバイダーのドキュメントを追加
  • 環境変数の整理（デフォルト値をスタートアップスクリプトに移動）
  • 既存設定の自動移行（trustedProxies、認証設定）
  • イメージを 2026.2.26 にアップグレード — Telegram DM allowlist 継承修正、コンテナ temp dir パーミッション修正、非 root Docker での CLI gateway --force 修正、Gemini model ID 正規化、追加のセキュリティ強化

2026/2/26

  • イメージを 2026.2.25 にアップグレード — 2026.2.23→2026.2.25 で 100 以上のセキュリティ修正、新プロバイダー（Kilo Gateway、Mistral、Volcano Engine）、heartbeat directPolicy 設定、gateway WebSocket 認証強化、クロスチャネルルーティング分離、Discord 音声 DAVE の信頼性向上、Telegram webhook ハング修正、多数の安定性改善を含む

2026/2/24

  • イメージを 2026.2.23 にアップグレード — 30 以上のセキュリティ修正、新プロバイダー（Kilo Gateway、Mistral、Volcano Engine）、統一チャネルストリーミング設定、多言語ストップフレーズ、全チャネルでの reasoning/thinking フィルタリング、多数の安定性改善を含む
  • Control UI 設定に dangerouslyAllowHostHeaderOriginFallback を追加 — 2026.2.23 以降、非 loopback デプロイに必須

2026/2/22

  • ヘルスチェックを自動再起動ラッパーに置換：Gateway クラッシュ時に自動再起動し、エラー情報と修復手順を含むヘルパーページを表示（5秒ごとにサービス復旧を検出）
  • レスキューモード（rescue.sh）を削除 — ヘルパーページに置換

2026/2/20

  • イメージタグを 2026.2.19 に固定 — OPENCLAW_TELEGRAM_DISABLE_AUTO_SELECT_FAMILY=true 環境変数を追加し Telegram 接続の問題を修正（イメージバージョン 2026.2.17 以降で必要）

2026/2/16

  • イメージタグを latest に切替、迅速なセキュリティ修正に追従するため

2026/2/15

  • Tailscale プライベートネットワークアクセスを追加：start_gateway_tailscale.sh に切替で tailnet 経由のプライベート HTTPS アクセスが可能（パブリックインターネットへの公開不要）
  • イメージを 2026.2.14 にアップグレード

2026/2/10

  • 画像生成 skill を修正：/v1/chat/completions API に切替、デフォルトモデルを gemini-2.5-flash-image に変更
  • gpt-oss-120b、llama-3.3-70b、qwen-3-32 の HTTP 500 を修正：supportsStore: false 互換性設定を追加
  • gpt-oss-120b の reasoning フラグを修正（true に設定）
  • リストアスクリプトが .zip 形式に対応（Zeabur バックアップサービス）

2026/2/7

  • cron スケジュールの通知が送信されない問題を修正：起動時に設定済みチャンネルを heartbeat 配信先として自動検出
  • 新規デプロイで HEARTBEAT.md を実行可能な内容で初期化（空ファイルによる heartbeat スキップを防止）

2026/2/4

  • Zeabur configs でスタートアップスクリプトを管理（メンテナンスが容易に）
  • backup と restore グローバルコマンドを追加
  • 自動再起動ラッパーとフォールバックページを追加（Gateway クラッシュ時の自動復旧）
  • Zeabur AI Hub に 6 つのモデルを追加：gpt-5.2, gpt-5.1, gpt-5-nano, glm-4.7, glm-4.7-flash, kimi-k2.5
  • Zeabur AI Hub の Claude モデルに store 互換性設定を追加

2026/2/2

  • AI モデル設定セクションを追加（グローバル vs 会話ごとの設定）
  • バックアップと復元セクションを追加、Zeabur バックアップサービス対応
  • 初期設定完了後のバックアップ推奨を追加
  • Google Gemini CLI パッチを削除（上流で修正済み）
  • デプロイ時の ANTHROPIC_API_KEY と OPENAI_API_KEY 変数を削除、OpenClaw が空の API Key を検出して実行に失敗するのを防止（後で Control UI または環境変数から設定可能）