FAQ：初回セットアップ

使用中のマシンを確認できるローカルAIエージェントを使用してください。「行き詰まった」 ケースの大半は、リモートの支援者が確認できないローカル設定や環境の問題であるため、 Discordで質問するより効果的です。

• Claude Code: https://www.anthropic.com/claude-code/
• OpenAI Codex: https://openai.com/codex/

エージェントがコードとドキュメントを読み、実行中の正確なバージョンについて判断できるように、 ハッカブル（git）インストールでソースチェックアウト全体を渡します。

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git

エージェントに修正を段階的に計画、監督させてから、必要なコマンドだけを 実行してください。差分が小さいほど監査しやすくなります。

サポートを求める際（DiscordまたはGitHub issue）には、次の出力を共有してください。

実際のバグや修正を見つけた場合は、issueを作成するかPRを送信してください。 Issue / プルリクエスト。

クイックデバッグ手順：問題発生時の最初の60秒。 インストールドキュメント：インストール、インストーラーフラグ、更新。

古いHeartbeatのtasks:ブロックは、openclaw doctor --fixを使用して個別にスケジュールされたCronジョブへ移行されます。

ドキュメント：Heartbeat、自動化。

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bashopenclaw onboard --install-daemon

ソースから（コントリビューター/開発者向け）：

git clone https://github.com/openclaw/openclaw.gitcd openclawpnpm installpnpm buildpnpm ui:buildopenclaw onboard

まだグローバルインストールしていない場合は、代わりにpnpm openclaw onboardを実行してください。Control UIアセットが ない場合、オンボーディングは自身でビルドを試み、失敗するとpnpm ui:buildにフォールバックします。

オンボーディングはセットアップ直後に、クリーンな（トークン化されていない）ダッシュボードURLをブラウザーで開き、 概要にリンクを表示します。そのタブは開いたままにしてください。起動しなかった場合は、 表示されたURLを同じマシン上でコピー＆ペーストしてください。

localhost（同じマシン）：

• http://127.0.0.1:18789/を開きます。
• 共有シークレット認証を求められた場合は、設定済みのトークンまたはパスワードをControl UI設定に貼り付けます。
• トークンの取得元：gateway.auth.token（またはOPENCLAW_GATEWAY_TOKEN）。
• パスワードの取得元：gateway.auth.password（またはOPENCLAW_GATEWAY_PASSWORD）。
• 共有シークレットがまだ設定されていない場合は、openclaw doctor --generate-gateway-token（またはopenclaw doctor --fix --generate-gateway-token）を実行します。

localhost以外：

• Tailscale Serve（推奨）：バインドをループバックのままにし、openclaw gateway --tailscale serveを実行してhttps://<magicdns>/を開きます。gateway.auth.allowTailscale: trueを使用すると、IDヘッダーによってControl UI/WebSocket認証が満たされます（共有シークレットを貼り付ける必要はなく、信頼できるGatewayホストを前提とします）。HTTP APIでは、プライベートイングレスのnoneまたは信頼できるプロキシのHTTP認証を意図的に使用しない限り、引き続き共有シークレット認証が必要です。 同じクライアントから同時に行われた不正な認証のServe試行は、認証失敗リミッターに記録される前に直列化されるため、2回目の不正な再試行ではすでにretry laterが表示される場合があります。
• Tailnetバインド：openclaw gateway --bind tailnet --token "<token>"を実行（またはパスワード認証を設定）し、http://<tailscale-ip>:18789/を開いて、一致する共有シークレットをダッシュボード設定に貼り付けます。
• ID認識リバースプロキシ：Gatewayを信頼できるプロキシの背後に配置し、gateway.auth.mode: "trusted-proxy"を設定してプロキシURLを開きます。同一ホストのループバックプロキシでは、明示的なgateway.auth.trustedProxy.allowLoopback: trueが必要です。
• SSHトンネル：ssh -N -L 18789:127.0.0.1:18789 user@gateway-hostを実行してから、http://127.0.0.1:18789/を開きます。トンネル経由でも共有シークレット認証が適用されます。求められた場合は、設定済みのトークンまたはパスワードを貼り付けてください。

バインドモードと認証の詳細については、ダッシュボードおよびWebサーフェスを参照してください。

それぞれ異なるレイヤーを制御します。

• approvals.exec - 承認プロンプトをチャットの送信先へ転送します。
• channels.<channel>.execApprovals - そのチャネルをexec承認用のネイティブ承認クライアントにします。

ホストのexecポリシーが引き続き実際の承認ゲートです。チャット設定は、 プロンプトの表示先と、利用者が応答する方法のみを制御します。

両方が必要になることはほとんどありません。

• チャットがすでにコマンドと返信をサポートしている場合、同じチャット内の/approveは共有パスを通じて機能します。
• サポート対象のネイティブチャネルが承認者を安全に推測できる場合、channels.<channel>.execApprovals.enabledが未設定または"auto"であれば、OpenClawはDM優先のネイティブ承認を自動的に有効にします。
• ネイティブの承認カード/ボタンが使用できる場合は、そのUIが優先されます。ツールの結果でチャット承認が利用できないと示された場合にのみ、手動の/approveコマンドに言及してください。
• プロンプトを他のチャットや明示的な運用ルームにも送る必要がある場合にのみ、approvals.execを使用します。
• 承認プロンプトを送信元のルーム/トピックへ投稿し直したい場合にのみ、channels.<channel>.execApprovals.target: "channel"または"both"を使用します。
• Pluginの承認は別です。デフォルトでは同じチャット内の/approveを使用し、必要に応じてapprovals.pluginで転送できます。また、それらについてもネイティブ処理を維持するのは一部のネイティブチャネルだけです。

要するに、転送はルーティング用、ネイティブクライアント設定はチャネル固有のより充実したUX用です。 Exec承認を参照してください。

Node 22.22.3+、24.15+、または**25.9+**が必要です（Node 24推奨）。pnpmはリポジトリのパッケージマネージャーです。 Bunは依存関係のインストールとパッケージスクリプトの実行が可能ですが、node:sqliteがないため、OpenClaw CLIまたはGatewayは実行できません。

はい。ただし、まずRAMを確認してください。Pi 5およびPi 4（2 GB以上）が最適です。Pi 3B+（1 GB）は動作しますが低速です。Pi Zero 2 W（512 MB）は推奨されません。

絶対的な最小要件は、RAM 1 GB、1コア、空きディスク容量500 MB、64ビットOSです。Piは Gatewayのみを実行する（モデルはクラウドAPIを呼び出す）ため、控えめな性能のPiでも負荷を処理できます。

小型のPi/VPSでGatewayだけをホストし、ノートPC/スマートフォン上のNodeを ペアリングして、ローカルの画面/カメラ/キャンバスまたはコマンド実行に使用することもできます。Nodeを参照してください。

セットアップの完全な手順：Raspberry Pi。

• 64ビットOSを使用してください。32ビット版Raspberry Pi OSは使用しないでください。
• 2 GB以下のボードではスワップを追加してください。
• パフォーマンスと耐久性のため、SDカードよりもUSB SSDを推奨します。
• ログを確認してすばやく更新できるよう、ハッカブル（git）インストールを推奨します。
• チャネル/Skillsなしで開始し、1つずつ追加してください。
• 奇妙なバイナリエラー（「exec format error」）は、通常、オプションのSkillsツールにARM64ビルドがないことが原因です。

完全なガイド：Raspberry Pi。Linuxも参照してください。

この画面は、Gatewayに到達でき、認証されていることを前提としています。また、モデルプロバイダーが設定されている場合、 TUIは最初の孵化時に「Wake up, my friend!」を自動送信します。モデル/認証のセットアップを スキップした場合、オンボーディングは「Model auth missing」という注記を表示し、何も送信せずに TUIを開きます。openclaw configure --section modelでプロバイダーを追加してください。 起動メッセージが表示されても返信がなく、トークンが0のままであれば、エージェントは実行されていません。

1. Gatewayを再起動します。

openclaw gateway restart

2. ステータスと認証を確認します。

openclaw statusopenclaw models statusopenclaw logs --follow

3. まだ停止したままの場合は、次を実行します。

openclaw doctor

Gatewayがリモートにある場合は、トンネル/Tailscale接続が有効で、UIが正しいGatewayを 指していることを確認してください。リモートアクセスを参照してください。

はい。状態ディレクトリとワークスペースをコピーしてから、Doctorを一度実行します。

1. 新しいマシンにOpenClawをインストールします。
2. 古いマシンから$OPENCLAW_STATE_DIR（デフォルト：~/.openclaw）をコピーします。
3. ワークスペース（デフォルト：~/.openclaw/workspace）をコピーします。
4. openclaw doctorを実行し、Gatewayサービスを再起動します。

これにより、設定、認証プロファイル、WhatsApp認証情報、セッション、メモリが保持されます。 両方の場所をコピーすれば、ボットをまったく同じ状態に維持できます。リモートモードでは、 Gatewayホストがセッションストアとワークスペースを所有します。

**重要：**ワークスペースだけをGitHubへコミット/プッシュした場合、バックアップされるのは メモリとブートストラップファイルのみで、セッション履歴や認証は含まれません。これらは ~/.openclaw/（例：~/.openclaw/agents/<agentId>/agent/openclaw-agent.sqlite）に保存されています。

関連項目：移行、ディスク上の保存場所、 エージェントワークスペース、Doctor、 リモートモード。

GitHubの変更履歴を確認してください。 https://github.com/openclaw/openclaw/blob/main/CHANGELOG.md

最新のエントリは最上部にあります。最上部のセクションが未リリースの場合、その次の日付付き セクションが出荷済みの最新バージョンです。エントリはハイライト、変更、 修正の各項目に分類されます（必要に応じてドキュメントやその他のセクションも含まれます）。

一部のComcast/Xfinity接続では、Xfinity Advanced Securityによってdocs.openclaw.aiが 誤ってブロックされます。無効にするか、docs.openclaw.aiを許可リストへ追加してから再試行してください。 ブロック解除にご協力ください：https://spa.xfinity.com/check_url_status。

まだ解決しませんか？ドキュメントは GitHub にもミラーされています： https://github.com/openclaw/openclaw/tree/main/docs

Stable と beta は別々のコードラインではなく、npm dist-tag です：

• latest = stable
• beta = テスト用の早期ビルド（beta が存在しない場合、または現在の stable リリースより古い場合は latest にフォールバック）

stable リリースは通常、まず beta として公開され、その後、明示的な昇格ステップによって バージョン番号を変更せずに、同じバージョンが latest に移されます。メンテナーは latest に直接公開することもできます。そのため、昇格後は beta と stable が 同じバージョンを指す場合があります。

変更内容を確認する：CHANGELOG.md。

1 行のインストールコマンドと beta と dev の違いについては、次のアコーディオンを参照してください。

Beta は npm dist-tag beta です（昇格後は latest と同じ場合があります）。 Dev は main（git）の移動する最新ヘッドです。npm に公開される場合は dist-tag dev を使用します。

1 行コマンド（macOS/Linux）：

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --beta

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git

Windows インストーラー（PowerShell）：iwr -useb https://openclaw.ai/install.ps1 | iex

詳細：開発チャンネルおよびインストーラーフラグ。

2 つの方法があります：

1. Dev チャンネル（既存のインストール環境）：

openclaw update --channel dev

これにより、main の git チェックアウトに切り替え、upstream 上にリベースし、ビルドして、 そのチェックアウトから CLI をインストールします。

2. 変更可能な（git）インストール（新しいマシン）：

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git

手動でのクローンを推奨します：

git clone https://github.com/openclaw/openclaw.gitcd openclawpnpm installpnpm build

ドキュメント：更新、開発チャンネル、インストール。

おおよその目安：

• インストール： 2-5 分。
• クイックスタートのオンボーディング： 数分（loopback Gateway、自動トークン、デフォルトのワークスペース）。
• 高度な／完全なオンボーディング： プロバイダーへのサインイン、チャンネルのペアリング、デーモンのインストール、ネットワークからのダウンロード、または Skills に追加設定が必要な場合は、さらに時間がかかります。

ウィザードはこの所要時間の目安を最初に表示します。任意の手順はスキップし、後から openclaw configure で再開できます。

停止していますか？上記の先に進めない場合を参照してください。

--verbose を付けて再実行します：

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --verbosecurl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --beta --verbosecurl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git --verbose

install.ps1 には専用の詳細出力スイッチがありません。代わりに Set-PSDebug -Trace 1 / -Trace 0 でラップしてください。フラグの完全なリファレンス：インストーラーフラグ。

Windows でよくある問題は 2 つあります：

1) npm error spawn git / git not found

• Git for Windows をインストールし、git が PATH に含まれていることを確認します。
• PowerShell を閉じて開き直し、インストーラーを再実行します。

2) インストール後に openclaw is not recognized と表示される

• npm のグローバル bin フォルダーが PATH に含まれていません。
• 次のコマンドで確認します：npm config get prefix。
• そのディレクトリをユーザー PATH に追加します（\bin サフィックスは不要です。ほとんどのシステムでは %AppData%\npm です）。
• PowerShell を閉じて開き直します。

デスクトップアプリを希望しますか？Windows Hub を使用してください。ターミナルのみのセットアップでは、PowerShell インストーラーと WSL2 Gateway の両方の方法がサポートされています。ドキュメント：Windows。

通常、ネイティブ Windows シェルでコンソールのコードページが一致していないことが原因です。

症状：system.run/exec の出力では中国語が文字化けしますが、同じコマンドが 別のターミナルプロファイルでは正常に表示されます。

PowerShell での回避策：

chcp 65001[Console]::InputEncoding = [System.Text.UTF8Encoding]::new($false)[Console]::OutputEncoding = [System.Text.UTF8Encoding]::new($false)$OutputEncoding = [System.Text.UTF8Encoding]::new($false)

その後、Gateway を再起動して再試行します：

openclaw gateway restart

最新の OpenClaw でも引き続き再現しますか？こちらで追跡または報告してください：Issue #30640。

変更可能な（git）インストールを使用して、完全なソースとドキュメントをローカルに用意し、 そのフォルダーからボット（または Claude/Codex）に質問してください。これにより、リポジトリを読み込んで正確に回答できます。

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git

詳細：インストールおよびインストーラーフラグ。

• Linux のクイック手順とサービスのインストール：Linux。
• 完全な手順：はじめに。
• インストーラーと更新：インストールと更新。

任意の Linux VPS を使用できます。サーバーにインストールしてから、SSH/Tailscale 経由で Gateway にアクセスします。

ガイド：exe.dev、Hetzner、Fly.io。 リモートアクセス：Gateway のリモート接続。

一般的なプロバイダーをまとめたホスティングハブ：

• VPS ホスティング（すべてのプロバイダーを 1 か所に集約）
• Fly.io
• Hetzner
• exe.dev

クラウドでは、Gateway はサーバー上で実行され、ノートパソコン／スマートフォンから Control UI（または Tailscale/SSH）経由でアクセスします。状態とワークスペースはサーバー上に保存されるため、 ホストを信頼できる唯一の情報源として扱い、バックアップしてください。

Node（Mac/iOS/Android/ヘッドレス）をそのクラウド Gateway とペアリングすると、Gateway を クラウド上で稼働させたまま、ノートパソコン上でローカルの画面／カメラ／キャンバスを使用したり、コマンドを実行したりできます。

ハブ：プラットフォーム。リモートアクセス：Gateway のリモート接続。 Node：Node、Node CLI。

可能ですが、推奨されません。更新フローでは Gateway が再起動される可能性があり（アクティブな セッションが切断されます）、クリーンな git チェックアウトが必要になる場合や、確認を求められる場合があります。 オペレーターがシェルから更新を実行する方が安全です。

openclaw updateopenclaw update statusopenclaw update --channel stable|extended-stable|beta|devopenclaw update --tag <dist-tag|version>openclaw update --no-restart

エージェントから自動化する場合：

openclaw update --yes --no-restartopenclaw gateway restart

ドキュメント：更新、アップデート。

openclaw onboard は推奨されるセットアップ方法です。ローカルモードでは、次の項目を順に設定します：

1. モデル／認証 - プロバイダーの OAuth、API キー、または手動認証（LM Studio などのローカルオプションを含む）。デフォルトモデルを選択します。
2. ワークスペース - 場所とブートストラップファイル。
3. Gateway - ポート、バインドアドレス、認証モード、Tailscale での公開。
4. チャンネル - 組み込みおよび公式 Plugin のチャットチャンネル：iMessage、Discord、Feishu、Google Chat、Mattermost、Microsoft Teams、QQ Bot、Signal、Slack、Telegram、WhatsApp など。
5. デーモン - LaunchAgent（macOS）、systemd ユーザーユニット（Linux/WSL2）、またはネイティブ Windows のスケジュールされたタスク。
6. ヘルスチェック - Gateway を起動し、実行中であることを確認します。
7. Skills - 推奨される Skills と任意の依存関係をインストールします。

最初に所要時間の目安を示し、設定済みのモデルが不明である場合や 認証がない場合は警告します。詳細：オンボーディング（CLI）。

いいえ。OpenClaw は API キー（Anthropic/OpenAI/その他）またはローカル専用モデルで 実行できるため、データをデバイス上に保持できます。サブスクリプション（Claude Pro/Max、ChatGPT/Codex）は、 これらのプロバイダーを認証するための任意の方法です。

Anthropic の場合、API キーでは標準的な従量課金が適用されます。Claude CLI は、 同じホスト上の既存の Claude Code ログインを再利用します。Anthropic は現在、Claude CLI の 非対話型 claude -p パスを、引き続きサブスクリプションプランの制限を消費する Agent SDK／プログラムによる使用として扱っています。サブスクリプションの動作に依存する前に、 Anthropic の最新の請求ドキュメントを確認してください。長期間稼働する Gateway ホストや共有 自動化では、Anthropic API キーの方が予測しやすい選択肢です。

OpenAI Codex OAuth（ChatGPT/Codex サブスクリプション）は、エージェントモデルで完全にサポートされています。 OpenClaw は、Qwen Cloud Coding Plan、MiniMax Coding Plan、 Z.AI / GLM Coding Plan など、ホスト型のサブスクリプション形式のオプションにも対応しています。

ドキュメント：Anthropic、OpenAI、 Qwen Cloud、MiniMax、Z.AI (GLM)、 ローカルモデル、モデル。

はい。OpenClaw は Pro/Max/Team/Enterprise プランで Claude CLI の再利用をサポートしています。Anthropic は 現在、OpenClaw が使用する claude -p パスを、別個の無料枠ではなく、プランの制限が適用される サブスクリプションプランの使用として扱っています。現在の請求に関する詳細と Anthropic 自身の サポート記事へのリンクについては、Anthropicを参照してください。 最も予測しやすいサーバー側セットアップには、代わりに Anthropic API キーを使用してください。

はい。Claude CLI の再利用によって対応しています。Anthropic による claude -p/Agent SDK 使用時の 請求上の扱いは時間の経過とともに変更されています。特定の請求動作に依存する前に、 現在の状況と Anthropic のサポート記事への日付付きリンクについて Anthropicを参照してください。

Anthropic の setup-token 認証も引き続きサポートされているトークン経路ですが、利用可能な場合、OpenClaw は Claude CLI の再利用と claude -p を優先します。本番環境またはマルチユーザーの ワークロードでは、Anthropic API キーの方が引き続き安全で予測しやすい選択肢です。その他の サブスクリプション形式のホスト型オプション：OpenAI、Qwen Cloud、 MiniMax、Z.AI (GLM)。

現在の期間における Anthropic のクォータ／レート制限を使い切っています。Claude CLI では、期間がリセットされるまで待つか、プランをアップグレードしてください。Anthropic API キーでは、 Anthropic Console で使用量と請求を確認し、必要に応じて上限を引き上げてください。

メッセージが特に Extra usage is required for long context requests である場合、 リクエストは Anthropic の 1M コンテキストウィンドウ（GA 対応の 1M Claude 4.x モデル、または従来の params.context1m: true 設定）を使用しようとしていますが、現在の認証情報は 長文コンテキストの課金対象として適格ではありません。

プロバイダーがレート制限を受けている間も OpenClaw が応答を続けられるよう、フォールバックモデルを設定してください。 モデル、OAuth、および Anthropic 429：長文コンテキストには追加使用量が必要を参照してください。

はい。OpenClaw には Amazon Bedrock (Converse) プロバイダーが同梱されています。AWS 環境 マーカー（AWS_ACCESS_KEY_ID、AWS_PROFILE、AWS_BEARER_TOKEN_BEDROCK）が存在する場合、 OpenClaw はモデル検出用の暗黙的な Bedrock プロバイダーを自動的に有効化します。それ以外の場合は、 plugins.entries.amazon-bedrock.config.discovery.enabled: true を設定するか、手動で プロバイダーエントリを追加してください。Amazon Bedrockおよびモデルプロバイダーを参照してください。 マネージドキーのフローを使用したい場合は、Bedrock の前段に OpenAI 互換プロキシを配置する方法も引き続き有効です。

OpenClaw は OAuth（ChatGPT サインイン）経由で OpenAI Codex をサポートします。プライマリモデルがない 新規セットアップでは、ChatGPT/Codex サブスクリプション認証とネイティブ Codex app-server 実行に 正確に openai/gpt-5.6-sol を使用します。 再認証では、openai/gpt-5.5 を含む既存の明示的なモデルが維持されます。 Codex ワークスペースで GPT-5.6 が提供されていない場合は、 openai/gpt-5.5 を明示的に選択してください。OpenClaw が暗黙的にダウングレードすることはありません。従来の Codex プレフィックス付きモデル参照は、openclaw doctor --fix によって修復される従来設定です。OpenAI API キーによる直接アクセスは、エージェント以外の OpenAI API サーフェスで引き続き利用でき、順序付けされた openai API キープロファイルを通じて、エージェント モデルでも利用できます。モデルプロバイダーおよび オンボーディング（CLI）を参照してください。

openai は、OpenAI API キーと ChatGPT/Codex OAuth の両方に対する現在のプロバイダーおよび認証プロファイル ID です。 OpenAI Codex はこれに統合されています。古い設定や移行警告では、従来の openai-codex プレフィックスが引き続き表示される場合があります。

• openai/gpt-5.6-sol = エージェントターンにネイティブ Codex ランタイムを使用する、新規の ChatGPT/Codex サブスクリプションセットアップ。
• openai/gpt-5.5 = 既存設定、または GPT-5.6 にアクセスできないアカウント向けに明示的にサポートされる選択肢。
• 従来の openai-codex/* モデル参照 = openclaw doctor --fix によって修復される従来ルート。
• openai/gpt-5.5 と順序付けされた openai API キープロファイル = OpenAI エージェントモデル向けの API キー認証。
• 従来の openai-codex 認証プロファイル ID = openclaw doctor --fix によって移行される従来 ID。

OpenAI Platform の直接課金を使用する場合は、OPENAI_API_KEY を設定してください。ChatGPT/Codex サブスクリプション認証を使用する場合は、openclaw models auth login --provider openai を実行してください。 モデル参照は標準の openai/* プロバイダー配下に維持してください。新規のサブスクリプション セットアップでは正確に openai/gpt-5.6-sol が使用されます。doctor は、明示的な openai/gpt-5.5 の選択を アップグレードすることなく、従来の Codex プレフィックス付き参照を修復します。

Codex OAuth では OpenAI が管理するプラン依存のクォータ期間が使用されるため、同じアカウントでも ChatGPT の Web サイト／アプリでの利用条件とは異なる場合があります。

openclaw models status は、現在表示可能なプロバイダーの使用量／クォータ期間を示しますが、 ChatGPT Web の権利を直接 API アクセスとして新たに作成したり正規化したりすることはありません。 OpenAI Platform の直接課金／制限の経路には、API キーとともに openai/* を使用してください。

はい、完全にサポートされています。OpenAI は、OpenClaw のような外部 ツール／ワークフローでのサブスクリプション OAuth の使用を明示的に許可しています。オンボーディングで OAuth フローを実行できます。

OAuth、モデルプロバイダー、およびオンボーディング（CLI）を参照してください。

Gemini CLI は、openclaw.json 内のクライアント ID やシークレットではなく、Plugin 認証フローを使用します。

1. gemini が PATH 上に存在するよう、Gemini CLI をローカルにインストールします：
   • Homebrew：brew install gemini-cli
   • npm：npm install -g @google/gemini-cli
2. Plugin を有効化：openclaw plugins enable google
3. ログイン：openclaw models auth login --provider google-gemini-cli --set-default
4. ログイン後のデフォルトモデル：google/gemini-3.1-pro-preview（ランタイム google-gemini-cli）
5. ログイン後にリクエストが失敗する場合：Gateway ホストで GOOGLE_CLOUD_PROJECT または GOOGLE_CLOUD_PROJECT_ID を設定して再試行してください。

OAuth トークンは Gateway ホスト上の認証プロファイルに保存されます。詳細：Google、モデルプロバイダー。

通常は推奨されません。OpenClaw には大きなコンテキストと強固な安全性が必要です。小容量のカードではコンテキストが切り詰められ、 プロバイダー側の安全フィルターが適用されません。使用する必要がある場合は、ローカルで実行できる最大のモデルビルドを （LM Studio で）使用してください。ローカルモデルを参照してください。小型／量子化 モデルではプロンプトインジェクションのリスクが高まります。セキュリティを参照してください。

リージョンが固定されたエンドポイントを選択してください。OpenRouter は MiniMax、Kimi、 GLM の米国ホスト型オプションを提供しています。データをリージョン内に維持するには、米国ホスト型のバリアントを選択してください。 models.mode: "merge" を使用して Anthropic/OpenAI を併記することもできるため、選択したリージョン指定プロバイダーを尊重しながら フォールバックを引き続き利用できます。

いいえ。OpenClaw は macOS または Linux（Windows では WSL2 経由）で動作します。Mac mini は常時稼働 ホストとして一般的な選択肢ですが、小型 VPS、ホームサーバー、または Raspberry Pi クラスのマシンでも動作します。

Mac が必要なのは、macOS 専用ツールを使用する場合だけです。iMessage では、Messages にサインイン済みの任意の Mac 上で imsg とともに iMessage を使用してください。Gateway が Linux など別の場所で動作している場合は、 channels.imessage.cliPath に、その Mac 上で imsg を実行する SSH ラッパーを設定します。その他の macOS 専用ツールでは、Gateway を Mac 上で実行するか、macOS Node をペアリングしてください。

ドキュメント：iMessage、Node、Mac リモートモード。

Messages にサインイン済みの macOS デバイスが必要ですが、Mac mini である必要はなく、任意の Mac を使用できます。imsg とともに iMessage を使用してください。Gateway はその Mac 上で実行することも、SSH ラッパー cliPath を使用して別の場所で実行することもできます。

一般的な構成：

• Gateway を Linux/VPS 上で実行し、channels.imessage.cliPath に、Messages にサインイン済みの Mac 上で imsg を実行する SSH ラッパーを設定。
• 最もシンプルな単一マシン構成として、すべてを 1 台の Mac 上で実行。

ドキュメント：iMessage、Node、Mac リモートモード。

はい。Mac mini で Gateway を実行し、MacBook Pro を Node （コンパニオンデバイス）として接続できます。Node は Gateway を実行するのではなく、そのデバイス上で 画面／カメラ／キャンバスや system.run などの機能を追加します。

一般的な構成：常時稼働の Mac mini 上で Gateway を実行し、MacBook Pro では macOS アプリまたは Node ホストを実行して Gateway とペアリングします。openclaw nodes status / openclaw nodes list で確認してください。

ドキュメント：Node、Node CLI。

Bun は依存関係のインストールやパッケージスクリプトの実行に使用できます。標準の状態ストアが node:sqlite を使用しており、Bun はその API を提供しないため、OpenClaw CLI と Gateway には Node が必要です。

channels.telegram.allowFrom には、ボットのユーザー名ではなく、人間の送信者の Telegram ユーザー ID （数値）を指定します。セットアップでは数値のユーザー ID のみを受け付けます。openclaw doctor --fix は 従来の @username エントリの解決を試みることができます。

より安全な方法（サードパーティ製ボット不使用）：自分のボットに DM を送り、openclaw logs --follow を実行して、from.id を確認します。

公式 Bot API：自分のボットに DM を送り、https://api.telegram.org/bot<bot_token>/getUpdates を呼び出して、message.from.id を確認します。

サードパーティ（プライバシーは低下）：@userinfobot または @getidsbot に DM を送ります。

Telegram のアクセス制御を参照してください。

はい、マルチエージェントルーティングを使用できます。各送信者の WhatsApp DM（peer: { kind: "direct", id: "+15551234567" }）を異なる agentId にバインドし、それぞれに固有のワークスペースとセッションストアを割り当てます。返信は引き続き同じ WhatsApp アカウントから送信されます。DM アクセス制御（channels.whatsapp.dmPolicy / channels.whatsapp.allowFrom）はアカウント単位でグローバルです。マルチエージェントルーティングおよび WhatsApp を参照してください。

はい。マルチエージェントルーティングを使用します。各エージェントに独自のデフォルトモデルを設定し、受信 ルート（プロバイダーアカウントまたは特定のピア）を各エージェントにバインドしてください。設定例： マルチエージェントルーティング。モデルおよび 設定も参照してください。

はい、Linuxbrew 経由で動作します：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"echo 'eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"' >> ~/.profileeval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"brew install <formula>

systemd 経由で OpenClaw を実行する場合：非ログインシェルでも brew でインストールされたツールを 解決できるよう、サービスの PATH に /home/linuxbrew/.linuxbrew/bin（または使用している brew プレフィックス）が含まれていることを確認してください。 最近のビルドでは、Linux の systemd サービスで一般的なユーザー bin ディレクトリ（例：~/.local/bin、~/.npm-global/bin、 ~/.local/share/pnpm、~/.bun/bin）も先頭に追加され、設定されている場合は PNPM_HOME、NPM_CONFIG_PREFIX、 BUN_INSTALL、VOLTA_HOME、ASDF_DATA_DIR、NVM_DIR、FNM_DIR が使用されます。

• **改変可能（git）なインストール：**完全なソースチェックアウトで、編集可能です。コントリビューターに最適です。ローカルでビルドし、コード／ドキュメントにパッチを適用できます。
• **npm インストール：**リポジトリを伴わないグローバル CLI インストールで、「そのまま実行したい」場合に最適です。更新は npm dist-tags から提供されます。

ドキュメント：はじめに、更新。

はい。既存のインストールで openclaw update --channel ... を使用します。これによってデータが 削除されることはありません。変更されるのは OpenClaw コードのインストールのみです。状態 (~/.openclaw) と ワークスペース (~/.openclaw/workspace) はそのまま維持されます。

npm から git へ：

openclaw update --channel dev

git から npm へ：

openclaw update --channel stable

最初に予定されているモード切り替えをプレビューするには、--dry-run を追加します。アップデーターは Doctor の フォローアップを実行し、対象チャンネルの Plugin ソースを更新して、--no-restart を渡さない限り Gateway を 再起動します。

インストーラーでどちらかのモードを強制することもできます：

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method gitcurl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method npm

バックアップのヒント：ディスク上の保存場所。

24/7 の信頼性が必要なら、VPS を使用してください。手軽さを最優先し、 スリープや再起動を許容できるなら、ローカルで実行してください。

ノートパソコン（ローカル Gateway）

• **長所：**サーバー費用がかからない、ローカルファイルに直接アクセスできる、ブラウザーウィンドウを表示できる。
• **短所：**スリープやネットワーク切断で接続が切れる、OS の更新や再起動で中断される、スリープさせずに稼働し続ける必要がある。

VPS / クラウド

• **長所：**常時稼働、安定したネットワーク、ノートパソコンのスリープに伴う問題がない、稼働状態を維持しやすい。
• **短所：**多くの場合ヘッドレス（スクリーンショットを使用）、ファイルにはリモートからのみアクセス可能、更新には SSH が必要。

WhatsApp、Telegram、Slack、Mattermost、Discord はいずれも VPS から問題なく動作します。実際の トレードオフは、ヘッドレスブラウザーか表示可能なウィンドウかという点です。ブラウザーを参照してください。

デフォルトの推奨事項：以前に Gateway の接続切れが発生したことがある場合は VPS。Mac をアクティブに使用していて、 ローカルファイルへのアクセスや、ブラウザー UI を表示した状態での自動操作が必要な場合は、ローカルが適しています。

必須ではありませんが、信頼性と分離性のために推奨されます。

• **専用ホスト（VPS／Mac mini／Raspberry Pi）：**常時稼働、スリープや再起動による中断が少ない、権限を整理しやすい、稼働状態を維持しやすい。
• **共用のノートパソコン／デスクトップ：**テストやアクティブな使用には問題ありませんが、マシンのスリープや更新時には一時停止が発生します。

両方の利点を得るには、Gateway を専用ホストで稼働させ、ローカルの画面／カメラ／実行ツール用の Node としてノートパソコンをペアリングします。Nodeとセキュリティを参照してください。

• **絶対最小要件：**1 vCPU、1 GB RAM、約 500 MB のディスク容量。
• **推奨：**余裕を確保するために 1～2 vCPU、2 GB 以上の RAM（ログ、メディア、複数チャンネル）。Node ツールやブラウザー自動操作は多くのリソースを消費する場合があります。

OS：Ubuntu LTS（または最新の Debian／Ubuntu）。最も十分にテストされている Linux のインストール方法です。

ドキュメント：Linux、VPS ホスティング。

はい。VM は VPS と同様に扱います。常時稼働し、アクセス可能で、Gateway と有効にする 各チャンネルに十分な RAM が必要です。

• **絶対最小要件：**1 vCPU、1 GB RAM。
• **推奨：**複数チャンネル、ブラウザー自動操作、またはメディアツールを使用する場合は 2 GB 以上の RAM。
• **OS：**Ubuntu LTS またはその他の最新の Debian／Ubuntu。

Windows では、デスクトップのセットアップに Windows Hub を使用するか、幅広いツールとの互換性を持つ Linux 形式の Gateway VM として WSL2 を使用します。Windows、VPS ホスティングを参照してください。 macOS を VM で実行する場合は、macOS VMを参照してください。