メインコンテンツへスキップ

​
openclaw browser

OpenClaw のブラウザー制御サーフェスを管理し、ブラウザー操作を実行します（ライフサイクル、プロファイル、タブ、スナップショット、スクリーンショット、ナビゲーション、入力、状態エミュレーション、デバッグ）。 関連:

​
共通フラグ

  • --url <gatewayWsUrl>: Gateway WebSocket URL（デフォルトは設定値）。
  • --token <token>: Gateway トークン（必要な場合）。
  • --timeout <ms>: リクエストタイムアウト（ms）。
  • --expect-final: 最終的な Gateway 応答を待機します。
  • --browser-profile <name>: ブラウザープロファイルを選択します（デフォルトは設定値）。
  • --json: 機械可読な出力（サポートされる場合）。

​
クイックスタート（ローカル）

openclaw browser profiles
openclaw browser --browser-profile openclaw start
openclaw browser --browser-profile openclaw open https://example.com
openclaw browser --browser-profile openclaw snapshot

​
ライフサイクル

openclaw browser status
openclaw browser start
openclaw browser stop
openclaw browser --browser-profile openclaw reset-profile
注意:
  • attachOnly およびリモート CDP プロファイルでは、openclaw browser stop は、 OpenClaw 自身がブラウザープロセスを起動していない場合でも、アクティブな 制御セッションを閉じ、一時的なエミュレーション上書きをクリアします。
  • ローカル管理プロファイルでは、openclaw browser stop は起動されたブラウザー プロセスを停止します。

​
コマンドが存在しない場合

openclaw browser が不明なコマンドである場合は、 ~/.openclaw/openclaw.json の plugins.allow を確認してください。 plugins.allow が存在する場合、バンドルされた browser プラグインを明示的に 一覧に含める必要があります。 
{
  plugins: {
    allow: ["telegram", "browser"],
  },
}
プラグイン許可リストから browser が除外されている場合、browser.enabled=true を設定しても CLI サブコマンドは復元されません。 関連: Browser tool

​
プロファイル

プロファイルは名前付きのブラウザールーティング設定です。実際には次の意味になります。
  • openclaw: 専用の OpenClaw 管理 Chrome インスタンスを起動または接続します（分離された user data dir）。
  • user: Chrome DevTools MCP 経由で、既存のサインイン済み Chrome セッションを制御します。
  • カスタム CDP プロファイル: ローカルまたはリモートの CDP エンドポイントを指します。
openclaw browser profiles
openclaw browser create-profile --name work --color "#FF5A36"
openclaw browser create-profile --name chrome-live --driver existing-session
openclaw browser create-profile --name remote --cdp-url https://browser-host.example.com
openclaw browser delete-profile --name work
特定のプロファイルを使うには: 
openclaw browser --browser-profile work tabs

​
タブ

openclaw browser tabs
openclaw browser tab new
openclaw browser tab select 2
openclaw browser tab close 2
openclaw browser open https://docs.openclaw.ai
openclaw browser focus <targetId>
openclaw browser close <targetId>

​
スナップショット / スクリーンショット / アクション

スナップショット: 
openclaw browser snapshot
スクリーンショット: 
openclaw browser screenshot
openclaw browser screenshot --full-page
openclaw browser screenshot --ref e12
注意:
  • --full-page はページ全体のキャプチャ専用で、--ref や --element とは併用できません。
  • existing-session / user プロファイルは、ページスクリーンショットと、 スナップショット出力からの --ref スクリーンショットをサポートしますが、 CSS --element スクリーンショットはサポートしません。
ナビゲーション/クリック/入力（ref ベースの UI 自動化）: 
openclaw browser navigate https://example.com
openclaw browser click <ref>
openclaw browser type <ref> "hello"
openclaw browser press Enter
openclaw browser hover <ref>
openclaw browser scrollintoview <ref>
openclaw browser drag <startRef> <endRef>
openclaw browser select <ref> OptionA OptionB
openclaw browser fill --fields '[{"ref":"1","value":"Ada"}]'
openclaw browser wait --text "Done"
openclaw browser evaluate --fn '(el) => el.textContent' --ref <ref>
ファイル + ダイアログ補助: 
openclaw browser upload /tmp/openclaw/uploads/file.pdf --ref <ref>
openclaw browser waitfordownload
openclaw browser download <ref> report.pdf
openclaw browser dialog --accept

​
状態とストレージ

ビューポート + エミュレーション: 
openclaw browser resize 1280 720
openclaw browser set viewport 1280 720
openclaw browser set offline on
openclaw browser set media dark
openclaw browser set timezone Europe/London
openclaw browser set locale en-GB
openclaw browser set geo 51.5074 -0.1278 --accuracy 25
openclaw browser set device "iPhone 14"
openclaw browser set headers '{"x-test":"1"}'
openclaw browser set credentials myuser mypass
Cookies + ストレージ: 
openclaw browser cookies
openclaw browser cookies set session abc123 --url https://example.com
openclaw browser cookies clear
openclaw browser storage local get
openclaw browser storage local set token abc123
openclaw browser storage session clear

​
デバッグ

openclaw browser console --level error
openclaw browser pdf
openclaw browser responsebody "**/api"
openclaw browser highlight <ref>
openclaw browser errors --clear
openclaw browser requests --filter api
openclaw browser trace start
openclaw browser trace stop --out trace.zip

​
MCP 経由の既存 Chrome

組み込みの user プロファイルを使うか、自分で existing-session プロファイルを作成します。 
openclaw browser --browser-profile user tabs
openclaw browser create-profile --name chrome-live --driver existing-session
openclaw browser create-profile --name brave-live --driver existing-session --user-data-dir "~/Library/Application Support/BraveSoftware/Brave-Browser"
openclaw browser --browser-profile chrome-live tabs
この経路はホスト専用です。Docker、ヘッドレスサーバー、Browserless、またはその他のリモート構成では、代わりに CDP プロファイルを使用してください。 現在の existing-session の制限:
  • スナップショット駆動の操作は CSS セレクターではなく ref を使用します
  • 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 プロファイルが必要です

​
リモートブラウザー制御（node host プロキシ）

Gateway がブラウザーとは別のマシンで動作している場合は、Chrome/Brave/Edge/Chromium があるマシン上で node host を実行してください。Gateway はブラウザー操作をそのノードにプロキシします（別個のブラウザー制御サーバーは不要です）。 自動ルーティングを制御するには gateway.nodes.browser.mode を使用し、複数ノードが接続されている場合に特定ノードへ固定するには gateway.nodes.browser.node を使用します。 セキュリティ + リモートセットアップ: Browser tool, Remote access, Tailscale, Security