openclaw browser

OpenClawのブラウザ制御サーバーを管理し、ブラウザアクション（タブ、スナップショット、スクリーンショット、ナビゲーション、クリック、入力）を実行します。

関連:

共通フラグ

  • --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がブラウザとは異なるマシンで実行されている場合、Chrome/Brave/Edge/Chromiumがあるマシンでnodeホストを実行します。Gatewayはそのnodeにブラウザアクションをプロキシします（別のブラウザ制御サーバーは不要）。

gateway.nodes.browser.modeを使用して自動ルーティングを制御し、gateway.nodes.browser.nodeを使用して複数接続されている場合に特定のnodeをピン留めします。

セキュリティ + リモートセットアップ: Browser tool, Remote access, Tailscale, Security

← ドキュメントに戻る