よくある質問

OpenClaw は、自分のデバイス上で実行するパーソナル AI アシスタントです。普段使用しているメッセージング環境（Discord、Google Chat、iMessage、Mattermost、Signal、Slack、Telegram、WebChat、WhatsApp、および QQ Bot などの同梱チャンネル Plugin）で応答し、サポート対象プラットフォームでは音声機能とライブ Canvas も利用できます。Gateway は常時稼働する制御プレーンであり、アシスタントが製品本体です。

OpenClaw は「単なる Claude のラッパー」ではありません。自分のハードウェア上で高性能なアシスタントを実行し、普段使用しているチャットアプリからアクセスできる、ローカルファーストの制御プレーンです。ステートフルなセッション、メモリ、ツールを利用でき、ワークフローをホスト型 SaaS に委ねる必要はありません。

• 自分のデバイス、自分のデータ：Gateway を任意の場所（Mac、Linux、VPS）で実行し、ワークスペースとセッション履歴をローカルに保持できます。
• Web サンドボックスではなく実際のチャンネル：Discord/iMessage/Signal/Slack/Telegram/WhatsApp などに加え、サポート対象プラットフォームではモバイル音声と Canvas も利用できます。
• モデル非依存：Anthropic、MiniMax、OpenAI、OpenRouter などを、エージェントごとのルーティングとフェイルオーバーで使用できます。
• ローカル限定の選択肢：ローカルモデルを実行し、すべてのデータをデバイス内に保持できます。
• マルチエージェントルーティング：チャンネル、アカウント、タスクごとにエージェントを分け、それぞれ独自のワークスペースとデフォルト設定を使用できます。
• オープンソースで改造可能：ベンダーロックインなしで、調査、拡張、セルフホストできます。

ドキュメント：Gateway、チャンネル、マルチエージェント、メモリ。

最初のプロジェクトとして適している例：Web サイトの構築（WordPress、Shopify、静的サイト）、モバイルアプリのプロトタイプ作成（概要、画面、API 計画）、ファイルやフォルダーの整理、Gmail との接続および要約やフォローアップの自動化。

大規模なタスクにも対応できますが、複数のフェーズに分割し、並行作業にはサブエージェントを使用すると最も効果的です。

• 個人向けブリーフィング：受信トレイ、カレンダー、関心のあるニュースの要約。
• 調査と下書き：簡単な調査、要約、メールやドキュメントの初稿作成。
• リマインダーとフォローアップ：Cron または Heartbeat による通知やチェックリスト。
• ブラウザー自動化：フォーム入力、データ収集、Web タスクの反復実行。
• デバイス間の連携：スマートフォンからタスクを送信し、Gateway にサーバー上で実行させ、結果をチャットで受け取れます。

はい。調査、選定、下書きに使用できます。サイトの調査、候補リストの作成、見込み客の要約、アウトリーチ文や広告コピーの下書き作成などが可能です。

アウトリーチや広告配信では、人間による確認を必須にしてください。スパムを避け、地域の法律とプラットフォームのポリシーに従い、送信前にすべての内容を確認してください。OpenClaw に下書きを作成させ、承認は人間が行います。

ドキュメント：セキュリティ。

OpenClaw はパーソナルアシスタントおよび連携レイヤーであり、IDE の代替ではありません。リポジトリ内で最速の直接的なコーディングループを実現するには Claude Code または Codex を使用してください。永続的なメモリ、デバイス間アクセス、ツールのオーケストレーションには OpenClaw を使用してください。

• セッションをまたいで永続するメモリとワークスペース。
• 複数プラットフォームからのアクセス（Telegram、WhatsApp、TUI、WebChat）。
• ツールのオーケストレーション（ブラウザー、ファイル、スケジュール、フック）。
• 常時稼働する Gateway（VPS 上で実行し、どこからでも操作）。
• ローカルのブラウザー、画面、カメラ、コマンド実行用の Node。

活用例：https://openclaw.ai/showcase。

リポジトリ内のコピーを編集する代わりに、管理対象のオーバーライドを使用します。変更を ~/.openclaw/skills/<name>/SKILL.md に配置します（または ~/.openclaw/openclaw.json の skills.load.extraDirs を使用してフォルダーを追加します）。優先順位は <workspace>/skills -> <workspace>/.agents/skills -> ~/.agents/skills -> ~/.openclaw/skills -> 同梱版 -> skills.load.extraDirs です。そのため、git に変更を加えずに、管理対象のオーバーライドを同梱 Skills より優先できます。グローバルにインストールしつつ一部のエージェントだけに表示するには、共有コピーを ~/.openclaw/skills に置き、agents.defaults.skills / agents.list[].skills で表示範囲を制御します。アップストリームに取り込む価値のある編集のみ、リポジトリ内のコピーに対する PR として提出してください。

はい。~/.openclaw/openclaw.json の skills.load.extraDirs を使用してディレクトリを追加します（上記の優先順位では最も低い優先度です）。clawhub はデフォルトで ./skills にインストールし、OpenClaw は次回のセッションでこれを <workspace>/skills として扱います。特定のエージェントだけに表示するには、agents.defaults.skills または agents.list[].skills と組み合わせます。

サポートされるパターン：

• Cron ジョブ：分離されたジョブでは、ジョブごとに model のオーバーライドを設定できます。
• エージェント：デフォルトモデル、思考レベル、ストリームパラメーターが異なる個別のエージェントにタスクをルーティングします。
• オンデマンド切り替え：/model を使用すると、現在のセッションのモデルをいつでも切り替えられます。

例 — 同じモデルで、エージェントごとに異なる設定を使用する場合：

{  agents: {    list: [      {        id: "coder",        model: "xiaomi/mimo-v2.5-pro",        thinkingDefault: "high",        params: { temperature: 0.1 },      },      {        id: "chat",        model: "xiaomi/mimo-v2.5-pro",        thinkingDefault: "off",        params: { temperature: 0.8 },      },    ],  },}

モデルごとの共有デフォルトを agents.defaults.models["provider/model"].params に配置し、その後、エージェント固有のオーバーライドをフラットな agents.list[].params に配置します。ネストされた agents.list[].models["provider/model"].params の下に同じモデルを重複して指定しないでください。このパスは、エージェントごとのモデルカタログとランタイムオーバーライド用です。

Cron ジョブ、マルチエージェントルーティング、設定、スラッシュコマンドを参照してください。

長時間または並行して実行するタスクにはサブエージェントを使用します。サブエージェントは独自のセッションで実行され、要約を返すため、メインチャットの応答性を維持できます。ボットに「このタスク用のサブエージェントを生成して」と依頼するか、/subagents を使用します。Gateway が現在処理中かどうかを確認するには、/status を使用します。

長時間タスクとサブエージェントはいずれもトークンを消費します。コストが重要な場合は、agents.defaults.subagents.model を使用してサブエージェントに安価なモデルを設定してください。

ドキュメント：サブエージェント、バックグラウンドタスク。

Discord スレッドをサブエージェントまたはセッション対象に紐付けると、そのスレッド内の後続メッセージは紐付けられたセッションに送られます。

• thread: true を指定した sessions_spawn で生成します（継続的なフォローアップには、必要に応じて mode: "session" も指定します）。
• または、/focus <target> で手動で紐付けます。
• /agents で紐付け状態を確認します。
• /session idle <duration|off> と /session max-age <duration|off> で自動フォーカス解除を制御します。
• /unfocus でスレッドの紐付けを解除します。

設定：session.threadBindings.enabled（グローバルスイッチ）、session.threadBindings.idleHours（デフォルトは 24、0 で無効化）、session.threadBindings.maxAgeHours（デフォルトは 0 = 上限なし）、チャンネルごとのオーバーライド channels.discord.threadBindings.{enabled,idleHours,maxAgeHours}。channels.discord.threadBindings.spawnSessions は生成時の自動紐付けを制御します（デフォルトは true）。

ドキュメント：サブエージェント、Discord、設定リファレンス、スラッシュコマンド。

解決された要求元ルートを確認します。

• 完了モードのサブエージェント配信では、紐付けられたスレッドまたは会話ルートが存在する場合、それを優先します。
• 完了元にチャンネル情報しかない場合、OpenClaw は要求元セッションに保存されたルート（lastChannel / lastTo / lastAccountId）を代わりに使用するため、直接配信が引き続き成功する可能性があります。
• 紐付けられたルートも使用可能な保存済みルートもない場合、直接配信が失敗する可能性があり、結果は即時投稿されず、キューに登録されたセッション配信に切り替わります。
• 無効または古い対象も、キューへのフォールバックや最終的な配信失敗の原因になることがあります。
• 子セッションの最後に表示されたアシスタントの応答が NO_REPLY / no_reply または ANNOUNCE_SKIP と完全に一致する場合、OpenClaw は以前の古い進捗を投稿する代わりに、意図的に通知を抑制します。

デバッグ：<lookup> がタスク ID、実行 ID、またはセッションキーである場合は、openclaw tasks show <lookup> を使用します。

ドキュメント：サブエージェント、バックグラウンドタスク、セッションツール。

Cron は Gateway プロセス内で実行されます。Gateway が継続的に稼働していない場合は実行されません。

• cron が有効になっており（cron.enabled）、OPENCLAW_SKIP_CRON が設定されていないことを確認します。
• Gateway が 24 時間年中無休で稼働していることを確認します（スリープや再起動がないこと）。
• ジョブのタイムゾーン（--tz とホストのタイムゾーン）を確認します。

デバッグ：

openclaw cron run <jobId>openclaw cron runs --id <jobId> --limit 50

ドキュメント：Cron ジョブ、自動化。

配信モードを確認します：

• --no-deliver / delivery.mode: "none"：ランナーによるフォールバック送信は行われません。
• 通知先（channel / to）がないか無効です：ランナーは外部への配信をスキップしました。
• チャンネル認証の失敗（unauthorized、Forbidden）：ランナーは配信を試みましたが、認証情報によって阻止されました。
• 無言の分離結果（NO_REPLY / no_reply のみ）は意図的に配信対象外と見なされるため、キューに入ったフォールバック配信も抑制されます。

分離された Cron ジョブでは、チャット経路が利用可能な場合、エージェントは message ツールを使用して直接送信できます。--announce は、エージェント自身がまだ送信していない最終テキストに対するランナーのフォールバック配信のみを制御します。

デバッグ：

openclaw cron runs --id <jobId> --limit 50openclaw tasks show <lookup>

ドキュメント：Cron ジョブ、バックグラウンドタスク。

これは重複スケジューリングではなく、実行中のモデル切り替え処理です。分離された Cron は実行時のモデル引き継ぎを永続化し、アクティブな実行が LiveSessionModelSwitchError をスローすると、切り替え後のプロバイダー／モデル（および切り替え後の認証プロファイルのオーバーライド）を維持して再試行します。

モデル選択の優先順位：最初に Gmail フックのモデルオーバーライド（hooks.gmail.model）、次にジョブ単位の model、続いて保存済み Cron セッションのモデルオーバーライド、最後に通常のエージェント／デフォルトモデル選択です。

再試行ループは、最初の試行に加えて 2 回の切り替え再試行に制限されています。その後、Cron は無限ループせずに中止します。

デバッグ：

openclaw cron runs --id <jobId> --limit 50

ドキュメント：Cron ジョブ、cron CLI。

ネイティブの openclaw skills コマンドを使用するか、ワークスペースに Skills を配置します。macOS の Skills UI は Linux では利用できません。https://clawhub.ai で Skills を参照できます。

openclaw skills search "calendar"openclaw skills search --limit 20openclaw skills install @owner/<skill-slug>openclaw skills install @owner/<skill-slug> --version <version>openclaw skills install @owner/<skill-slug> --forceopenclaw skills install @owner/<skill-slug> --globalopenclaw skills update --allopenclaw skills update --all --globalopenclaw skills list --eligibleopenclaw skills check

ネイティブの openclaw skills install は、デフォルトでアクティブなワークスペースの skills/ ディレクトリに書き込みます。すべてのローカルエージェント用の共有管理 Skills ディレクトリにインストールするには、--global を追加します。独自の Skills を公開または同期する場合に限り、別個の clawhub CLI をインストールしてください。共有 Skills を参照できるエージェントを絞り込むには、agents.defaults.skills または agents.list[].skills を使用します。

はい。Gateway スケジューラーを使用します：

• スケジュールされたタスクまたは繰り返しタスクには Cron ジョブ（再起動後も保持）。
• メインセッションの定期確認には Heartbeat。
• 概要の投稿やチャットへの配信を行う自律エージェントには 分離ジョブ。

ドキュメント：Cron ジョブ、自動化、Heartbeat。

直接は実行できません。macOS Skills は metadata.openclaw.os と必要なバイナリによって制限されており、Gateway ホストで利用条件を満たす場合にのみ読み込まれます。Linux では、制限をオーバーライドしない限り、darwin 専用の Skills（apple-notes、apple-reminders、things-mac）は読み込まれません。

サポートされている方法は 3 つあります：

オプション A - Mac 上で Gateway を実行する（最も簡単）。macOS バイナリが存在する場所で Gateway を実行し、Linux からリモートモードまたは Tailscale 経由で接続します。Gateway ホストが macOS であるため、Skills は通常どおり読み込まれます。

オプション B - macOS Node を使用する（SSH 不要）。Linux 上で Gateway を実行し、macOS Node（メニューバーアプリ）をペアリングして、Mac 上の Node Run Commands を "Always Ask" または "Always Allow" に設定します。必要なバイナリが Node 上に存在する場合、OpenClaw は macOS 専用 Skills を利用可能と見なし、エージェントは nodes ツール経由で実行します。"Always Ask" の場合、プロンプトで "Always Allow" を承認すると、そのコマンドが許可リストに追加されます。

オプション C - SSH 経由で macOS バイナリをプロキシする（上級者向け）。Gateway は Linux 上で稼働させたまま、必要な CLI バイナリが Mac 上で実行される SSH ラッパーとして解決されるようにし、さらに Linux を許可するよう Skill をオーバーライドして利用可能な状態を維持します。

1. バイナリ用の SSH ラッパーを作成します（例：Apple Notes 用の memo）：

   #!/usr/bin/env bashset -euo pipefailexec ssh -T user@mac-host /opt/homebrew/bin/memo "$@"

2. Linux ホストの PATH にラッパーを配置します（例：~/bin/memo）。
3. Linux を許可するように Skill メタデータ（ワークスペースまたは ~/.openclaw/skills）をオーバーライドします：

   ---name: apple-notesdescription: macOS 上の memo CLI を使用して Apple Notes を管理します。metadata: { "openclaw": { "os": ["darwin", "linux"], "requires": { "bins": ["memo"] } } }---

4. Skills のスナップショットを更新するため、新しいセッションを開始します。

現在は組み込まれていません。選択肢は次のとおりです：

• カスタム Skill／Plugin：信頼性の高い API アクセスに最適です（どちらにも API があります）。
• ブラウザー自動化：コードなしで動作しますが、より低速で壊れやすくなります。

代理店のようにクライアントごとのコンテキストを扱う場合は、クライアントごとに Notion ページを 1 つ（コンテキスト、設定、進行中の作業）保持し、セッション開始時にそのページを取得するようエージェントに指示します。

ネイティブ連携が必要な場合は、機能リクエストを作成するか、それらの API を使用する Skill を構築します。

openclaw skills install @owner/<skill-slug>openclaw skills update --all

ネイティブインストールでは、アクティブなワークスペースの skills/ ディレクトリに配置されます。すべてのローカルエージェントで使用するには --global を使用し、表示範囲を制限するには agents.defaults.skills / agents.list[].skills を設定します。一部の Skills は Homebrew でインストールされたバイナリを想定しています。Linux では Linuxbrew が必要です。

Skills、Skills の設定、ClawHubを参照してください。

Chrome DevTools MCP 経由で接続する、組み込みの user ブラウザープロファイルを使用します：

openclaw browser --browser-profile user tabsopenclaw browser --browser-profile user snapshot

カスタム名を使用する場合は、明示的な MCP プロファイルを作成します：

openclaw browser create-profile --name chrome-live --driver existing-sessionopenclaw browser --browser-profile chrome-live tabs

ローカルホストのブラウザーまたは接続されたブラウザー Node を使用できます。Gateway が別の場所で稼働している場合は、ブラウザーがあるマシンで Node ホストを実行するか、代わりにリモート CDP を使用します。

管理対象の openclaw プロファイルと比較した、existing-session / user プロファイルの現在の制限：

• click、type、hover、scrollIntoView、drag、select では、CSS セレクターではなくスナップショット参照が必要です。
• アップロードフックでは ref または inputRef が必要で、一度に 1 ファイルのみ対応し、CSS element は使用できません。
• responsebody、PDF エクスポート、ダウンロードのインターセプト、バッチ操作には、引き続き管理対象ブラウザーの経路が必要です。

完全な比較については、ブラウザーを参照してください。

はい：サンドボックス化を参照してください。Docker 固有のセットアップ（Docker 内の完全な Gateway またはサンドボックスイメージ）については、Dockerを参照してください。

デフォルトイメージはセキュリティを優先し、node ユーザーとして実行されるため、システムパッケージ、Homebrew、同梱ブラウザーは含まれていません。より完全なセットアップにするには：

• キャッシュが保持されるよう、OPENCLAW_HOME_VOLUME を使用して /home/node を永続化します。
• OPENCLAW_IMAGE_APT_PACKAGES を使用して、システム依存関係をイメージに組み込みます。
• 同梱の CLI から Playwright ブラウザーをインストールします：node /app/node_modules/playwright-core/cli.js install chromium。
• PLAYWRIGHT_BROWSERS_PATH を設定し、そのパスを永続化します。

ドキュメント：Docker、ブラウザー。

はい。プライベートな通信が DM、公開通信が グループである場合に可能です。agents.defaults.sandbox.mode: "non-main" を設定すると、グループ／チャンネルセッション（メイン以外のキー）は設定済みのサンドボックスバックエンドで実行され、メインの DM セッションはホスト上に残ります。サンドボックス化を有効にすると、Docker がデフォルトのバックエンドになります。tools.sandbox.tools を使用して、サンドボックス化されたセッションで利用可能なツールを制限します。

セットアップ手順：グループ：個人用 DM と公開グループ。主要リファレンス：Gateway の設定。

agents.defaults.sandbox.docker.binds を ["host:container:mode"] に設定します（例："/home/user/src:/src:ro"）。グローバルバインドとエージェント単位のバインドはマージされます。scope: "shared" の場合、エージェント単位のバインドは無視されます。機密性の高いものには :ro を使用してください。バインドはサンドボックスのファイルシステム境界を迂回します。

OpenClaw は、正規化されたパスと、存在する最深の祖先を通じて解決された正準パスの両方に対してバインド元を検証します。そのため、最終パスセグメントがまだ存在しない場合でも、シンボリックリンクの親を利用した脱出は安全側に失敗します。

サンドボックス化およびサンドボックスとツールポリシーと昇格を参照してください。

OpenClaw のメモリは、エージェントのワークスペース内にある Markdown ファイルです。日次メモは memory/YYYY-MM-DD.md、整理された長期メモは MEMORY.md に保存されます（メイン／プライベートセッションのみ）。

OpenClaw は、Compaction が会話を要約する前に、無言の Compaction 前メモリフラッシュも実行し、先に永続的なメモを書き込むようモデルに促します。これはワークスペースが書き込み可能な場合にのみ実行されます（読み取り専用サンドボックスではスキップされます）。無効にするには agents.defaults.compaction.memoryFlush.enabled: false を使用します。メモリを参照してください。

ボットに その事実をメモリへ書き込むよう依頼します。長期メモは MEMORY.md、短期コンテキストは memory/YYYY-MM-DD.md に保存されます。メモリを保存するようモデルに念押しすると、通常は解決します。それでも忘れ続ける場合は、Gateway が実行のたびに同じワークスペースを使用していることを確認してください。

ドキュメント：メモリ、エージェントワークスペース。

メモリファイルはディスク上に保存され、削除されるまで保持されます。制限となるのはモデルではなくストレージです。ただし、セッションコンテキストはモデルのコンテキストウィンドウによる制限を受けるため、長い会話は圧縮または切り詰められることがあります。これがメモリ検索が存在する理由であり、関連する部分だけをコンテキストに戻します。

ドキュメント：メモリ、コンテキスト。

デフォルトのプロバイダーである OpenAI 埋め込みを使用する場合にのみ必要です。Codex OAuth はチャット/補完を対象とし、埋め込みへのアクセス権は付与しません。そのため、Codex（OAuth または Codex CLI ログイン）でサインインしても、セマンティックメモリ検索は有効になりません。OpenAI 埋め込みには、引き続き実際の API キー（OPENAI_API_KEY または models.providers.openai.apiKey）が必要です。

ローカルで完結させるには、agents.defaults.memorySearch.provider: "local"（GGUF/llama.cpp）を設定します。その他のサポート対象プロバイダー：Bedrock、DeepInfra、Gemini（GEMINI_API_KEY または memorySearch.remote.apiKey）、GitHub Copilot、LM Studio、Mistral、Ollama、OpenAI 互換、Voyage。セットアップの詳細については、メモリおよびメモリ検索を参照してください。

いいえ。OpenClaw 自体の状態はローカルに保存されますが、外部サービスには送信した内容が引き続き渡されます。

• デフォルトでローカル：セッション、メモリファイル、設定、ワークスペースは Gateway ホスト（~/.openclaw とワークスペースディレクトリ）に保存されます。
• 必然的にリモート：モデルプロバイダー（Anthropic/OpenAI など）に送信されたメッセージは各社の API に渡され、チャットプラットフォーム（Slack/Telegram/WhatsApp など）はメッセージデータを各社のサーバーに保存します。
• 保存範囲は制御可能：ローカルモデルを使えばプロンプトはマシン内に留まりますが、チャネルの通信は引き続きそのチャネルのサーバーを経由します。

関連：エージェントワークスペース、メモリ。

すべて $OPENCLAW_STATE_DIR（デフォルト：~/.openclaw）以下に保存されます。

レガシーの単一エージェント用パス ~/.openclaw/agent/* は openclaw doctor によって移行されます。

ワークスペース（AGENTS.md、メモリファイル、Skills など）は別に存在し、agents.defaults.workspace（デフォルト：~/.openclaw/workspace）で設定します。

これらは ~/.openclaw ではなく、エージェントワークスペースに配置します。

• ワークスペース（エージェントごと）：AGENTS.md、SOUL.md、IDENTITY.md、USER.md、MEMORY.md、memory/YYYY-MM-DD.md、任意の HEARTBEAT.md。小文字のルート memory.md は、レガシー修復の入力としてのみ使用されます。両方が存在する場合、openclaw doctor --fix でこれを MEMORY.md にマージできます。
• 状態ディレクトリ（~/.openclaw）：設定、チャネル/プロバイダー状態、認証プロファイル、セッション、ログ、共有 Skills（~/.openclaw/skills）。

デフォルトのワークスペースは ~/.openclaw/workspace で、次のように設定できます。

{  agents: { defaults: { workspace: "~/.openclaw/workspace" } },}

再起動後にボットが「忘れた」場合は、起動のたびに Gateway が同じワークスペースを使用していることを確認してください（リモートモードではローカルのノート PC ではなく、Gateway ホストのワークスペースが使用されます）。

ヒント：永続的な動作や設定については、チャット履歴に依存するのではなく、ボットに AGENTS.md または MEMORY.md へ書き込むよう依頼してください。

エージェントワークスペースおよびメモリを参照してください。

はい。SOUL.md は、エージェントのコンテキストに注入されるワークスペースのブートストラップファイルの 1 つです。デフォルトのファイルごとの注入上限は 20000 文字で、ファイル全体のブートストラップ予算は合計 60000 文字です。

共有デフォルトを変更します。

{  agents: {    defaults: {      bootstrapMaxChars: 50000,      bootstrapTotalMaxChars: 300000,    },  },}

または、agents.list[].bootstrapMaxChars / bootstrapTotalMaxChars 以下で特定のエージェントを上書きします。

/context を使用すると、元のサイズと注入後のサイズ、および切り詰めが発生したかどうかを確認できます。SOUL.md には語調、姿勢、人格に関する内容のみを記載し、運用ルールは AGENTS.md、永続的な事実はメモリに記載してください。

コンテキストおよびエージェント設定を参照してください。

エージェントワークスペースを非公開の git リポジトリに置き、非公開の場所（例：GitHub の非公開リポジトリ）へバックアップしてください。これにより、メモリと AGENTS/SOUL/USER ファイルが保存され、後でアシスタントの「思考」を復元できます。

~/.openclaw 以下の内容（認証情報、セッション、トークン、暗号化されたシークレットペイロード）はコミットしないでください。完全に復元できるようにするには、ワークスペースと状態ディレクトリを別々にバックアップしてください。

ドキュメント：エージェントワークスペース。

アンインストールを参照してください。

はい。ワークスペースはデフォルトの cwdおよびメモリの基点であり、厳密なサンドボックスではありません。相対パスはワークスペース内で解決されます。サンドボックスが有効でない限り、絶対パスを使ってホスト上の他の場所にアクセスできます。分離するには、agents.defaults.sandboxまたはエージェントごとのサンドボックス設定を使用してください。リポジトリをデフォルトの作業ディレクトリにするには、そのエージェントの workspace をリポジトリのルートに設定します。OpenClaw リポジトリ自体は単なるソースコードであるため、エージェントを意図的にその中で作業させる場合を除き、ワークスペースは分けておいてください。

{  agents: {    defaults: {      workspace: "~/Projects/my-repo",    },  },}

セッション状態は Gateway ホストが所有します。リモートモードでは、対象となるセッションストアはローカルのノート PC ではなく、リモートマシン上にあります。セッション管理を参照してください。

OpenClaw は、$OPENCLAW_CONFIG_PATH（デフォルト：~/.openclaw/openclaw.json）から任意の JSON5 設定を読み込みます。ファイルがない場合は、デフォルトワークスペースの ~/.openclaw/workspace など、比較的安全なデフォルト値を使用します。

loopback 以外へのバインドには、有効な Gateway 認証経路が必要です。共有シークレット認証（トークンまたはパスワード）、または正しく設定された ID 対応リバースプロキシの背後にある gateway.auth.mode: "trusted-proxy" を使用します。

{  gateway: {    bind: "lan",    auth: {      mode: "token",      token: "replace-me",    },  },}

• gateway.remote.token / .password だけでは、ローカル Gateway 認証は有効になりません。gateway.auth.* が未設定の場合に限り、ローカル呼び出し経路は gateway.remote.* をフォールバックとして使用できます。
• パスワード認証では、gateway.auth.mode: "password" と gateway.auth.password（または OPENCLAW_GATEWAY_PASSWORD）を設定します。
• gateway.auth.token / .password が SecretRef 経由で明示的に設定され、解決できない場合は、解決処理がフェイルクローズします（リモートフォールバックによる隠蔽は行われません）。
• 共有シークレットを使用する Control UI 構成では、connect.params.auth.token または connect.params.auth.password（アプリ/UI 設定に保存）を使用して認証します。Tailscale Serve や trusted-proxy などの ID を含むモードでは、代わりにリクエストヘッダーを使用します。共有シークレットを URL に含めないでください。
• gateway.auth.mode: "trusted-proxy" を使用する場合、同一ホスト上の loopback リバースプロキシには、明示的な gateway.auth.trustedProxy.allowLoopback = true と gateway.trustedProxies 内の loopback エントリが必要です。

OpenClaw は、loopback を含め、デフォルトで Gateway 認証を適用します。明示的な認証経路が設定されていない場合、起動時にトークンモードが選択され、その起動時のみ有効なトークンが生成されます。そのため、ローカル WS クライアントも認証する必要があります。これにより、他のローカルプロセスが Gateway を呼び出すことを防ぎます。

クライアントが再起動後も安定したシークレットを必要とする場合は、gateway.auth.token、gateway.auth.password、OPENCLAW_GATEWAY_TOKEN、または OPENCLAW_GATEWAY_PASSWORD を明示的に設定してください。パスワードモード、または ID 対応リバースプロキシ用の trusted-proxy を選択することもできます。認証なしの loopback を使用するには、gateway.auth.mode: "none" を明示的に設定します。openclaw doctor --generate-gateway-token はいつでもトークンを生成します。

Gateway は設定を監視し、ホットリロードをサポートしています。gateway.reload.mode: "hybrid"（デフォルト）は、安全な変更を即時適用し、重要な変更では再起動します。hot、restart、off もサポートされています。ほとんどの tools.*、agents.* ポリシー、session.*、messages.* の変更は、リロード操作なしですぐに適用されます。gateway.* のバインド/ポート変更には再起動が必要です。

cli.banner.taglineMode を設定します。

{  cli: {    banner: {      taglineMode: "off", // random | default | off    },  },}

• off：タグラインのテキストを非表示にしますが、バナーのタイトル/バージョン行は残します。
• default：常に All your chats, one OpenClaw. を使用します。
• random：面白いタグラインや季節のタグラインをローテーション表示します（デフォルト動作）。
• バナーを完全に非表示にするには、環境変数 OPENCLAW_HIDE_BANNER=1 を設定します。

web_fetch は API キーなしで動作します。web_search は選択したプロバイダーによって異なります。

Grokはモデル認証のxAI OAuthも再利用できます（openclaw onboard --auth-choice xai-oauth）。

推奨: openclaw configure --section web を実行してプロバイダーを選択します。

{  plugins: {    entries: {      brave: {        config: {          webSearch: {            apiKey: "BRAVE_API_KEY_HERE",          },        },      },    },  },  tools: {    web: {      search: {        enabled: true,        provider: "brave",        maxResults: 5,      },      fetch: {        enabled: true,        provider: "firecrawl", // 任意。自動検出する場合は省略      },    },  },}

プロバイダー固有のWeb検索設定は plugins.entries.<plugin>.config.webSearch.* にあります。従来の tools.web.search.* プロバイダーパスも互換性のため読み込まれますが、新しい設定では使用しないでください。FirecrawlのWeb取得フォールバック設定は plugins.entries.firecrawl.config.webFetch.* にあります。

• 許可リスト: web_search/web_fetch/x_search、または3つすべてに対して group:web を追加します。
• web_fetch はデフォルトで有効です。
• tools.web.fetch.provider を省略すると、OpenClawは利用可能な認証情報から、準備済みの最初の取得フォールバックプロバイダーを自動検出します。公式Firecrawl Pluginがそのフォールバックを提供します。
• デーモンは ~/.openclaw/.env（またはサービス環境）から環境変数を読み取ります。

ドキュメント: Webツール。

config.apply は設定全体を置き換えます。部分的なオブジェクトを指定すると、それ以外はすべて削除されます。

現在のOpenClawでは、誤操作による上書きの大半を防止します。

• OpenClawが管理する設定書き込みでは、書き込む前に変更後の設定全体を検証します。
• 無効または破壊的なOpenClaw管理の書き込みは拒否され、openclaw.json.rejected.* として保存されます。
• 直接編集によって起動またはホットリロードが失敗する場合、Gatewayはフェイルクローズするかリロードをスキップします。openclaw.json を書き換えることはありません。
• openclaw doctor --fix が修復を担当し、最後に正常だった設定を復元できます。また、拒否されたファイルを openclaw.json.clobbered.* として保存します。

復旧手順:

• openclaw logs --follow で Invalid config at、Config write rejected:、または config reload skipped (invalid config) を確認します。
• 有効な設定の隣にある最新の openclaw.json.clobbered.* または openclaw.json.rejected.* を確認します。
• openclaw config validate と openclaw doctor --fix を実行します。
• openclaw config set または config.patch を使用して、必要なキーだけを書き戻します。
• 最後に正常だった設定または拒否されたペイロードがない場合は、バックアップから復元するか、openclaw doctor を再実行してチャンネルとモデルを再設定します。
• 予期しない消失が発生した場合は、最後に把握している設定またはバックアップを添えてバグを報告してください。ローカルのコーディングエージェントであれば、ログや履歴から動作する設定を再構築できることがあります。

回避方法: 小さな変更には openclaw config set、対話的な編集には openclaw configure、不明なパスの確認には config.schema.lookup（浅いスキーマノードと直下の子要素の概要を返します）、部分的なRPC編集には config.patch を使用し、config.apply は設定全体の置換専用にしてください。エージェント向けの gateway ランタイムツールは、従来の tools.bash.* エイリアス経由であっても tools.exec.ask / tools.exec.security の書き換えを拒否します。

ドキュメント: 設定、構成、Gatewayのトラブルシューティング、Doctor。

一般的な構成は、1つのGateway（たとえばRaspberry Pi）にNodeとエージェントを組み合わせるものです。

• Gateway（中央）: チャンネル（Signal/WhatsApp）、ルーティング、セッションを管理します。
• Node（デバイス）: Mac/iOS/Androidが周辺機器として接続し、ローカルツール（system.run、canvas、camera）を公開します。
• エージェント（ワーカー）: 特別な役割（たとえば運用データと個人データ）のために、頭脳とワークスペースを分離します。
• サブエージェント: メインエージェントからバックグラウンド作業を生成し、並列実行します。
• TUI: Gatewayに接続し、エージェントやセッションを切り替えます。

ドキュメント: Node、リモートアクセス、マルチエージェントルーティング、サブエージェント、TUI。

はい。

{  browser: { headless: true },  agents: {    defaults: {      sandbox: { browser: { headless: true } },    },  },}

デフォルトは false（ウィンドウ表示あり）です。一部のサイトでは、ヘッドレスのほうがボット対策のチェックに引っかかりやすくなります（X/Twitterはヘッドレスセッションを頻繁にブロックします）。同じChromiumエンジンを使用し、ほとんどの自動化で動作します。主な違いはブラウザーウィンドウが表示されないことです（画面の確認にはスクリーンショットを使用してください）。ブラウザーを参照してください。

browser.executablePath にBraveのバイナリ（または任意のChromiumベースのブラウザー）を設定し、Gatewayを再起動します。ブラウザーを参照してください。

TelegramメッセージはGatewayによって処理されます。Gatewayがエージェントを実行し、その後、Nodeツールが必要な場合にのみGateway WebSocket経由でNodeを呼び出します。

Telegram -> Gateway -> エージェント -> node.* -> Node -> Gateway -> Telegram

Nodeがプロバイダーからの受信トラフィックを参照することはありません。Node RPC呼び出しだけを受信します。

コンピューターをNodeとしてペアリングします。Gatewayは別の場所で動作しますが、Gateway WebSocket経由でローカルマシン上の node.* ツール（画面、カメラ、システム）を呼び出せます。

1. 常時稼働するホスト（VPS/ホームサーバー）でGatewayを実行します。
2. Gatewayホストとコンピューターを同じtailnetに配置します。
3. Gateway WSに到達できることを確認します（tailnetへのバインドまたはSSHトンネル）。
4. macOSアプリをローカルで開き、Remote over SSHモード（またはtailnetへの直接接続）で接続してNodeとして登録します。
5. Nodeを承認します。

   openclaw devices listopenclaw devices approve <requestId>

個別のTCPブリッジは不要です。NodeはGateway WebSocket経由で接続します。

セキュリティ上の注意: macOSのNodeをペアリングすると、そのマシン上で system.run が許可されます。信頼できるデバイスだけをペアリングしてください。セキュリティを確認してください。

ドキュメント: Node、Gatewayプロトコル、macOSリモートモード、セキュリティ。

基本事項を確認します。

openclaw gateway statusopenclaw statusopenclaw channels status

次に、認証とルーティングを確認します。Tailscale Serveを使用している場合は、gateway.auth.allowTailscale が正しく設定されていることを確認してください。SSHトンネル経由で接続している場合は、トンネルが稼働していて正しいポートを指していることを確認してください。また、DM/グループの許可リストに自分のアカウントが含まれていることを確認してください。

ドキュメント: Tailscale、リモートアクセス、チャンネル。

はい。ただし、組み込みのボット間ブリッジはありません。

最も簡単な方法: 両方のボットがアクセスできる通常のチャットチャンネル（Slack/Telegram/WhatsApp）を使用します。ボットAからボットBへメッセージを送信し、ボットBに通常どおり返信させます。

CLIブリッジ（汎用）: openclaw agent --message ... --deliver を使用してもう一方のGatewayを呼び出すスクリプトを実行し、もう一方のボットが待機しているチャットを対象にします。一方のボットがリモートVPS上にある場合は、SSH/Tailscale経由でCLIの接続先をそのリモートGatewayに設定します（リモートアクセスを参照）。

openclaw agent --message "ローカルボットからこんにちは" --deliver --channel telegram --reply-to <chat-id>

2つのボットが無限に応答し合わないよう、ガードレールを追加してください（メンション時のみ、チャンネル許可リスト、または「ボットのメッセージには返信しない」ルール）。

ドキュメント: リモートアクセス、エージェントCLI、エージェント送信。

いいえ。1つのGatewayで複数のエージェントをホストでき、それぞれが独自のワークスペース、モデルのデフォルト値、ルーティングを持ちます。これは標準的な構成であり、エージェントごとにVPSを用意するよりも大幅に安価で簡単です。個別のVPSを使用するのは、厳格な分離（セキュリティ境界）が必要な場合、または共有したくない大きく異なる設定がある場合に限ってください。

はい。NodeはリモートGatewayからノートパソコンへアクセスするための第一級の方法であり、シェルアクセス以外の機能も利用できます。GatewayはmacOS/Linux（WindowsではWSL2経由）で動作し軽量なため（小規模なVPSやRaspberry Piクラスのマシンで十分であり、4 GB RAMで余裕があります）、常時稼働するホストとノートパソコンをNodeとして組み合わせる構成が一般的です。

• 受信SSHは不要 - Nodeはデバイスのペアリングを通じてGateway WebSocketへ外向きに接続します。
• より安全な実行制御 - system.run は、そのノートパソコン上のNode許可リストと承認によって制御されます。
• より多くのデバイスツール - Nodeは system.run に加えて、canvas、camera、screen を公開します。
• ローカルブラウザー自動化 - GatewayをVPS上で実行したまま、Nodeホスト経由でChromeをローカル実行したり、Chrome MCP経由でローカルのChromeに接続したりできます。

一時的なシェルアクセスにはSSHでも問題ありませんが、継続的なエージェントワークフローとデバイス自動化にはNodeのほうが簡単です。

ドキュメント: Node、Node CLI、ブラウザー。

いいえ。分離されたプロファイルを意図的に実行する場合を除き、ホストごとに実行するGatewayは1つだけにしてください（複数のGatewayを参照）。NodeはGatewayに接続する周辺機器です（iOS/AndroidのNode、またはメニューバーアプリのmacOS「Nodeモード」）。ヘッドレスNodeホストとCLI制御については、NodeホストCLIを参照してください。

gateway、discovery、およびホストされるPluginサーフェスの変更には、完全な再起動が必要です。

はい。

• config.schema.lookup: 書き込む前に、1 つの設定サブツリーを、その浅いスキーマノード、一致する UI ヒント、直下の子要素の概要とともに検査します。
• config.get: 現在のスナップショットとハッシュを取得します。
• config.patch: 安全な部分更新（ほとんどの RPC 編集で推奨）。可能な場合はホットリロードし、必要な場合は再起動します。
• config.apply: 設定全体を検証して置き換えます。可能な場合はホットリロードし、必要な場合は再起動します。
• エージェント向けの gateway ランタイムツールは、引き続き tools.exec.ask / tools.exec.security の書き換えを拒否します。従来の tools.bash.* エイリアスも同じ保護対象パスに正規化されます。

{  agents: { defaults: { workspace: "~/.openclaw/workspace" } },  channels: { whatsapp: { allowFrom: ["+15555550123"] } },}

ワークスペースを設定し、ボットを起動できるユーザーを制限します。

1. VPS にインストールしてログイン:

   curl -fsSL https://tailscale.com/install.sh | shsudo tailscale up

2. Tailscale アプリを使用して Mac にインストールしてログインし、同じ tailnet に接続します。
3. VPS に安定した名前を割り当てるため、Tailscale 管理コンソールで MagicDNS を有効化します。
4. tailnet のホスト名を使用します。SSH は ssh user@your-vps.tailnet-xxxx.ts.net、Gateway WS は ws://your-vps.tailnet-xxxx.ts.net:18789 です。

SSH を使用せずにコントロール UI にアクセスするには、VPS で Tailscale Serve を使用します。

openclaw gateway --tailscale serve

これにより Gateway は loopback にバインドされたまま、Tailscale 経由で HTTPS が公開されます。Tailscaleを参照してください。

Serve は Gateway のコントロール UI + WS を公開します。Node は同じ Gateway WS エンドポイント経由で接続します。

1. VPS と Mac が同じ tailnet に接続されていることを確認します。
2. macOS アプリをリモートモードで使用します（SSH ターゲットには tailnet のホスト名を指定できます）。アプリは Gateway ポートをトンネリングし、Node として接続します。
3. Node を承認します。

   openclaw devices listopenclaw devices approve <requestId>

ドキュメント: Gateway プロトコル、検出、macOS リモートモード。

2 台目のノート PC で ローカルツールのみ（画面、カメラ、実行）を使用する場合は、Node として追加します。Gateway は 1 つのままで、設定の重複はありません。ローカル Node ツールは現在 macOS でのみ利用できます。2 つ目の Gateway は、厳密な分離または完全に独立した 2 つのボットが必要な場合にのみインストールしてください。

ドキュメント: Node、Node CLI、複数の Gateway。

OpenClaw は親プロセス（シェル、launchd/systemd、CI など）から環境変数を読み取り、さらに以下を読み込みます。

• 現在の作業ディレクトリにある .env。
• ~/.openclaw/.env（$OPENCLAW_STATE_DIR/.env）にあるグローバルフォールバック .env。

どちらの .env ファイルも既存の環境変数を上書きしません。ワークスペースの .env については、プロバイダーの認証情報およびエンドポイントルーティング用キーが例外です。GEMINI_API_KEY、XAI_API_KEY、MISTRAL_API_KEY、末尾が _ENDPOINT のキー（およびその他の同梱プロバイダーの認証またはエンドポイント用環境変数）は、ワークスペースの .env からは無視されます。これらはプロセス環境、~/.openclaw/.env、または設定の env に置いてください。

設定内のインライン環境変数は、プロセス環境に存在しない場合にのみ適用されます。

{  env: {    OPENROUTER_API_KEY: "sk-or-...",    vars: { GROQ_API_KEY: "gsk-..." },  },}

優先順位と取得元の詳細については、/environmentを参照してください。

2 つの解決方法があります。

1. 不足しているキーを ~/.openclaw/.env に置くと、サービスがシェル環境を継承しない場合でも読み込まれます。
2. シェルインポートを有効にします（任意で使用できる便利な機能）。

   {  env: {    shellEnv: {      enabled: true,      timeoutMs: 15000,    },  },}

   これによりログインシェルが実行され、不足している想定済みのキーのみがインポートされます（既存の値は決して上書きされません）。対応する環境変数は OPENCLAW_LOAD_SHELL_ENV=1、OPENCLAW_SHELL_ENV_TIMEOUT_MS=15000 です。

openclaw models status は、シェル環境のインポートが有効かどうかを報告します。「Shell env: off」は環境変数が不足しているという意味ではありません。OpenClaw がログインシェルを自動的に読み込まないという意味にすぎません。

Gateway がサービス（launchd/systemd）として実行されている場合、シェル環境は継承されません。トークンを ~/.openclaw/.env に置くか、env.shellEnv.enabled: true を有効にするか、設定の env に追加して（存在しない場合にのみ適用）、Gateway を再起動してから再確認してください。

openclaw models status

Copilot トークンは、OPENCLAW_GITHUB_TOKEN、COPILOT_GITHUB_TOKEN、GH_TOKEN、GITHUB_TOKEN の順に解決されます。

/concepts/model-providersおよび/environmentを参照してください。

/new または /reset を単独のメッセージとして送信します。セッション管理を参照してください。

はい。デフォルトのリセットポリシーは 毎日 です。現在のセッションが開始された時刻に基づき、Gateway ホスト上で設定されたローカル時刻（session.reset.atHour、デフォルトは 4、0-23）にセッションが切り替わります。代わりにアイドル時間ベースのリセットを使用するには、mode: "idle" と session.reset.idleMinutes を設定します。これにより、一定期間操作がないとセッションが期限切れになります（Heartbeat/Cron/実行のシステムイベントではなく、最後の実際の操作に基づきます）。

{  session: {    reset: { mode: "daily", atHour: 4 },    resetByType: {      group: { mode: "idle", idleMinutes: 120 },      thread: { mode: "daily", atHour: 6 },    },    resetByChannel: {      discord: { mode: "idle", idleMinutes: 10080 },    },  },}

resetByType は、direct（従来のエイリアスは dm）、group、thread をサポートします。トップレベルの従来の session.idleMinutes は、session.reset/resetByType ブロックが設定されていない場合、アイドルモードのデフォルトに対する互換エイリアスとして引き続き機能します。プロバイダーが所有するアクティブな CLI セッションがあるセッションは、暗黙の毎日リセットによって終了されません。ライフサイクルの詳細については、セッション管理を参照してください。

はい。マルチエージェントルーティングとサブエージェントを使用できます。1 つのコーディネーターエージェントと、独自のワークスペースおよびモデルを持つ複数のワーカーエージェントを構成します。

これは楽しい実験として捉えるのが適切です。大量のトークンを消費し、個別のセッションを持つ 1 つのボットより効率が低い場合が多いためです。一般的な構成では、会話するボットを 1 つ用意し、並行作業には異なるセッションを使用し、必要に応じてサブエージェントを生成します。

ドキュメント: マルチエージェントルーティング、サブエージェント、エージェント CLI。

セッションのコンテキストはモデルのウィンドウによって制限されます。長いチャット、大量のツール出力、または多数のファイルによって、Compaction や切り詰めが発生することがあります。

• ボットに現在の状態を要約し、ファイルに書き込むよう依頼します。
• 長いタスクの前には /compact、話題を切り替えるときには /new を使用します。
• 重要なコンテキストをワークスペースに保存し、ボットに再読み込みを依頼します。
• 長時間または並行する作業にはサブエージェントを使用し、メインチャットを小さく保ちます。
• この問題が頻繁に発生する場合は、より大きなコンテキストウィンドウを持つモデルを選択します。

openclaw reset

非対話形式での完全リセット:

openclaw reset --scope full --yes --non-interactive

その後、セットアップを再実行します。

openclaw onboard --install-daemon

既存の設定が検出された場合、オンボーディングには リセット も表示されます。オンボーディング（CLI）を参照してください。プロファイル（--profile / OPENCLAW_PROFILE）を使用した場合は、各状態ディレクトリ（デフォルトは ~/.openclaw-<profile>）をリセットします。開発専用のリセットでは、openclaw gateway --dev --reset により開発用設定、認証情報、セッション、ワークスペースが消去されます。

• Compaction（会話を維持し、古いターンを要約）: /compact、または要約内容を指定するには /compact <instructions>。
• リセット（同じチャットキーに新しいセッション ID を割り当て）: /new または /reset。

問題が繰り返し発生する場合は、セッションの枝刈り（agents.defaults.contextPruning）を調整して古いツール出力を削減するか、より大きなコンテキストウィンドウを持つモデルを使用します。

ドキュメント: Compaction、セッションの枝刈り、セッション管理。

プロバイダーの検証エラーです。モデルが必須の input を含まない tool_use ブロックを出力しました。通常、セッション履歴が古いか破損していることを意味します（長いスレッドやツール/スキーマの変更後によく発生します）。

解決方法: /new を単独のメッセージとして送信し、新しいセッションを開始します。

Heartbeat はデフォルトで 30m ごとに実行されます。解決された認証モードが Anthropic OAuth/トークン認証（Claude CLI の再利用を含む）で、heartbeat.every が未設定の場合は 1h ごとです。調整または無効化するには、次のように設定します。

{  agents: {    defaults: {      heartbeat: {        every: "2h", // or "0m" to disable      },    },  },}

HEARTBEAT.md が存在していても実質的に空の場合（空白行、Markdown/HTML コメント、ATX 見出し、フェンスマーカー、または空のリスト項目スタブのみ）、OpenClaw は API 呼び出しを節約するため Heartbeat の実行をスキップします。ファイルが存在しない場合でも Heartbeat は実行され、モデルが処理内容を判断します。

エージェントごとの上書きには agents.list[].heartbeat を使用します。ドキュメント: Heartbeat。

いいえ。OpenClaw は 自分のアカウント で動作します。自分がグループに参加していれば、OpenClaw もそのグループを認識できます。デフォルトでは、送信者を許可するまでグループへの返信はブロックされます（groupPolicy: "allowlist"）。

グループへの返信を自分だけに制限するには、次のように設定します。

{  channels: {    whatsapp: {      groupPolicy: "allowlist",      groupAllowFrom: ["+15551234567"],    },  },}

最も速い方法は、ログを追跡しながらグループでテストメッセージを送信することです。

openclaw logs --follow --json

@g.us で終わる chatId（または from）を探します。例: 1234567890-1234567890@g.us。

すでに設定済みまたは許可リストに登録済みの場合は、設定からグループを一覧表示します。

openclaw directory groups list --channel whatsapp

ドキュメント: WhatsApp、ディレクトリ、ログ。

よくある原因は 2 つあります。メンション制限がデフォルトで有効になっている（ボットを @メンションするか、mentionPatterns に一致させる必要があります）、または "*" なしで channels.whatsapp.groups を設定しており、そのグループが許可リストに含まれていません。

グループとグループメッセージを参照してください。

ダイレクトチャットは、デフォルトではメインセッションにまとめられます。グループやチャンネルにはそれぞれ独自のセッションキーがあり、Telegram のトピックと Discord のスレッドは個別のセッションになります。グループとグループメッセージを参照してください。

厳密な上限はありません。数十、さらには数百でも問題ありませんが、以下に注意してください。

• ディスク使用量の増加: アクティブなセッションとトランスクリプトはエージェントごとの SQLite データベースに保存されます。従来のアーティファクトやアーカイブアーティファクトは、引き続き ~/.openclaw/agents/<agentId>/sessions/ 以下に蓄積する可能性があります。
• トークンコスト: エージェントが増えるほど、モデルの同時使用量も増加します。
• 運用オーバーヘッド: エージェントごとの認証プロファイル、ワークスペース、チャンネルルーティングが必要になります。

エージェントごとに アクティブな ワークスペースを 1 つ（agents.defaults.workspace）に保ち、ディスク使用量が増えた場合は openclaw sessions cleanup で古いセッションを削除してください（アクティブな SQLite の状態を手動で編集しないでください）。また、openclaw doctor を使用して、不要なワークスペースやプロファイルの不一致を見つけてください。

はい、マルチエージェントルーティングを使用できます。複数の分離されたエージェントを実行し、受信メッセージをチャンネル、アカウント、ピアに基づいてルーティングします。Slack はチャンネルとしてサポートされており、特定のエージェントにバインドできます。

ブラウザアクセスは強力ですが、「人間にできることは何でもできる」わけではありません。ボット対策、CAPTCHA、MFA によって自動化が妨げられる場合があります。最も確実に制御するには、ホスト上のローカル Chrome MCP、または実際にブラウザを実行しているマシン上の CDP を使用してください。

推奨設定は、常時稼働する Gateway ホスト（VPS/Mac mini）、役割ごとに 1 つのエージェント（バインディング）、それらのエージェントにバインドされた Slack チャンネル、および必要に応じて Chrome MCP または Node を介したローカルブラウザです。

ドキュメント: マルチエージェントルーティング、Slack、ブラウザ、Node。

gateway.port は、WebSocket + HTTP（Control UI、フックなど）で多重化された単一のポートを制御します。優先順位は次のとおりです。

--port > OPENCLAW_GATEWAY_PORT > gateway.port > デフォルト 18789

「実行中」は スーパーバイザー側（launchd/systemd/schtasks）の見解です。一方、接続プローブでは CLI が実際に Gateway WebSocket へ接続します。openclaw gateway status の次の行を確認してください。Probe target:（プローブが使用した URL）、Listening:（実際にそのポートへバインドされているもの）、Last gateway error:（プロセスは稼働しているもののポートがリッスンしていない場合によくある根本原因）。

編集している設定ファイルと、サービスが使用している設定ファイルが異なります（多くの場合、--profile / OPENCLAW_STATE_DIR の不一致です）。

修正するには、サービスに使用させたいものと同じ --profile / 環境から次を実行します。

openclaw gateway install --force

OpenClaw は、起動直後に WebSocket リスナー（デフォルトは ws://127.0.0.1:18789）をバインドすることで、ランタイムロックを適用します。EADDRINUSE によりバインドに失敗すると、GatewayLockError（「別の Gateway インスタンスがすでにリッスンしています」）がスローされます。

修正するには、もう一方のインスタンスを停止するか、ポートを解放するか、openclaw gateway --port <port> を指定して実行します。

gateway.mode: "remote" を設定してリモート WebSocket URL を指定します。必要に応じて、共有シークレットによるリモート認証情報も指定できます。

{  gateway: {    mode: "remote",    remote: {      url: "ws://gateway.tailnet:18789",      token: "your-token",      password: "your-password",    },  },}

• openclaw gateway は、gateway.mode が local の場合（またはオーバーライドフラグを渡した場合）にのみ起動します。
• macOS アプリは設定ファイルを監視し、これらの値が変更されると稼働中にモードを切り替えます。
• gateway.remote.token / .password はクライアント側のリモート認証情報にすぎません。これらだけではローカル Gateway の認証は有効になりません。

Gateway の認証経路と UI の認証方式が一致していません。

コードから確認できる事実:

• Control UI はトークンを sessionStorage に保持し、現在のブラウザタブと選択された Gateway URL にスコープを限定します。そのため、トークンを localStorage に長期間保存しなくても、同じタブでの更新後は引き続き動作します。
• AUTH_TOKEN_MISMATCH では、Gateway が再試行のヒント（canRetryWithDeviceToken=true、recommendedNextStep=retry_with_device_token）を返した場合、信頼済みクライアントはキャッシュされたデバイストークンを使用して、上限付きの再試行を 1 回実行できます。
• このキャッシュ済みトークンによる再試行では、デバイストークンとともに保存された承認済みスコープを再利用します。明示的な deviceToken / 明示的な scopes の呼び出し元は、キャッシュされたスコープを継承せず、要求したスコープセットを維持します。
• この再試行経路以外では、接続認証の優先順位は、明示的な共有トークンまたはパスワード、明示的な deviceToken、保存済みデバイストークン、ブートストラップトークンの順です。
• 組み込みのセットアップコードによるブートストラップは、scopes: [] を持つ Node デバイストークンと、信頼済みモバイルのオンボーディング用の有効範囲が限定されたオペレーターハンドオフトークンを返します。オペレーターハンドオフはセットアップ時のネイティブ設定を読み取れますが、ペアリング変更スコープや operator.admin は付与されません。

修正方法:

• 最速の方法: openclaw dashboard（ダッシュボード URL を表示してコピーし、開こうとします。ヘッドレス環境では SSH のヒントを表示します）。
• トークンがまだない場合: openclaw doctor --generate-gateway-token。
• リモートの場合: まず ssh -N -L 18789:127.0.0.1:18789 user@host でトンネルを確立し、次に http://127.0.0.1:18789/ を開きます。
• 共有シークレットモード: gateway.auth.token / OPENCLAW_GATEWAY_TOKEN または gateway.auth.password / OPENCLAW_GATEWAY_PASSWORD を設定し、対応するシークレットを Control UI の設定に貼り付けます。
• Tailscale Serve モード: gateway.auth.allowTailscale が有効であること、および Tailscale の ID ヘッダーを迂回する未加工の loopback/tailnet URL ではなく、Serve URL を開いていることを確認します。
• 信頼済みプロキシモード: 設定済みの ID 対応プロキシを経由していることを確認します。同一ホストの loopback プロキシでは gateway.auth.trustedProxy.allowLoopback = true も必要です。
• 1 回の再試行後も不一致が続く場合: ペアリング済みデバイストークンをローテーションまたは再承認します。

  openclaw devices listopenclaw devices rotate --device <id> --role operator

• ローテーションが拒否される場合: ペアリング済みデバイスのセッションがローテーションできるのは、そのデバイス 自身 のみです。ただし、operator.admin も持っている場合を除きます。また、明示的な --scope の値が、呼び出し元の現在のオペレータースコープを超えることはできません。
• それでも解決しない場合: openclaw status --all とトラブルシューティングを参照してください。認証の詳細についてはダッシュボードを参照してください。

tailnet バインドは、ネットワークインターフェースから Tailscale IP（100.64.0.0/10）を選択します。マシンが Tailscale に接続されていない場合（またはインターフェースが停止している場合）、Gateway は別のネットワークインターフェースを公開せず、loopback にフォールバックします。

修正するには、そのホストで Tailscale を起動して Gateway を再起動するか、明示的に gateway.bind: "loopback" / "lan" に切り替えます。

tailnet は明示的な指定です。auto は loopback を優先します。必須の同一ホスト 127.0.0.1 リスナーを維持しながら、loopback 以外への公開を Tailnet に制限するには、gateway.bind: "tailnet" を使用してください。

通常は必要ありません。1 つの Gateway で複数のメッセージングチャンネルとエージェントを実行できます。複数の Gateway は、冗長化（レスキューボットなど）または厳密な分離が必要な場合にのみ使用し、それぞれに独自の OPENCLAW_CONFIG_PATH、OPENCLAW_STATE_DIR、agents.defaults.workspace、および一意の gateway.port を設定して分離してください。

推奨: インスタンスごとに openclaw --profile <name> ...（~/.openclaw-<name> を自動作成）、プロファイル設定ごとに一意の gateway.port（手動実行の場合は --port）、および openclaw --profile <name> gateway install を使用したプロファイルごとのサービスを使用します。

プロファイルはサービス名にもサフィックスを付けます。launchd は ai.openclaw.<profile>、systemd は openclaw-gateway-<profile>.service、Windows は OpenClaw Gateway (<profile>) です。修飾なしの openclaw-gateway systemd ユニットは、デフォルトプロファイルにのみ存在します。名前変更前の従来の systemd ユニット名 clawdbot-gateway は自動的に移行されます。

詳細なガイド: 複数の Gateway。

Gateway は WebSocket サーバーであり、最初のメッセージとして connect フレームを想定しています。それ以外の場合、接続は コード 1008（ポリシー違反）で閉じられます。

よくある原因は、WS クライアントではなくブラウザで HTTP URL を開いた、誤ったポートやパスを使用した、またはプロキシやトンネルが認証ヘッダーを削除したか、Gateway 以外のリクエストを送信したことです。

修正するには、WS URL（ws://<host>:18789、HTTPS 経由の場合は wss://...）を使用し、通常のブラウザタブで WS ポートを開かず、認証が有効な場合は connect フレームにトークンまたはパスワードを含めます。CLI/TUI の例:

openclaw tui --url ws://<host>:18789 --token <token>

プロトコルの詳細: Gateway プロトコル。

ファイルログ（構造化）: /tmp/openclaw/openclaw-YYYY-MM-DD.log。安定したパスは logging.file、ファイルログレベルは logging.level、コンソールの詳細度は --verbose と logging.consoleLevel で設定します。

最速で追跡する方法:

openclaw logs --follow

サービスまたはスーパーバイザーのログ（Gateway を launchd/systemd 経由で実行している場合）:

• macOS launchd の stdout: ~/Library/Logs/openclaw/gateway.log（プロファイルでは gateway-<profile>.log を使用します。stderr は抑制されます）。
• Linux: journalctl --user -u openclaw-gateway[-<profile>].service -n 200 --no-pager。
• Windows: schtasks /Query /TN "OpenClaw Gateway (<profile>)" /V /FO LIST。

詳細はトラブルシューティングを参照してください。

openclaw gateway statusopenclaw gateway restart

Gateway を手動で実行している場合は、openclaw gateway --force でポートを再取得できます。Gatewayを参照してください。

Windows には 3 つのインストールモードがあります。

1) Windows Hub のローカルセットアップ: ネイティブアプリが、アプリ所有のローカル WSL Gateway を管理します。スタートメニューまたはトレイから OpenClaw Companion を開き、Gateway Setup または Connections タブを使用します。

2) 手動 WSL2 Gateway: Gateway は Linux 内で実行されます。

wslopenclaw gateway statusopenclaw gateway restart

サービスをインストールしていない場合は、フォアグラウンドで起動します: openclaw gateway run。

3) ネイティブ Windows CLI/Gateway: Windows で直接実行されます。

openclaw gateway statusopenclaw gateway restart

手動で実行する場合（サービスなし）: openclaw gateway run。

ドキュメント: Windows、Gateway サービス運用手順書。

簡単な健全性チェック:

openclaw statusopenclaw models statusopenclaw channels statusopenclaw logs --follow

一般的な原因: Gateway ホストでモデル認証が読み込まれていない（models status を確認）、チャンネルのペアリングまたは許可リストが応答をブロックしている（チャンネル設定とログを確認）、あるいは正しいトークンなしで WebChat/Dashboard を開いていることです。リモートの場合は、トンネル/Tailscale 接続が稼働しており、Gateway WebSocket に到達できることを確認してください。

ドキュメント: チャンネル、トラブルシューティング、リモートアクセス。

通常は、UI が WebSocket 接続を失ったことを意味します。次を確認してください: Gateway は実行中ですか（openclaw gateway status）？正常ですか（openclaw status）？UI に正しいトークンが設定されていますか（openclaw dashboard）？リモートの場合、トンネル/Tailscale リンクは稼働していますか？

次に、ログを追跡します:

openclaw logs --follow

ドキュメント: Dashboard、リモートアクセス、トラブルシューティング。

openclaw channels statusopenclaw channels logs --channel telegram

次に、該当するエラーを確認します:

• BOT_COMMANDS_TOO_MUCH: Telegram メニューの項目が多すぎます。OpenClaw はすでに Telegram の上限に合わせて項目を削減し、コマンド数を減らして再試行しますが、それでも一部のメニュー項目が除外される場合があります。Plugin/Skill/カスタムコマンドを減らすか、メニューが不要な場合は channels.telegram.commands.native を無効にしてください。
• TypeError: fetch failed、Network request for 'setMyCommands' failed!、または同様のネットワークエラー: VPS 上またはプロキシの背後で実行している場合は、送信 HTTPS が許可され、api.telegram.org の DNS 解決が機能することを確認してください。

Gateway がリモートにある場合は、Gateway ホスト上のログを確認してください。

ドキュメント: Telegram、チャンネルのトラブルシューティング。

openclaw statusopenclaw models statusopenclaw logs --follow

TUI では、/status を使用して現在の状態を確認します。チャットチャンネルで応答を受け取る想定の場合は、配信が有効になっていることを確認してください（/deliver on）。

ドキュメント: TUI、スラッシュコマンド。

サービスをインストールしている場合（macOS の launchd、Linux の systemd）:

openclaw gateway stopopenclaw gateway start

フォアグラウンドでは Ctrl-C で停止してから、openclaw gateway run を実行します。

ドキュメント: Gateway サービス運用手順書。

openclaw gateway restart はバックグラウンドサービス（launchd/systemd）を再起動します。openclaw gateway は、このターミナルセッションで Gateway をフォアグラウンド実行します。サービスをインストールしている場合は Gateway のサブコマンドを使用し、一度限りの実行にはサブコマンドなしのフォアグラウンド実行を使用してください。

コンソールに詳細を表示するには、--verbose で Gateway を起動し、チャンネル認証、モデルルーティング、RPC エラーについてログファイルを調べます。

エージェントから送信する添付ファイルには、media、mediaUrl、path、filePath などの構造化メディアフィールドを使用する必要があります。OpenClaw アシスタントのセットアップとエージェント送信を参照してください。

openclaw message send --target +15555550123 --message "こちらです" --media /path/to/file.png

次の点も確認してください: 対象チャンネルが送信メディアをサポートし、許可リストによってブロックされていないこと、ファイルがプロバイダーのサイズ制限内であること（画像は最長辺が 2048px になるようにリサイズされます）、tools.fs.workspaceOnly=true がローカルパスからの送信をワークスペース、一時/メディアストア、およびサンドボックスで検証済みのファイルに制限していること、tools.fs.workspaceOnly=false（デフォルト）により、構造化されたローカルメディア送信で、エージェントがすでに読み取れるホスト上のローカルファイルを、メディアと安全な文書形式（画像、音声、動画、PDF、Office 文書、および Markdown/MD、TXT、JSON、YAML/YML などの検証済みテキスト文書）に使用できることです。これはシークレットスキャナーではありません。拡張子と内容の検証が一致すれば、エージェントが読み取れる secret.txt や config.json も添付できます。機密ファイルはエージェントが読み取れるパスの外に置くか、ローカルパスからの送信をより厳格にするために tools.fs.workspaceOnly=true を維持してください。

画像を参照してください。

受信 DM は信頼できない入力として扱ってください。デフォルト設定によってリスクが軽減されます:

• DM 対応チャンネルのデフォルト動作はペアリングです。不明な送信者にはペアリングコードが送られ、そのメッセージは処理されません。openclaw pairing approve --channel <channel> [--account <id>] <code> で承認します。保留中のリクエストはチャンネルごとに 3 件に制限されています。コードが届かなかった場合は openclaw pairing list --channel <channel> [--account <id>] を確認してください。
• DM を一般公開するには、明示的なオプトイン（dmPolicy: "open" と許可リスト "*"）が必要です。

リスクのある DM ポリシーを検出するには、openclaw doctor を実行してください。

いいえ。プロンプトインジェクションは、ボットに DM できる相手だけでなく、信頼できないコンテンツに関する問題です。アシスタントが外部コンテンツ（Web 検索/取得、ブラウザページ、メール、文書、添付ファイル、貼り付けられたログ）を読み取る場合、そのコンテンツにはモデルを乗っ取ろうとする指示が含まれる可能性があります。送信者が自分だけでも同様です。

最大のリスクは、ツールが有効な場合です。モデルがだまされ、コンテキストを流出させたり、ユーザーに代わってツールを呼び出したりする可能性があります。影響範囲を縮小してください:

• 信頼できないコンテンツの要約には、読み取り専用またはツール無効の「リーダー」エージェントを使用する
• ツール有効のエージェントでは、web_search / web_fetch / browser を無効にしておく
• デコードされたファイル/文書テキストも信頼できないものとして扱う: OpenResponses の input_file とメディア添付ファイルの抽出はどちらも、生のファイルテキストを渡す代わりに、抽出されたテキストを明示的な外部コンテンツ境界マーカーで囲む
• サンドボックス化し、厳格なツール許可リストを使用する

詳細: セキュリティ。

言語とランタイムは重要ですが、個人用エージェントにとって主要なリスクではありません。実際のリスクは、Gateway の公開範囲、ボットにメッセージを送信できる相手、プロンプトインジェクション、ツールの権限範囲、認証情報の取り扱い、ブラウザアクセス、exec アクセス、第三者の Skill/Plugin の信頼性です。

Rust と WASM は一部のコードクラスに対してより強力な分離を提供できますが、プロンプトインジェクション、不適切な許可リスト、Gateway の一般公開、広すぎるツール権限、機密アカウントにログイン済みのブラウザプロファイルは解決しません。次を主要な制御策として扱ってください: Gateway を非公開または認証済みに保つ、DM/グループにペアリングと許可リストを使用する、信頼できない入力に対してリスクの高いツールを拒否またはサンドボックス化する、信頼できる Plugin と Skill のみをインストールする、設定変更後に openclaw security audit --deep を実行する。

詳細: セキュリティ、サンドボックス化。

openclaw security audit --deepopenclaw gateway status

より安全なベースライン: Gateway が loopback にバインドされているか、認証済みのプライベートアクセス（tailnet、SSH トンネル、トークン/パスワード認証、または正しく設定された信頼済みプロキシ）経由でのみ公開されていること、DM が pairing または allowlist モードであること、全メンバーが信頼できる場合を除き、グループが許可リストに登録され、メンション必須になっていること、信頼できないコンテンツを読み取るエージェントでは高リスクのツール（exec、browser、gateway、cron）が拒否されているか、厳密に範囲制限されていること、ツール実行の影響範囲を縮小する必要がある場合にサンドボックス化が有効になっていることです。

認証なしの公開バインド、ツールが有効な状態での公開 DM/グループ、公開されたブラウザ制御を最初に修正してください。詳細: openclaw security audit。

第三者の Skills と Plugin は、信頼することを選択したコードとして扱ってください。ClawHub の Skill ページではインストール前にスキャン状態が表示されますが、スキャンは完全なセキュリティ境界ではありません。OpenClaw は、Plugin/Skill のインストールまたは更新時に、組み込みのローカル危険コードブロックを実行しません。ローカルでの許可/ブロックの判断には、運用者が管理する security.installPolicy を使用してください。

より安全な方法: 信頼できる作者と固定バージョンを優先し、Skill/Plugin を有効にする前に内容を読み、Plugin/Skill の許可リストを必要最小限に保ち、信頼できない入力を扱うワークフローは最小限のツールを備えたサンドボックス内で実行し、第三者コードに広範なファイルシステム、exec、ブラウザ、シークレットへのアクセスを与えないでください。

詳細: Skills、Plugin、セキュリティ。

ほとんどの構成では、はい。ボットに別のアカウントと電話番号を使用して分離すると、問題が発生した場合の影響範囲が縮小され、個人アカウントに影響を与えずに認証情報をローテーションしたり、アクセスを取り消したりしやすくなります。

最小構成から始めてください。実際に必要なツールとアカウントにのみアクセスを許可し、必要に応じて後から拡張してください。

ドキュメント: セキュリティ、ペアリング。

個人メッセージに対する完全な自律操作は推奨しません。最も安全な方法は、DM をペアリングモードまたは厳格な許可リストに保ち、ユーザーに代わってメッセージを送信させる場合は別の番号またはアカウントを使用し、送信前にユーザーが承認する形で下書きを作成させることです。

試す場合は、専用の隔離されたアカウントで行ってください。セキュリティを参照してください。

はい。エージェントがチャット専用で、入力が信頼できる場合に限ります。小規模なモデル層は指示の乗っ取りを受けやすいため、ツール有効のエージェントや信頼できないコンテンツを読み取る場合には避けてください。小規模なモデルを使用する必要がある場合は、ツールを厳格に制限し、サンドボックス内で実行してください。セキュリティを参照してください。

ペアリングコードは、不明な送信者がボットにメッセージを送り、dmPolicy: "pairing" が有効な場合にのみ送信されます。/start だけではコードは生成されません。

保留中のリクエストを確認します:

openclaw pairing list telegram

すぐにアクセスするには、送信者 ID を許可リストに追加するか、そのアカウントに dmPolicy: "open" を設定してください。

いいえ。WhatsApp のデフォルト DM ポリシーはペアリングです。不明な送信者が受け取るのはペアリングコードだけで、そのメッセージは処理されません。OpenClaw は、受信したチャット、またはユーザーが明示的に実行した送信に対してのみ応答します。

openclaw pairing approve whatsapp <code>openclaw pairing list whatsapp

ウィザードの電話番号プロンプトでは、自分自身の DM を許可するための 許可リスト/所有者 を設定します。これは自動送信には使用されません。個人の WhatsApp 番号では、その番号を使用して channels.whatsapp.selfChatMode を有効にしてください。

ほとんどの内部メッセージやツールメッセージは、そのセッションで 詳細表示、トレース、または 推論 が有効な場合にのみ表示されます。

表示されているチャットで次を実行して修正します。

/verbose off/trace off/reasoning off

それでもメッセージが多い場合は、Control UI でセッション設定を確認し、verbose を 継承 に設定してください。また、設定で verboseDefault: "on" が指定されたボットプロファイルを使用していないことを確認してください。

ドキュメント: 思考と詳細表示、セキュリティ。

中止をトリガーするには、次のいずれかを 単独のメッセージとして（スラッシュなしで）送信します: stop、stop action、stop current action、stop run、stop current run、stop agent、stop the agent、stop openclaw、openclaw stop、stop don't do anything、stop do not do anything、stop doing anything、do not do that、please stop、stop please、abort、esc、exit、interrupt、halt。英語以外の一般的なトリガー（フランス語、ドイツ語、スペイン語、中国語、日本語、ヒンディー語、アラビア語、ロシア語）も機能します。

exec ツールによって開始されたバックグラウンドプロセスについては、エージェントに次を実行するよう依頼してください。

process action:kill sessionId:XXX

ほとんどのスラッシュコマンドは、/ で始まる 単独の メッセージとして送信する必要がありますが、一部のショートカット（/status など）は、許可リストに登録された送信者であればインラインでも機能します。スラッシュコマンドを参照してください。

OpenClaw はデフォルトで プロバイダー間 のメッセージングをブロックします。ツール呼び出しが Telegram にバインドされている場合、明示的に許可しない限り Discord には送信されません。この設定は即時に反映され、Gateway の再起動は不要です。

{  tools: {    message: {      crossContext: {        allowAcrossProviders: true,        marker: { enabled: true, prefix: "[from {channel}] " },      },    },  },}

デフォルトでは、実行途中のプロンプトはアクティブな実行へ誘導されます。/queue を使用して、アクティブな実行中の動作を選択します。

• steer（デフォルト）- 次のモデル境界でアクティブな実行を誘導します。
• followup - メッセージをキューに入れ、現在の実行終了後に 1 件ずつ実行します。
• collect - 互換性のあるメッセージをキューに入れ、現在の実行終了後に 1 回だけ応答します。
• interrupt - 現在の実行を中止し、新しく開始します。

debounce:0.5s cap:25 drop:summarize のように、キューモードへオプションを追加できます。コマンドキューおよびステアリングキューを参照してください。

認証情報とモデル選択は別々です。ANTHROPIC_API_KEY を設定する（または認証プロファイルに Anthropic API キーを保存する）と認証が有効になりますが、実際のデフォルトモデルは agents.defaults.model.primary で設定したものです（たとえば anthropic/claude-sonnet-4-6 または anthropic/claude-opus-4-6）。No credentials found for profile "anthropic:default" は、実行中のエージェントについて想定される auth-profiles.json で Anthropic の認証情報を Gateway が見つけられなかったことを意味します。