OpenClaw Browser操作ガイド：コマンドでブラウザを自動化する

ブラウザ操作の自動化や管理は、開発者にとって時に煩雑な作業になりがちです。スクリプトを組むたびに環境設定に悩まされたり、既存のブラウザセッションをうまく活用できなかったりといった経験はないでしょうか。

OpenClaw を使えば、ブラウザの制御サーバーをスマートに管理し、タブ操作やスクリーンショット、ナビゲーションなどのアクションを直感的に実行できるようになります。

openclaw browser

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

関連ドキュメント：

• Browser tool + API: Browser tool

共通のフラグ

• --url <gatewayWsUrl>: Gateway WebSocket URL (デフォルトは設定値)。
• --token <token>: Gateway トークン (必要な場合)。
• --timeout <ms>: リクエストのタイムアウト (ms)。
• --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 が不明なコマンドとして表示される場合は、~/.openclaw/openclaw.json の plugins.allow を確認してください。

plugins.allow が設定されている場合、同梱されているブラウザプラグインを明示的にリストに含める必要があります。

{
  plugins: {
    allow: ["telegram", "browser"],
  },
}

browser.enabled=true に設定されていても、プラグインの許可リストから browser が除外されていると、CLI サブコマンドは利用できません。

関連ドキュメント： Browser tool

プロファイル

プロファイルは、名前付きのブラウザルーティング設定です。実際には以下のように使い分けます。

• openclaw: OpenClaw が管理する専用の Chrome インスタンスを起動またはアタッチします（独立したユーザーデータディレクトリ）。
• 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 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

ナビゲーション / クリック / 入力（参照ベースの UI 自動化）：

openclaw browser navigate https://example.com
openclaw browser click <ref>
openclaw browser type <ref> "hello"

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 プロファイルを使用してください。

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

Gateway がブラウザとは別のマシンで動作している場合は、Chrome / Brave / Edge / Chromium がインストールされているマシンで node host を実行してください。Gateway はブラウザアクションをそのノードにプロキシします（個別のブラウザ制御サーバーは不要です）。

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

セキュリティとリモート設定: Browser tool, Remote access, Tailscale, Security

次のステップ

• Browser tool
• Remote access
• Security

AI Setup Assistant