Chrome 拡張機能を使って既存のブラウザタブを操作する

自動化ツールを動かそうとしたら、ログイン情報のない真っさらなブラウザが立ち上がってしまい、結局手動でログインし直すことになった……。そんな経験はありませんか？開発中、普段使っているタブやログイン済みのセッションをそのままエージェントに操作させたい場面は多いはずです。

OpenClaw の Chrome 拡張機能（browser relay）を使えば、エージェント専用のプロファイルを新しく作るのではなく、あなたが今開いている Chrome のタブを直接コントロールできるようになります。

必要なもの

セットアップを始める前に、以下の準備ができているか確認してください。

• OpenClaw がインストールされていること
• Google Chrome ブラウザ
• ローカルで動作する Gateway または Node.js ホスト

クイックスタート

5分ほどで、あなたの Chrome をエージェントと連携させることができます。

1. 拡張機能のインストール

まず、拡張機能のファイルをローカルの安定したパスにインストールします。

openclaw browser extension install

次に、インストールされたディレクトリのパスを確認します。

openclaw browser extension path

2. Chrome への読み込み

Chrome を開き、アドレスバーに chrome://extensions と入力します。

• 「デベロッパー モード」をオンにします。
• 「パッケージ化されていない拡張機能を読み込む」をクリックし、先ほど確認したディレクトリを選択します。
• ツールバーに拡張機能をピン留めしておくと便利です。

3. タブの操作

操作したいタブを開き、拡張機能のアイコンをクリックします。バッジが ON になれば、OpenClaw から操作可能な状態です。

4. 実行

OpenClaw には、この拡張機能を利用するための chrome というプロファイルが標準で用意されています。

CLI から試す場合：

openclaw browser --browser-profile chrome tabs

エージェントの Tool として使う場合は、browser Tool の引数に profile="chrome" を指定してください。

独自のプロファイル名やポートを使いたい場合は、以下のコマンドで作成できます。

openclaw browser create-profile \
  --name my-chrome \
  --driver extension \
  --cdp-url http://127.0.0.1:18792 \
  --color "#00AA00"

トラブルシューティング

拡張機能のアイコンに表示されるバッジの状態を確認してください。

• …（接続中）: ローカルの relay サーバーに接続しようとしています。
• !（エラー）: relay サーバーに到達できません。Gateway がローカルで実行されているか、またはこのマシンで Node.js ホストが動作しているか確認してください。拡張機能の「オプション」ページを開くと、詳細な接続状態を確認できます。
• 操作できない: 拡張機能は「今見ているタブ」を自動で操作するわけではありません。ツールバーのボタンをクリックして、明示的にアタッチしたタブのみを操作します。

セキュリティについて

この機能は非常に強力です。モデルに「自分のブラウザを直接操作する手」を与えることと同じだと考えてください。

• 拡張機能は Chrome の chrome.debugger API を使用します。アタッチされたタブでは、モデルはクリックや入力、ページ内容の読み取り、ログイン済みセッションへのアクセスが可能です。
• 隔離された環境ではないため、普段使いのプロファイルで実行すると、そのアカウントの状態にモデルがアクセスすることになります。
• 可能な限り、個人用のブラウザとは別の専用 Chrome プロファイルを用意して使用することをおすすめします。

AI Setup Assistant でセットアップのサポートを受けることもできます。

次のステップ

• Browser Tool の概要
• Gateway のセキュリティ設定
• Tailscale を使ったセットアップ