FAQ

実世界のセットアップ（ローカル開発、VPS、マルチエージェント、OAuth/APIキー、モデルフェイルオーバー）に関する迅速な回答と詳細なトラブルシューティング。ランタイム診断については、トラブルシューティングを参照してください。完全な設定リファレンスについては、設定を参照してください。

目次

• [クイックスタートと初回実行セットアップ]
  • 行き詰まりました。最も速く解決する方法は？
  • OpenClawのインストールとセットアップのおすすめ方法は？
  • オンボーディング後にダッシュボードを開くには？
  • ダッシュボードの認証（トークン）をlocalhostとリモートで行うには？
  • 必要なランタイムは？
  • Raspberry Piで動作しますか？
  • Raspberry Piインストールのコツは？
  • "wake up my friend"で止まる / オンボーディングが孵化しない。どうすれば？
  • 新しいマシン（Mac mini）にセットアップを移行し、オンボーディングをやり直さずに済ませられますか？
  • 最新バージョンの新機能はどこで確認できますか？
  • docs.openclaw.aiにアクセスできません（SSLエラー）。どうすれば？
  • 安定版とベータ版の違いは？
  • ベータ版をインストールするには？また、ベータ版と開発版の違いは？
  • 最新のビットを試すには？
  • インストールとオンボーディングには通常どのくらい時間がかかりますか？
  • インストーラーが固まった？より詳細なフィードバックを得るには？
  • Windowsインストールでgitが見つからない、またはopenclawが認識されないと言われる
  • Windowsのexec出力が文字化けした中国語テキストを表示する。どうすれば？
  • ドキュメントに答えがありませんでした - より良い回答を得るには？
  • LinuxにOpenClawをインストールするには？
  • VPSにOpenClawをインストールするには？
  • クラウド/VPSインストールガイドはどこにありますか？
  • OpenClaw自身に更新を依頼できますか？
  • オンボーディングウィザードは実際に何をしますか？
  • これを実行するためにClaudeやOpenAIのサブスクリプションが必要ですか？
  • APIキーなしでClaude Maxサブスクリプションを使用できますか？
  • Anthropicの「setup-token」認証はどのように機能しますか？
  • Anthropicのsetup-tokenはどこで見つけられますか？
  • Claudeサブスクリプション認証（Claude ProまたはMax）をサポートしていますか？
  • AnthropicからHTTP 429: rate_limit_errorが表示されるのはなぜですか？
  • AWS Bedrockはサポートされていますか？
  • Codex認証はどのように機能しますか？
  • OpenAIサブスクリプション認証（Codex OAuth）をサポートしていますか？
  • Gemini CLI OAuthをセットアップするには？
  • カジュアルなチャットにはローカルモデルで大丈夫ですか？
  • ホストされたモデルのトラフィックを特定のリージョンに保つには？
  • これをインストールするためにMac Miniを購入する必要がありますか？
  • iMessageサポートのためにMac miniが必要ですか？
  • OpenClawを実行するためにMac miniを購入した場合、MacBook Proに接続できますか？
  • Bunを使用できますか？
  • Telegram: allowFromには何を入れますか？
  • 複数の人が1つのWhatsApp番号を異なるOpenClawインスタンスで使用できますか？
  • 「高速チャット」エージェントと「コーディング用Opus」エージェントを実行できますか？
  • HomebrewはLinuxで動作しますか？
  • ハッカブル（git）インストールとnpmインストールの違いは？
  • 後でnpmとgitインストールを切り替えられますか？
  • Gatewayをラップトップで実行すべきか、VPSで実行すべきか？
  • OpenClawを専用マシンで実行することはどのくらい重要ですか？
  • 最小VPS要件と推奨OSは？
  • VMでOpenClawを実行できますか？要件は？
• OpenClawとは？
  • OpenClawとは、一言で言うと？
  • 価値提案は？
  • セットアップ直後に最初に何をすべきですか？
  • OpenClawの日常的な主な5つのユースケースは？
  • OpenClawはSaaSのリードジェネレーション、アウトリーチ、広告、ブログに役立ちますか？
  • Web開発におけるClaude Codeとの比較での利点は？
• スキルと自動化
  • リポジトリを汚さずにスキルをカスタマイズするには？
  • カスタムフォルダからスキルを読み込めますか？
  • 異なるタスクに異なるモデルを使用するには？
  • 重い作業中にボットがフリーズします。それをオフロードするには？
  • Cronやリマインダーが発火しません。何を確認すべきですか？
  • Linuxにスキルをインストールするには？
  • OpenClawはスケジュールに従って、またはバックグラウンドで継続的にタスクを実行できますか？
  • LinuxからApple macOS専用スキルを実行できますか？
  • NotionやHeyGenの統合はありますか？
  • ブラウザー乗っ取り用のChrome拡張機能をインストールするには？
• サンドボックス化とメモリ
  • 専用のサンドボックス化ドキュメントはありますか？
  • ホストフォルダをサンドボックスにバインドするには？
  • メモリはどのように機能しますか？
  • メモリが物事を忘れ続けます。定着させるには？
  • メモリは永久に保持されますか？制限は？
  • セマンティックメモリ検索にOpenAI APIキーが必要ですか？
• ディスク上のファイルの場所
  • OpenClawで使用されるすべてのデータはローカルに保存されますか？
  • OpenClawはデータをどこに保存しますか？
  • AGENTS.md / SOUL.md / USER.md / MEMORY.mdはどこに置くべきですか？
  • 推奨されるバックアップ戦略は？
  • OpenClawを完全にアンインストールするには？
  • エージェントはワークスペース外で作業できますか？
  • リモートモードです - セッションストアはどこにありますか？
• 設定の基本
  • 設定の形式は？どこにありますか？
  • gateway.bind: "lan"（または"tailnet"）を設定したら、何もリッスンしない / UIが「unauthorized」と言う
  • なぜlocalhostでトークンが必要になったのですか？
  • 設定変更後に再起動する必要がありますか？
  • 面白いCLIタグラインを無効にするには？
  • ウェブ検索（およびウェブフェッチ）を有効にするには？
  • config.applyが設定を消去しました。回復し、これを避けるには？
  • 中央のGatewayとデバイス間の特殊化されたワーカーを実行するには？
  • OpenClawブラウザはヘッドレスで実行できますか？
  • ブラウザ制御にBraveを使用するには？
• リモートゲートウェイとノード
  • コマンドはTelegram、ゲートウェイ、ノード間でどのように伝播しますか？
  • Gatewayがリモートでホストされている場合、エージェントが私のコンピューターにアクセスするには？
  • Tailscaleは接続されていますが、返信がありません。どうすれば？
  • 2つのOpenClawインスタンスが互いに通信できますか（ローカル + VPS）？
  • 複数のエージェントに別々のVPSが必要ですか？
  • VPSからのSSHではなく、個人のラップトップ上のノードを使用する利点はありますか？
  • ノードはゲートウェイサービスを実行しますか？
  • 設定を適用するAPI / RPCの方法はありますか？
  • 初回インストールのための最小限の「健全な」設定は？
  • VPSにTailscaleをセットアップし、Macから接続するには？
  • MacノードをリモートGateway（Tailscale Serve）に接続するには？
  • 2台目のラップトップにインストールすべきか、それともノードを追加するだけか？
• 環境変数と.envの読み込み
  • OpenClawは環境変数をどのように読み込みますか？
  • 「サービス経由でGatewayを起動したら、環境変数が消えました。」どうすれば？
  • COPILOT_GITHUB_TOKENを設定しましたが、モデルステータスに「Shell env: off」と表示されます。なぜ？
• セッションと複数チャット
  • 新しい会話を開始するには？
  • /newを送信しなければ、セッションは自動的にリセットされますか？
  • OpenClawインスタンスのチームを作成する方法はありますか（1つのCEOと多数のエージェント）？
  • 途中でコンテキストが切り詰められました。防ぐには？
  • OpenClawを完全にリセットしつつ、インストールは保持するには？
  • 「コンテキストが大きすぎる」エラーが発生します - リセットまたは圧縮するには？
  • 「LLM request rejected: messages.content.tool_use.input field required」と表示されるのはなぜですか？
  • なぜ30分ごとにハートビートメッセージが届きますか？
  • WhatsAppグループに「ボットアカウント」を追加する必要がありますか？
  • WhatsAppグループのJIDを取得するには？
  • なぜOpenClawはグループで返信しませんか？
  • グループ/スレッドはDMとコンテキストを共有しますか？
  • いくつのワークスペースとエージェントを作成できますか？
  • 複数のボットやチャットを同時に実行できますか（Slack）、またどのようにセットアップすべきですか？
• モデル: デフォルト、選択、エイリアス、切り替え
  • 「デフォルトモデル」とは？
  • どのモデルをお勧めしますか？
  • 設定を消去せずにモデルを切り替えるには？
  • セルフホストモデル（llama.cpp、vLLM、Ollama）を使用できますか？
  • OpenClaw、Flawd、Krillはどのモデルを使用していますか？
  • （再起動せずに）動的にモデルを切り替えるには？
  • 日常タスクにGPT 5.2、コーディングにCodex 5.3を使用できますか？
  • 「Model … is not allowed」と表示され、その後返信がないのはなぜですか？
  • 「Unknown model: minimax/MiniMax-M2.5」と表示されるのはなぜですか？
  • デフォルトにMiniMaxを使用し、複雑なタスクにOpenAIを使用できますか？
  • opus / sonnet / gptは組み込みのショートカットですか？
  • モデルショートカット（エイリアス）を定義/上書きするには？
  • OpenRouterやZ.AIのような他のプロバイダーのモデルを追加するには？
• モデルフェイルオーバーと「すべてのモデルが失敗しました」
  • フェイルオーバーはどのように機能しますか？
  • このエラーは何を意味しますか？
  • No credentials found for profile "anthropic:default"の修正チェックリスト
  • なぜGoogle Geminiも試して失敗したのですか？
• 認証プロファイル: 概要と管理方法
  • 認証プロファイルとは？
  • 典型的なプロファイルIDは？
  • どの認証プロファイルが最初に試行されるかを制御できますか？
  • OAuthとAPIキーの違いは？
• Gateway: ポート、「already running」、リモートモード
  • Gatewayはどのポートを使用しますか？
  • なぜopenclaw gateway statusはRuntime: runningだがRPC probe: failedと言うのですか？
  • なぜopenclaw gateway statusはConfig (cli)とConfig (service)が異なると表示するのですか？
  • 「another gateway instance is already listening」とはどういう意味ですか？
  • OpenClawをリモートモードで実行するには（クライアントが別の場所のGatewayに接続）？
  • Control UIが「unauthorized」と言う（または再接続を繰り返す）。どうすれば？
  • gateway.bind: "tailnet"を設定したが、バインドできない / 何もリッスンしない
  • 同じホストで複数のGatewayを実行できますか？
  • 「invalid handshake」 / code 1008とはどういう意味ですか？
• ロギングとデバッグ
  • ログはどこにありますか？
  • Gatewayサービスを開始/停止/再起動するには？
  • Windowsでターミナルを閉じてしまいました - OpenClawを再起動するには？
  • Gatewayは起動していますが、返信が届きません。何を確認すべきですか？
  • 「Disconnected from gateway: no reason」 - どうすれば？
  • TelegramのsetMyCommandsがネットワークエラーで失敗します。何を確認すべきですか？
  • TUIに出力が表示されません。何を確認すべきですか？
  • Gatewayを完全に停止してから開始するには？
  • ELI5: openclaw gateway restart 対 openclaw gateway
  • 何かが失敗したときに詳細を最も速く得る方法は？
• メディアと添付ファイル
  • スキルが画像/PDFを生成しましたが、何も送信されませんでした
• セキュリティとアクセス制御
  • OpenClawをインバウンドDMに公開しても安全ですか？
  • プロンプトインジェクションは公開ボットだけの問題ですか？
  • ボットは独自のメール、GitHubアカウント、電話番号を持つべきですか？
  • テキストメッセージに対する自律性を与えても安全ですか？
  • 個人アシスタントタスクに安価なモデルを使用できますか？
  • Telegramで/startを実行しましたが、ペアリングコードが届きませんでした
  • WhatsApp: 連絡先にメッセージを送信しますか？ペアリングはどのように機能しますか？
• チャットコマンド、タスク中止、「止まらない」
  • 内部システムメッセージがチャットに表示されないようにするには？
  • 実行中のタスクを停止/キャンセルするには？
  • TelegramからDiscordメッセージを送信するには？（「Cross-context messaging denied」）
  • なぜボットが「無視」しているように感じるのですか（連続メッセージ）？

何かが壊れた場合の最初の60秒

1. クイックステータス（最初の確認）

   コピー

   openclaw status
   

   高速なローカルサマリー: OS + 更新、ゲートウェイ/サービスの到達可能性、エージェント/セッション、プロバイダー設定 + ランタイムの問題（ゲートウェイが到達可能な場合）。

2. 貼り付け可能なレポート（共有安全）

   コピー

   openclaw status --all
   

   ログ末尾付きの読み取り専用診断（トークンは編集済み）。

3. デーモン + ポート状態

   コピー

   openclaw gateway status
   

   スーパーバイザーのランタイムとRPC到達可能性、プローブ対象URL、およびサービスが使用した可能性のある設定を表示します。

4. 詳細プローブ

   コピー

   openclaw status --deep
   

   ゲートウェイヘルスチェック + プロバイダープローブを実行（到達可能なゲートウェイが必要）。ヘルスを参照。

5. 最新のログを追跡

   コピー

   openclaw logs --follow
   

   RPCがダウンしている場合、次にフォールバック:

   コピー

   tail -f "$(ls -t /tmp/openclaw/openclaw-*.log | head -1)"
   

   ファイルログはサービスログとは別です。ロギングとトラブルシューティングを参照。

6. ドクターを実行（修復）

   コピー

   openclaw doctor
   

   設定/状態の修復/移行 + ヘルスチェックを実行。ドクターを参照。

7. ゲートウェイスナップショット

   コピー

   openclaw health --json
   openclaw health --verbose   # エラー時にターゲットURL + 設定パスを表示
   

   実行中のゲートウェイに完全なスナップショットを要求（WSのみ）。ヘルスを参照。

クイックスタートと初回実行セットアップ

行き詰まりました。最も速く解決する方法は？

あなたのマシンを見ることができるローカルAIエージェントを使用してください。これはDiscordで質問するよりもはるかに効果的です。なぜなら、ほとんどの「行き詰まり」ケースは、リモートのヘルパーが検査できないローカル設定または環境の問題だからです。

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

これらのツールはリポジトリを読み取り、コマンドを実行し、ログを検査し、マシンレベルのセットアップ（PATH、サービス、権限、認証ファイル）の修正を支援できます。完全なソースチェックアウトをハッカブル（git）インストール経由で提供してください:

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git

これにより、OpenClawがgitチェックアウトからインストールされるため、エージェントはコード + ドキュメントを読み、実行中の正確なバージョンについて推論できます。後でいつでも--install-method gitなしでインストーラーを再実行することで安定版に戻せます。ヒント: エージェントに修正を計画および監督（ステップバイステップ）させ、必要なコマンドのみを実行させてください。これにより、変更が小さく、監査が容易になります。実際のバグや修正を発見した場合は、GitHubイシューを提出するかPRを送ってください: https://github.com/openclaw/openclaw/issues [https://github.com/openclaw/openclaw/pulls](https://github.com/open