​

Chrome 拡張機能

​

仕組み

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

​

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

1. 展開済み拡張機能のパスを表示します。
   openclaw browser extension path
   
2. chrome://extensions を開き、デベロッパー モードを有効にして、パッケージ化されていない拡張機能を読み込むをクリックし、表示されたディレクトリを選択します。
3. ペアリング文字列を表示します。
   openclaw browser extension pair
   
4. OpenClaw ツールバーアイコンをクリックし、ペアリング文字列をポップアップに貼り付けます。 拡張機能がリレーに接続すると、バッジが ON になります。

​

使い方

openclaw config set browser.defaultProfile chrome

{
  browser: {
    profiles: {
      chrome: { driver: "extension", color: "#FF4500" },
    },
  },
}

• タブを共有する: そのタブで OpenClaw ツールバーボタンをクリックする (OpenClaw タブグループに参加します) か、任意のタブをグループにドラッグします。
• エージェントは新しいタブも開けます。それらは自動的にグループに入ります。
• 取り消す: ボタンをもう一度クリックする、タブをグループの外へドラッグする、または Chrome のデバッグバナーを閉じます。エージェントはそのタブへのアクセスをただちに失います。

​

リモートブラウザー node

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

​

診断

openclaw browser status --browser-profile chrome
openclaw browser doctor --browser-profile chrome

​

セキュリティモデル

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