OpenClaw 🦞

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

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

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

⚠️ macOS 固有のソフトウェアやパッケージ（Homebrew など）はこのコンテナ環境ではサポートされていません。代替ソリューションをお探しください。

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

⚠️ 本テンプレートは事前設定済みですぐに使用できます。セットアップウィザードを実行する必要はありません。ウィザードを実行する場合は、bind を lan モードに設定するか、公式ドキュメントを参照してより高度な設定を行ってください。

推奨リソース

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

機能拡張

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

使用方法

デプロイ後、指示タブの「Web UI (with token)」URL をコピーしてブラウザに貼り付けて開く（初回ログインは token が必要、以降は直接 URL にアクセス可能）
AI モデルを設定（いずれかを選択）：
- Zeabur AI Hub（デフォルトモデル：gpt-5-mini）：デプロイ時に API Key を入力済みの場合、ステップ 3 へ進む。後から Zeabur ダッシュボードの変数タブで ZEABUR_AI_HUB_API_KEY を追加も可能（追加後はサービスを再起動）。
- 他のプロバイダー（Anthropic、OpenAI など）：Zeabur AI Hub API Key を入力しなかった場合、デフォルトモデルは anthropic/claude-opus-4-5 です。Web UI Settings または環境変数で API キーを追加してください。詳細：https://docs.openclaw.ai/providers/anthropic
Chat ページで AI モデルが正常に動作しているかテスト
（オプション）Telegram、WhatsApp などのメッセージングプラットフォームを設定

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

Telegram ボット設定

BotFather からトークンを取得：

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

Zeabur にトークンを追加：

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

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

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

WhatsApp セットアップ

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

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

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

ステップ 2：WhatsApp をリンク

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

LINE ボット設定

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

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

Zeabur に認証情報を追加：

Zeabur ダッシュボードのサービス変数タブに移動
LINE_CHANNEL_ACCESS_TOKEN を追加して Channel access token を入力
LINE_CHANNEL_SECRET を追加して Channel secret を入力
サービスを再起動
再起動後、LINE プラグインが自動的に有効化されます。ボットが起動しない場合は、Settings → Config でプラグインが有効になっているか確認してください："plugins": { "entries": { "line": { "enabled": true } } }

Webhook の設定：

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

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

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

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

AI モデル設定

セットアップの確認：

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

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

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

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

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

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

他の AI プロバイダーの API キーを追加（例：Anthropic、OpenAI）
詳細：https://docs.openclaw.ai/providers

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

設定 → 設定ファイル → /opt/openclaw/providers/zeabur-ai-hub.json5 を編集
旧バージョン（コマンドなし）：ファイル タブまたは Web 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.5, "output": 12, "cacheRead": 0.15, "cacheWrite": 0 }, "contextWindow": 400000, "maxTokens": 8192 },
{ "id": "gpt-5.1", "name": "GPT-5.1", "reasoning": false, "input": ["text", "image"], "cost": { "input": 1.35, "output": 11, "cacheRead": 0.14, "cacheWrite": 0 }, "contextWindow": 400000, "maxTokens": 8192 },
{ "id": "gpt-5-nano", "name": "GPT-5 Nano", "reasoning": false, "input": ["text", "image"], "cost": { "input": 0.1, "output": 0.8, "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.5, "output": 2, "cacheRead": 0.12, "cacheWrite": 0 }, "contextWindow": 204800, "maxTokens": 8192 },
{ "id": "glm-4.7-flash", "name": "GLM-4.7 Flash", "reasoning": false, "input": ["text", "image"], "cost": { "input": 0.25, "output": 1, "cacheRead": 0.06, "cacheWrite": 0 }, "contextWindow": 204800, "maxTokens": 8192 },
{ "id": "kimi-k2.5", "name": "Kimi K2.5", "reasoning": false, "input": ["text"], "cost": { "input": 0.45, "output": 2, "cacheRead": 0, "cacheWrite": 0 }, "contextWindow": 131072, "maxTokens": 8192 }

データ永続化

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

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

バックアップと復元

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

バックアップ：

方法1：Zeabur バックアップサービス（推奨） - Zeabur の組み込みバックアップ機能を使用。Zeabur バックアップドキュメントを参照。
方法2：手動バックアップ - コマンドを開く → backup を実行 → ファイルタブの /home/node からダウンロード（例：backup-1430.tar.gz）
- 旧バージョン（コマンドなし）：cd /home/node && tar -czvf backup.tar.gz .openclaw

復元：

ファイルタブでバックアップファイルを /home/node フォルダにアップロード
コマンドを開いて実行：
- Zeabur バックアップサービスのファイル：restore <バックアップファイル名> --strip 2
- 手動バックアップのファイル：restore <バックアップファイル名>
- 旧バージョン（コマンドなし）：cd /home/node && tar -xzvf <バックアップファイル名>
サービスを再起動

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

Clawdbot / Moltbot からの移行

旧バージョン（コマンドなし）のデータ場所：

Clawdbot：設定 ~/.clawdbot、ワークスペース ~/clawd
Moltbot：設定 ~/.moltbot または ~/.clawdbot、ワークスペース ~/clawd

新しい OpenClaw の場所：/home/node/.openclaw（設定とワークスペースを含む）

OpenClaw は下位互換性があり、.clawdbot と .moltbot フォルダを自動的に読み取ります。そのまま解凍するだけで使用でき、名前変更は不要です。

移行手順：

旧サービスでデータをバックアップ：
- 旧サービスでコマンドを開く
- cd /home/node && tar -czvf backup.tar.gz .clawdbot .moltbot clawd 2>/dev/null（存在しないフォルダは無視）
- ファイルタブから backup.tar.gz をダウンロード
この新しい OpenClaw テンプレートをデプロイ
バックアップを新サービスに復元：
- backup.tar.gz をファイルタブの /home/node フォルダにドラッグ
- コマンドを開く：cd /home/node && tar -xzvf backup.tar.gz && rm backup.tar.gz
- サービスを再起動
設定、会話履歴、認証情報は保持されます

下位互換性のため、clawdbot と moltbot CLI コマンドは引き続き使用可能です。

トラブルシューティング

設定ファイルの変更でサービスが起動しない？ レスキューモードを使用：

設定 → コマンド に移動、変更：/opt/openclaw/rescue.sh（旧バージョンはコマンドがないため sleep infinity を使用）
設定 → ヘルスチェック に移動、無効化（レスキューモードはヘルスチェックに応答しません）
サービスを再起動 - コンテナは実行されますが OpenClaw は起動しません
ファイル タブを開いてファイルブラウザにアクセス
ログでエラー原因を確認。例：Invalid config at /home/node/.openclaw/openclaw.json: - agents.list.0: Unrecognized key: "allowModels" — ファイルブラウザで /home/node/.openclaw/openclaw.json を修正するか、コマンドを開いて openclaw doctor --fix を実行して認識できないキーを自動削除
スタートコマンドを戻す：/opt/openclaw/startup.sh && /opt/openclaw/start_gateway.sh
- 旧バージョン（コマンドなし）：node dist/index.js gateway --allow-unconfigured --bind "${OPENCLAW_GATEWAY_BIND}" --port "${OPENCLAW_GATEWAY_PORT}" --token "${OPENCLAW_GATEWAY_TOKEN}"
ヘルスチェックを再有効化してサービスを再起動

バージョン更新： 設定タブ → サービスイメージソース → ghcr.io/openclaw/openclaw:<tag> を編集してください。

ヘルスチェックエラー Startup probe failed: dial tcp ... connect: connection refused？ サービスがまだ起動完了していないか、ポートが準備できていません。OpenClaw は起動に時間がかかる場合があります（特に初回起動時）。対処法：

数分待つ — サービスがまだ初期化中の可能性があります
エラーが続く場合、リソースを増やす（最小 2 vCPU / 4 GB RAM、推奨 4 vCPU / 8 GB RAM）
サービスが繰り返し再起動する場合、ヘルスチェックを一時的に無効化して再起動ループを防ぎ、ログで実際のエラーを確認

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：Web UI に初回ログイン 起動後、ブラウザで開きます（同じ tailnet のデバイスで）：

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

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

初回アクセス時は「pairing required」と表示されます。以下のいずれかの方法でログインしてください：

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

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

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

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

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

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

Zeabur 固有の設定

このテンプレートでは mDNS/Bonjour を無効化しています（OPENCLAW_DISABLE_BONJOUR=1）。Zeabur コンテナのホスト名が 63 バイトの DNS ラベル制限を超える可能性があるためです。mDNS はローカルネットワーク検出（AirPlay/Chromecast のような）にのみ使用され、クラウド環境ではサービスは内部 DNS を通じて接続するため、この機能は不要です。

ドキュメント

ドキュメント：https://docs.openclaw.ai
GitHub：https://github.com/openclaw/openclaw

変更履歴

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 バックアップサービス）
起動時にチャンネル環境変数（TELEGRAM_BOT_TOKEN、DISCORD_BOT_TOKEN、SLACK_BOT_TOKEN、SLACK_APP_TOKEN、LINE_CHANNEL_ACCESS_TOKEN、LINE_CHANNEL_SECRET）を設定ファイルに同期

2026/2/7

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

2026/2/4

Zeabur configs でスタートアップスクリプトを管理（メンテナンスが容易に）
backup と restore グローバルコマンドを追加
rescue.sh レスキューモードを追加（設定ファイルが壊れた時に使用）
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 会話ごとの設定）
Clawdbot / Moltbot からの移行ガイドとデータパスを追加
バックアップと復元セクションを追加、Zeabur バックアップサービス対応
初期設定完了後のバックアップ推奨を追加
Google Gemini CLI パッチを削除（上流で修正済み）
デプロイ時の ANTHROPIC_API_KEY と OPENAI_API_KEY 変数を削除、OpenClaw が空の API Key を検出して実行に失敗するのを防止（後で Web UI または環境変数から設定可能）

quickActions

機能

リソース

コミュニティ

OpenClaw 🦞

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

OpenClaw 🦞

推奨リソース

機能拡張

使用方法

Telegram ボット設定

WhatsApp セットアップ

LINE ボット設定

AI モデル設定

データ永続化

バックアップと復元

Clawdbot / Moltbot からの移行

トラブルシューティング

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

Zeabur 固有の設定

ドキュメント

変更履歴

サービス

OpenClaw