Documentation Index
Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
openclaw browser
OpenClaw のブラウザ制御サーフェスを管理し、ブラウザアクション（ライフサイクル、プロファイル、タブ、スナップショット、スクリーンショット、ナビゲーション、入力、状態エミュレーション、デバッグ）を実行します。
関連:
- ブラウザツール + API: ブラウザツール
共通フラグ
--url <gatewayWsUrl>: Gateway WebSocket URL（デフォルトは設定）。--token <token>: Gateway トークン（必要な場合）。--timeout <ms>: リクエストタイムアウト（ms）。--expect-final: 最終 Gateway レスポンスを待機します。--browser-profile <name>: ブラウザプロファイルを選択します（デフォルトは設定から取得）。--json: 機械可読出力（サポートされている場合）。
クイックスタート（ローカル）
browser({ action: "doctor" }) で同じ準備状況チェックを実行できます。
クイックトラブルシューティング
start が not reachable after start で失敗する場合は、まず CDP の準備状況をトラブルシュートしてください。start と tabs は成功するのに open または navigate が失敗する場合、ブラウザ制御プレーンは正常で、通常はナビゲーション SSRF ポリシーが原因です。
最小シーケンス:
ライフサイクル
doctor --deepはライブスナップショットプローブを追加します。基本的な CDP 準備状況が正常でも、現在のタブを検査できる証拠が必要な場合に便利です。attachOnlyとリモート CDP プロファイルでは、openclaw browser stopは アクティブな制御セッションを閉じ、一時的なエミュレーション上書きをクリアします。これは OpenClaw 自体がブラウザプロセスを起動していない場合でも同じです。- ローカル管理プロファイルでは、
openclaw browser stopは生成されたブラウザ プロセスを停止します。 openclaw browser start --headlessは、その start リクエストにのみ適用され、 OpenClaw がローカル管理ブラウザを起動する場合にのみ適用されます。これはbrowser.headlessやプロファイル設定を書き換えず、すでに実行中の ブラウザでは何もしません。DISPLAYまたはWAYLAND_DISPLAYがない Linux ホストでは、ローカル管理プロファイルはOPENCLAW_BROWSER_HEADLESS=0、browser.headless=false、またはbrowser.profiles.<name>.headless=falseが 表示ブラウザを明示的に要求しない限り、自動的にヘッドレスで実行されます。
コマンドが見つからない場合
openclaw browser が不明なコマンドの場合は、
~/.openclaw/openclaw.json の plugins.allow を確認してください。
plugins.allow が存在する場合、設定にルート browser ブロックがすでにない限り、
バンドルされたブラウザ Plugin を明示的に一覧に含めます。
browser.enabled=true や browser.profiles.<name> のような明示的なルート browser ブロックも、
制限付き Plugin 許可リストの下でバンドルされたブラウザ Plugin を有効化します。
関連: ブラウザツール
プロファイル
プロファイルは名前付きのブラウザルーティング設定です。実際には次のように使われます。openclaw: 専用の OpenClaw 管理 Chrome インスタンス（分離されたユーザーデータディレクトリ）を起動または接続します。user: Chrome DevTools MCP 経由で、既存のサインイン済み Chrome セッションを制御します。- カスタム CDP プロファイル: ローカルまたはリモートの CDP エンドポイントを指します。
タブ
tabs はまず suggestedTargetId を返し、次に t1 などの安定した tabId、
任意のラベル、未加工の targetId を返します。エージェントは
suggestedTargetId を focus、close、スナップショット、アクションに渡し直す必要があります。
ラベルは open --label、tab new --label、または tab label で割り当てられます。ラベル、
タブ ID、未加工ターゲット ID、一意なターゲット ID プレフィックスはいずれも受け付けられます。
ナビゲーションまたはフォーム送信中に Chromium が基盤の未加工ターゲットを置き換える場合、
OpenClaw は一致を証明できるとき、安定した tabId/ラベルを置き換え後のタブに紐付けたままにします。
未加工ターゲット ID は変化しやすいため、suggestedTargetId を優先してください。
スナップショット / スクリーンショット / アクション
スナップショット:--full-pageはページキャプチャ専用です。--refまたは--elementと組み合わせることはできません。existing-session/userプロファイルは、ページスクリーンショットとスナップショット出力からの--refスクリーンショットをサポートしますが、CSS--elementスクリーンショットはサポートしません。--labelsは現在のスナップショット参照をスクリーンショット上に重ねます。snapshot --urlsは検出されたリンク先を AI スナップショットに追加するため、 エージェントはリンクテキストだけから推測せずに直接ナビゲーション先を選択できます。
targetId を返します。スクリプトは長期間のワークフローでは引き続き
suggestedTargetId/ラベルを保存して渡す必要があります。
ファイル + ダイアログヘルパー:
/tmp/openclaw/downloads、または設定された一時
ルート）に保存します。エージェントが特定のファイルを待機してそのパスを返す必要がある場合は、
waitfordownload または download を使用してください。これらの明示的な待機処理が次のダウンロードを所有します。
状態とストレージ
ビューポート + エミュレーション:デバッグ
MCP 経由の既存の Chrome
組み込みのuser プロファイルを使用するか、独自の existing-session プロファイルを作成します。
- スナップショット駆動のアクションは CSS セレクタではなく参照を使用します
- 呼び出し元が
timeoutMsを省略した場合、browser.actionTimeoutMsはサポート対象のactリクエストをデフォルトで 60000 ms にします。呼び出しごとのtimeoutMsがある場合はそちらが優先されます。 clickは左クリックのみですtypeはslowly=trueをサポートしませんpressはdelayMsをサポートしませんhover、scrollintoview、drag、select、fill、evaluateは 呼び出しごとのタイムアウト上書きを拒否しますselectは 1 つの値のみサポートしますwait --load networkidleはサポートされていません- ファイルアップロードには
--ref/--input-refが必要で、CSS--elementはサポートせず、現在は一度に 1 ファイルのみサポートします - ダイアログフックは
--timeoutをサポートしません - スクリーンショットはページキャプチャと
--refをサポートしますが、CSS--elementはサポートしません responsebody、ダウンロードインターセプト、PDF エクスポート、バッチアクションには、引き続き 管理ブラウザまたは未加工 CDP プロファイルが必要です
リモートブラウザ制御（ノードホストプロキシ）
Gateway がブラウザとは別のマシンで実行されている場合、Chrome/Brave/Edge/Chromium があるマシンで ノードホスト を実行します。Gateway はブラウザアクションをそのノードにプロキシします（別個のブラウザ制御サーバーは不要です）。gateway.nodes.browser.mode を使用して自動ルーティングを制御し、複数のノードが接続されている場合は gateway.nodes.browser.node で特定のノードを固定します。
セキュリティ + リモート設定: ブラウザツール, リモートアクセス, Tailscale, セキュリティ