English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisहिन्दीالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiРусскийفارسیไทย
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page

Tools

Chrome 拡張機能

Chrome 拡張機能

OpenClaw Chrome 拡張機能を使うと、エージェントは別の管理対象ブラウザーを起動せずに、また Chrome のブロック型の「Allow remote debugging?」プロンプトなしで、サインイン済みの Chrome タブを制御できます。

これは、スマートフォン (Telegram、WhatsApp など) から OpenClaw を操作するときに重要です。 user プロファイル は Chrome のリモートデバッグポート経由で接続しますが、その場合、外出中には誰もクリックできないデスクトップの同意ダイアログが表示されます。拡張機能は代わりに chrome.debugger API を使用するため、ページ内に表示される唯一の通知は、閉じることができる Chrome の「OpenClaw started debugging this browser」バナーです。

これは、Anthropic の Claude in Chrome と OpenAI の Codex Chrome 拡張機能で使われているものと同じ形です。

仕組み

3 つの部分で構成されます。

  • ブラウザー制御サービス (Gateway または node ホスト): browser ツールが呼び出す API。
  • 拡張機能リレー (local loopback WebSocket): 制御サービスが 127.0.0.1 で起動する小さなサーバー。OpenClaw に Chrome DevTools Protocol エンドポイントを提示し、拡張機能と通信します。双方はホストローカルのトークンで認証します (下記参照)。
  • OpenClaw Chrome 拡張機能 (MV3): chrome.debugger でタブに接続し、 CDP トラフィックを転送し、OpenClaw タブグループを管理します。

OpenClaw は OpenClaw タブグループ内にあるタブだけを認識し、制御します。このグループが同意の境界です。タブをドラッグして中に入れると共有され、外に出す (またはツールバーボタンをクリックする) と即座にアクセスを取り消せます。

インストールとペアリング

  1. 展開済み拡張機能のパスを表示します。

    bash
    openclaw browser extension path

  2. chrome://extensions を開き、デベロッパー モードを有効にして、パッケージ化されていない拡張機能を読み込むをクリックし、表示されたディレクトリを選択します。

  3. ペアリング文字列を表示します。

    bash
    openclaw browser extension pair

  4. OpenClaw ツールバーアイコンをクリックし、ペアリング文字列をポップアップに貼り付けます。 拡張機能がリレーに接続すると、バッジが ON になります。

ペアリングトークンは初回使用時に作成され、状態ディレクトリ内の credentials/ に保存される ホストローカルのシークレットです (モード 0600)。ブラウザーを実行する各マシン (Gateway ホストとすべてのブラウザー node ホスト) がそれぞれ独自のトークンを持つため、認証情報をマシン間で移動する必要はありません。ローテーションするには、browser-extension-relay.secret ファイルを削除して、もう一度ペアリングします。

使い方

browser ツール呼び出しで組み込みの chrome プロファイルを選択するか、デフォルトにします。

bash
openclaw config set browser.defaultProfile chrome
json5
{  browser: {    profiles: {      chrome: { driver: "extension", color: "#FF4500" },    },  },}
  • タブを共有する: そのタブで OpenClaw ツールバーボタンをクリックする (OpenClaw タブグループに参加します) か、任意のタブをグループにドラッグします。
  • エージェントは新しいタブも開けます。それらは自動的にグループに入ります。
  • 取り消す: ボタンをもう一度クリックする、タブをグループの外へドラッグする、または Chrome のデバッグバナーを閉じます。エージェントはそのタブへのアクセスをただちに失います。

リモートブラウザー node

拡張機能は、Chrome が Gateway ホストで動作している場合でも、別の ブラウザー node ホスト で動作している場合でも機能します。リレーは常に loopback のみで、ブラウザーがあるマシン上で動作します。

  • 同一ホスト (Gateway + Chrome が 1 台のマシン上): そのマシンでペアリングします。
  • リモート node (Chrome は node 上、Gateway は別の場所): openclaw browser extension path / pair を node 上で実行し、そこで拡張機能を読み込んでペアリングします。Gateway は、既存の認証済み node リンク経由でブラウザー操作を node にプロキシします。node のローカルリレーが拡張機能を駆動します。 node に新しいインバウンドポートは開かれません。

ペアリングトークンはホストごとなので、各 node が独自の文字列を表示します。

診断

bash
openclaw browser status --browser-profile chromeopenclaw browser doctor --browser-profile chrome

doctor は、拡張機能ポップアップに Connected と表示されるまで、Chrome 拡張機能リレーチェックを失敗として報告します。

セキュリティモデル

  • リレーは loopback のみにバインドされます。WebSocket の双方は派生トークンで認証され、拡張機能側は chrome-extension:// に対してオリジンチェックされます。
  • エージェントが表示および操作できるのは、OpenClaw タブグループ内のタブだけです。その他のタブは非公開のままです。
  • リモートデバッグプロンプトを承認するとサインイン済みブラウザー全体を公開する user (Chrome MCP) プロファイルと比べて、拡張機能は共有範囲を、ひと目で管理できるタブグループに限定します。

関連項目: プロファイルモデル全体、および管理対象の openclaw プロファイルと Chrome MCP user プロファイルについては、ブラウザー を参照してください。

Was this useful?
On this page

On this page