openclaw browser
OpenClawのブラウザ制御サーバーを管理し、ブラウザアクション(タブ、スナップショット、スクリーンショット、ナビゲーション、クリック、入力)を実行します。
関連:
- ブラウザツール + API: Browser tool
- Chrome拡張機能リレー: Chrome extension
共通フラグ
--url <gatewayWsUrl>: Gateway WebSocket URL(デフォルトは設定値)。--token <token>: Gatewayトークン(必要な場合)。--timeout <ms>: リクエストタイムアウト(ミリ秒)。--browser-profile <name>: ブラウザプロファイルを選択(デフォルトは設定値)。--json: 機械可読な出力(対応している場合)。
クイックスタート(ローカル)
openclaw browser --browser-profile chrome tabs
openclaw browser --browser-profile openclaw start
openclaw browser --browser-profile openclaw open https://example.com
openclaw browser --browser-profile openclaw snapshot
プロファイル
プロファイルは名前付きのブラウザルーティング設定です。実際には:
openclaw: 専用のOpenClaw管理Chromeインスタンスを起動/接続(分離されたユーザーデータディレクトリ)。chrome: Chrome拡張機能リレー経由で既存のChromeタブを制御。
openclaw browser profiles
openclaw browser create-profile --name work --color "#FF5A36"
openclaw browser delete-profile --name work
特定のプロファイルを使用:
openclaw browser --browser-profile work tabs
タブ
openclaw browser tabs
openclaw browser open https://docs.openclaw.ai
openclaw browser focus <targetId>
openclaw browser close <targetId>
スナップショット / スクリーンショット / アクション
スナップショット:
openclaw browser snapshot
スクリーンショット:
openclaw browser screenshot
ナビゲーション/クリック/入力(refベースのUI自動化):
openclaw browser navigate https://example.com
openclaw browser click <ref>
openclaw browser type <ref> "hello"
Chrome拡張機能リレー(ツールバーボタンで接続)
このモードでは、手動で接続した既存のChromeタブをエージェントが制御できます(自動接続ではありません)。
安定したパスにアンパック拡張機能をインストール:
openclaw browser extension install
openclaw browser extension path
次にChrome → chrome://extensions → 「デベロッパーモード」を有効化 → 「パッケージ化されていない拡張機能を読み込む」 → 表示されたフォルダを選択。
完全ガイド: Chrome extension
リモートブラウザ制御(Nodeホストプロキシ)
GatewayがブラウザとはNode異なるマシンで動作している場合、Chrome/Brave/Edge/ChromiumがあるマシンでNodeホストを実行します。GatewayがブラウザアクションをそのNodeにプロキシします(別途ブラウザ制御サーバーは不要)。
gateway.nodes.browser.modeで自動ルーティングを制御し、複数のNodeが接続されている場合はgateway.nodes.browser.nodeで特定のNodeを固定します。
セキュリティ + リモートセットアップ: Browser tool, Remote access, Tailscale, Security