
ZeaburOpenClaw 🦞(旧 Clawdbot、Moltbot)は、ローカルで実行され、WebSocket ベースの Gateway アーキテクチャを介して複数のメッセージングプラットフォームに接続する個人用 AI アシスタントです。
⚠️ 本テンプレートは ghcr.io/openclaw/openclaw:2026.3.7 を使用しています。OpenClaw 🦞 は急速に開発中のため、未発見のバグがある可能性があります。バージョンを変更した場合も安定性を保証できません。
⚠️ 問題が発生した場合は、GitHub issues で解決策を探したり、新しい問題を報告したりしてください。Zeabur プラットフォーム関連の問題については、Zeabur サポートにお問い合わせください。
⚠️ macOS 固有のソフトウェアやパッケージ(Homebrew など)はこのコンテナ環境ではサポートされていません。代替ソリューションをお探しください。
⚠️ このテンプレートは Zeabur の専用サーバーが必要です。共有クラスターでは実行できません。
⚠️ 本テンプレートは事前設定済みですぐに使用できます。openclaw onboard を実行する必要はありません。再設定する場合は、Zeabur ダッシュボードのコマンドから実行してください:
openclaw onboard --gateway-bind lan
全フラグは Wizard Reference を参照してください。
glm-4.7-flash):デプロイ時に API Key を入力済みの場合、ステップ 3 へ進む。後から Zeabur ダッシュボードの変数タブで ZEABUR_AI_HUB_API_KEY を追加も可能(追加後はサービスを再起動)。anthropic/claude-opus-4-6 です。Web UI Settings または環境変数で API キーを追加してください。詳細:https://docs.openclaw.ai/providers/anthropicAI モデル設定については公式ドキュメントをご覧ください。
このテンプレートにはフェイルオーバーモデルが含まれており、プライマリモデルが利用できない場合に自動的に切り替わります。デフォルトチェーン:glm-4.7-flash → grok-4-fast-non-reasoning → minimax-m2.5 → kimi-k2.5 → qwen-3-235b → gpt-5-mini。
Web UI Chat または Zeabur ダッシュボードのコマンドからモデルを管理できます。
Web 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 モデル追加後サービスを再起動し、モデルを切り替え:
/model anthropic/claude-opus-4-6openclaw 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-..." }
}
}
対応プロバイダーの一覧は公式ドキュメントをご覧ください。
BotFather からトークンを取得:
/newbot を送信して新しいボットを作成123456789:ABCdefGHIjklMNOpqrsTUVwxyz)Zeabur にトークンを追加:
TELEGRAM_BOT_TOKEN を追加してトークンを入力"plugins": { "entries": { "telegram": { "enabled": true } } }。無効にするには enabled を false に設定します。Telegram アカウントのペアリング:
/start を送信JN4MSY23)openclaw pairing approve telegram <コード> を入力openclaw pairing approve telegram <コード> を実行Approved telegram sender <user-id>. と表示されればペアリング完了ステップ 1:WhatsApp チャンネルを設定 OpenClaw Web UI(Settings → Config)またはチャットに貼り付けて以下の設定を追加:
"channels": {
"whatsapp": {
"selfChatMode": true,
"dmPolicy": "allowlist",
"allowFrom": ["+15551234567"]
}
}
+15551234567 をあなたの WhatsApp 電話番号(国番号付き)に置き換えてください。保存後にサービスを再起動してください。
ステップ 2:WhatsApp をリンク
openclaw channels loginLINE Messaging API チャンネルの作成:
Zeabur に認証情報を追加:
LINE_CHANNEL_ACCESS_TOKEN を追加して Channel access token を入力LINE_CHANNEL_SECRET を追加して Channel secret を入力"plugins": { "entries": { "line": { "enabled": true } } }Webhook の設定:
https://<your-domain>/line/webhook ですhttps://<your-domain>/line/webhook に設定LINE アカウントのペアリング:
JN4MSY23)openclaw pairing approve line <コード> を入力openclaw pairing approve line <コード> を実行Approved line sender <user-id>. と表示されればペアリング完了その他のメッセージングプラットフォーム(Discord、Slack など)については、Channels ドキュメントをご覧ください。
セットアップの確認:
zeabur-ai/glm-4.7-flashanthropic/claude-opus-4-6(API キーが必要)現在の会話のモデルを切り替え(チャットコマンドで):
/models - 利用可能なモデルを表示/model <model-id> - この会話のみモデルを切り替え(他の会話には影響しません)全ての新しい会話のデフォルトモデルを変更(Web UI Settings で):
gemini-2.5-flash-lite、gpt-5-nano)。モデルが使用できなくなった場合、/new で新しい会話を開始すればデフォルトモデルに自動的に戻ります。AI プロバイダーを追加(Web UI Settings または環境変数で):
Zeabur AI Hub モデルを変更(Zeabur ダッシュボードで):
/opt/openclaw/providers/zeabur-ai-hub.json5 を編集し、サービスを再起動(変更は起動時に同期されます)/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 }
Web UI は設定、監視、チャットのための管理ツールです — メッセージングプラットフォーム(Telegram、WhatsApp、Discord など)は Web UI なしで独立して動作します。インバウンド Webhook が不要なプラットフォーム(Telegram、WhatsApp、Discord、Signal、iMessage)のみを使用する場合は、Zeabur ダッシュボードのネットワークタブでドメインバインディングを削除し、Gateway をパブリックインターネットに公開しないようにできます。すべての管理操作は Zeabur のコマンドターミナルで CLI を使って実行できます(openclaw config set、openclaw models set など)。パブリックドメインなしで Web UI にアクセスするには、Tailscale プライベートネットワークアクセスを参照してください。さらに、変数タブで OPENCLAW_GATEWAY_BIND を loopback に設定し(設定後サービスを再起動)、Gateway をローカル接続のみに制限することもできます。
パブリックドメインが必要なプラットフォーム(インバウンド Webhook):LINE、Slack、Google Chat。
すべてのデータは /home/node に保存:
/home/node/.openclaw - 設定、セッション、デバイス、認証情報/home/node/.openclaw/workspace - ワークスペースとメモリファイル💡 ヒント: 初期設定完了後や重要な設定変更後にバックアップを作成することをお勧めします。
バックアップ:
backup を実行 → ファイルタブの /home/node からダウンロード(例:backup-1430.tar.gz)
cd /home/node && tar -czvf backup.tar.gz .openclaw復元:
/home/node フォルダにアップロードrestore <バックアップファイル名> --strip 2(例:restore data-2026-02-27.zip --strip 2)restore <バックアップファイル名>(例:restore backup-1430.tar.gz)cd /home/node && tar -xzvf <バックアップファイル名>/home/node にアップロードしたバックアップファイルを削除し、ディスク容量を解放⚠️ 復元すると、新サービス上の既存の設定とデータが上書きされます。関連する環境変数(例:TELEGRAM_BOT_TOKEN)も忘れずに設定してください。チャンネルのバックアップ復元は現在 Telegram と WhatsApp でのみテスト済みです。
デフォルトの起動コマンド:
/opt/openclaw/startup.sh && /opt/openclaw/start_gateway.sh
Gateway が停止すると、サービスURLにエラー情報と修復手順を含むヘルパーページが表示されます:
/home/node/.openclaw/openclaw.json)を見つけて問題を修正ヘルパーページがないデプロイの場合は、以下の手順に従ってください:
sleep 3600 に変更し、再起動をクリック — コンテナが稼働し続けるため、ファイルを編集できます/home/node/.openclaw/openclaw.json)を見つけて問題を修正/opt/openclaw/startup.sh && /opt/openclaw/start_gateway.sh に戻し、再起動をクリック💡 ヘルパーページを有効にするには、このテンプレートから再デプロイしてください。
ghcr.io/openclaw/openclaw、タグ:現在のバージョン(例:2026.2.26)から新バージョン(例:2026.3.7)に変更⚠️ タグに
latestの使用は避けてください — 再起動のたびに最新バージョンが取得され、破壊的な変更や予期しないエラーが発生する可能性があります。安定性のために特定のバージョンを固定してください。
💡 スタートアップスクリプトは起動時に設定を自動移行します — 不足している設定(
trustedProxies、dangerouslyDisableDeviceAuthなど)は自動追加されます。既存の設定は上書きされません。
Web UI がまだ Gateway Token とペアリングされていないことを意味します。修正方法:
Gateway Token は Zeabur Dashboard の手順タブまたは環境変数(OPENCLAW_GATEWAY_TOKEN)で確認できます。
お使いのデバイス(ブラウザ/アプリ)がまだ Gateway とペアリングされていないことを意味します。ペアリング方法:
openclaw devices list — ペアリング待ちのリクエストを確認し、requestId を取得openclaw devices approve <requestId> — デバイスを承認イメージを 2026.2.23 以降にアップグレードした際、設定ファイルを更新しないとこのエラーが発生します。修正方法:/home/node/.openclaw/openclaw.json を編集し、gateway.controlUi に "dangerouslyAllowHostHeaderOriginFallback": true を追加:
{
"gateway": {
"controlUi": {
"dangerouslyAllowHostHeaderOriginFallback": true
}
}
}
その後、サービスを再起動してください。このテンプレートからの新規デプロイにはこの設定が含まれています。
⚠️ この機能は新規デプロイのみに対応しています。旧バージョンのデプロイには Tailscale 起動スクリプトが含まれていないため、この機能を使用するにはテンプレートを再デプロイしてください。
パブリックドメインの代わりに、Tailscale を使用して OpenClaw をプライベートネットワーク(tailnet)内のみでアクセス可能にできます。パブリックインターネットへの公開は不要です。
前提条件:
ステップ 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:Web UI に初回ログイン 起動後、ブラウザで開きます(同じ tailnet のデバイスで):
https://<TS_HOSTNAME>.<your-tailnet>.ts.net
tailnet DNS 名は Tailscale 管理コンソール → DNS で確認できます。完全な URL は Zeabur ダッシュボードのサービスログでも確認できます。
以下のいずれかの方法でログインしてください:
https://<TS_HOSTNAME>.<your-tailnet>.ts.net?token=<GATEWAY_TOKEN>Gateway Token は Zeabur ダッシュボードの手順タブまたは環境変数(OPENCLAW_GATEWAY_TOKEN)で確認できます。
ステップ 5:OpenClaw アプリの接続(オプション、macOS の例)
wss://<TS_HOSTNAME>.<your-tailnet>.ts.net を入力iOS と Android のセットアップについては、公式ドキュメントを参照してください。
パブリックドメインモードに戻す:
起動コマンドを /opt/openclaw/startup.sh && /opt/openclaw/start_gateway.sh に戻して再起動してください。
このテンプレートは Zeabur クラウド環境向けに以下の設定を事前構成しています:
gateway.trustedProxies:["10.0.0.0/8", "172.16.0.0/12"] に設定。Gateway が Zeabur リバースプロキシ背後のクライアント IP を正しく識別できるようにします。未設定の場合、Web UI に「device identity required」エラーが表示される可能性があります。dangerouslyDisableDeviceAuth:Web 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 以降で必要)。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" をプリセット(既存デプロイは起動時に自動移行)gemini-3.1-pro-preview、gemini-3.1-flash-lite-preview、gemini-3.1-flash-image-preview、kimi-2.5gateway.auth.mode: "token" を設定(将来の 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
claude-opus-4-6、minimax-m2.5、step-3.5-flashllama-3.3-70b → llama-3.1-8b、qwen-3-32 → qwen-3-235bZEABUR_AI_HUB_API_KEY 変更後、再起動で反映(envsubst を削除、ランタイムで ${VAR} を解決)/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)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 フィルタリング、多数の安定性改善を含むdangerouslyAllowHostHeaderOriginFallback を追加 — 2026.2.23 以降、非 loopback デプロイに必須2026/2/22
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
start_gateway_tailscale.sh に切替で tailnet 経由のプライベート HTTPS アクセスが可能(パブリックインターネットへの公開不要)2026.2.14 にアップグレード2026/2/10
/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 バックアップサービス)TELEGRAM_BOT_TOKEN、DISCORD_BOT_TOKEN、SLACK_BOT_TOKEN、SLACK_APP_TOKEN、LINE_CHANNEL_ACCESS_TOKEN、LINE_CHANNEL_SECRET)を設定ファイルに同期2026/2/7
2026/2/4
backup と restore グローバルコマンドを追加2026/2/2
Zeabur