FAQ

製品バージョン

Kimi WebBridge と Kimi ブラウザ拡張機能はどのような関係ですか？

Kimi WebBridge は Kimi ブラウザ拡張機能に改称され、ブラウザサイドバー入口、ウェブ操作の録画、ウェブページを指示に分解する機能などが追加されました。ローカルエージェントから拡張機能を呼び出す方法に変更はなく、引き続きそのまま使用できます。新しいサイドバー入口は、Kimi アカウントでログインして使用します。

サイドバーの使い方

会話履歴は kimi.com や Kimi デスクトップ版と同期されますか？

いいえ。サイドバーの会話履歴は現在のブラウザにのみ保存され、アカウントごとにデフォルトで最新の 10 件が保持されます。長期保存するには、回答の下にある「Export」をクリックし、内容を Markdown（.md）ファイルとして保存してください。

インストールと設定

対応しているブラウザは？

現在は Chrome と Edge に対応しています。最適な体験のため、最新バージョンの利用をおすすめします。

拡張機能のインストール時に「このウェブサイトからアプリを追加できません」と表示される場合

公式のウェブストア（Chrome Web Store または Edge Add-ons）からインストールしていることを確認してください。ウェブストアにアクセスできない場合は、公式サイトで案内している手動インストール方法を利用してください。

Windows で Kimi ブラウザ拡張機能をインストールすると「Installation failed」エラーが出る場合

Kimi ブラウザ拡張機能は Windows オペレーティングシステムに対応しています。インストールコマンドは PowerShell で実行できます。

Powershell

インストール後に Kimi ブラウザ拡張機能で Chrome 互換性の警告が表示される場合、それは何を意味しますか？

Kimi ブラウザ拡張機能でページは正常に開けるものの、snapshot、evaluate、screenshot、click などの操作が失敗し続ける場合、よくある原因は 他のブラウザ拡張機能との競合 です。

特に、スクレイピングツール、ウェブサイト支援系の拡張機能、画面録画拡張機能、AI アシスタント拡張機能でよく発生します。

次の手順で切り分けることをおすすめします。

  1. ブラウザの拡張機能管理ページを開く
  2. 他の拡張機能を一時的に無効にする
  3. Kimi ブラウザ拡張機能だけを有効にする
  4. ブラウザを再起動して、もう一度試す
  5. Kimi ブラウザ拡張機能が正常に動作する場合は、他の拡張機能を1つずつ有効に戻し、競合している拡張機能を特定する

接続コマンドを実行しても何も起きない場合

インターネット接続を確認してください。問題が続く場合は、Kimi Claw Desktop を再起動してから、もう一度コマンドを実行してください。

複数のコンピューターで使えますか？

はい。ただし、各コンピューターで個別にインストールと設定を行う必要があります。

Kimi Claw Desktop が見つからない場合

Kimi Claw Desktop は、お使いのローカルコンピューター上にデプロイされた Kimi Claw です。Kimi Desktop を開き、左側のサイドバーで Kimi Claw を見つけて新しい Claw を作成し、「自分のコンピューターにデプロイ」を選択してください。

接続と利用

ローカル Agent がブラウザを操作できない場合、接続状態はどこで確認できますか？

  • ブラウザのサイドバーで「Settings」→「Local agent remote control」の「Connection」を確認します。「Not connected」と表示されている場合は、「Connect」をクリックして再試行してください。
  • Kimi Work では、「設定」→「自動操作」→「Browser use」で「サービスに接続」の状態を確認し、「接続」をクリックして再試行できます。

注意：サイドバーが開くだけでは、ローカル Agent の接続設定が完了しているとは限りません。

Kimi Work やほかのローカル Agent がブラウザを操作できない場合は、まずツールが返した元のエラーを確認します。よく見られるフィールドやメッセージの断片によって、確認すべき方向が異なります。

エラーのフィールドまたはメッセージ意味と確認箇所
error.code が extension_not_connectedローカルサービスはリクエストを受信していますが、拡張機能が未接続です。手順 1 のブラウザと拡張機能、手順 4 のアドレスを確認してください
ローカルサービスへの接続時に Connection refused または Failed to connectローカルサービスに到達できていません。手順 2・3 のインストールと起動、手順 4 のアドレスを確認してください
起動時に daemon did not come up と Port … is most likely held by another programサービスの起動に失敗しています。ポート使用中の可能性があるため、手順 5 と付随するログを確認してください

次の順に確認してください。

1. ブラウザが開いていて、拡張機能が有効になっていますか？

Kimi ブラウザ拡張機能をインストールした Chrome または Edge を開き、拡張機能の管理画面で有効になっているか確認します。その後、Kimi Work で「接続」、または拡張機能の設定で「Connect」をクリックします。

2. ブラウザ拡張機能だけをインストールし、ローカル Agent を未設定のままにしていませんか？

ブラウザ拡張機能と、ローカル Agent 側の接続コンポーネントの両方が必要です。Kimi Work では、プラグインマーケットから「Kimi Browser Extension」をインストールし、画面の案内に沿って接続してください。

ほかのローカル Agent を使う場合や、ローカルサービスが未設定の場合は、拡張機能の「Connect」をクリックし、ダイアログの設定手順を Agent に送ってください。OS に合わせて次の指示文をコピーすることもできます。

macOS または Linux

Text

Windows

Text

インストールとサービスの起動が成功したら、「Connection」を再確認してください。

3. インストールしたローカルサービスは動作していますか？

インストール済みでも、サービスが動作し続けているとは限りません。Kimi Work では、前述の設定画面で「接続」をクリックします。ほかのローカル Agent には、Kimi ブラウザ拡張機能のローカルサービスを確認し、停止中なら起動するよう依頼してください。その後、拡張機能で「Connect」をクリックします。起動に失敗する場合はポートの競合を確認してください。

4. 拡張機能とローカルサービスの接続先は一致していますか？

拡張機能の「Settings」→「Local agent remote control」→「Connection address」を確認します。既定値は ws://127.0.0.1:10086/ws です。サービスのポートを変更した場合は、拡張機能も同じポートに合わせてください。片方だけ変更すると接続できません。

5. ポートが使用中の可能性を示すエラーがありますか？

Port … is most likely held by another program が表示されたら、ローカル Agent に、記載されたポート、使用中のプログラム、付随するログの確認を依頼します。このメッセージだけでは原因は確定できません。競合が確認できたら、次のポート変更ガイドに進んでください。

解決しない場合は、拡張機能の「Settings」→「Feedback」から、Kimi Work またはローカル Agent のバージョン、ブラウザと拡張機能のバージョン、接続状態のスクリーンショット、エラー全文、試した手順を送ってください。

ポートが使用中の場合は？接続ポートを変更するには？

ローカル接続サービスの既定ポートは 10086 です。まず使用中のプログラムを確認し、終了できる場合は終了して再接続してください。動作を続ける必要がある場合は、以下の手順でポートを変更します。

Kimi Work 3.2.18 とほかのローカル Agent は、同じ手順でポートを変更できます。古い Work を使用している場合は、先に 3.2.18 以降に更新してください。Kimi ブラウザ拡張機能のローカルサービスは v2.0.22 以降が必要です。

ローカルサービスと拡張機能のポートを同時に変更できます。以下では 12086 を例にします。先に Agent に空きポートであることを確認してもらってください。再起動で現在の接続が切れるため、実行中のブラウザタスクが終了してから操作します。

1. ローカルサービスの設定を変更します。

以下のファイルを開き、なければ作成します。既存のほかのフィールドを保持し、addr だけを変更してください。設定エラーが出た場合は、JSON の構文と addr が下記のアドレス形式になっているか確認し、修正して再試行します。

  • macOS / Linux：~/.kimi-webbridge/config.json
  • Windows：%USERPROFILE%\.kimi-webbridge\config.json
Json

2. サービスを再起動して状態を確認します。

OS に合うコマンドを実行するか、ローカル Agent に実行を依頼してください。

running: true、port が 12086 であることを確認します。古いポートが表示される場合や起動に失敗した場合は、まずサービスのエラーを解消してください。Work は正常に動作しているサービスを再利用するため、設定の保存や Work の開き直しだけでは、そのサービスは新しいポートに自動移行しません。

3. 拡張機能の接続アドレスを変更します。

サイドバーの「Settings」→「Local agent remote control」→「Connection address」で ws://127.0.0.1:12086/ws を入力し、「Test」をクリックします。成功したら「Save」をクリックし、設定に戻って「Connection」が「Connected」になっていることを確認します。

4. ローカル Agent に新しいアドレスを伝えます。

Kimi Work では、上記の手順後に Work を開き直し、「設定」→「自動操作」→「Browser use」で「接続」をクリックします。ほかのローカル Agent には、サービスが 127.0.0.1:12086 に変わったことを伝え、status が返す実際のポートを使ってブラウザの操作を続けるよう依頼してください。extension_connected: true は拡張機能が接続済みであることを示します。false の場合は、ブラウザが開いていること、拡張機能が有効であること、アドレスが手順 3 と一致していることを確認してください。

既定値に戻すには、addr を 127.0.0.1:10086 に戻してサービスを再起動し、拡張機能の「Connection address」で「Reset to default」をクリックします。先に、ほかのプログラムが 10086 を使っていないことを確認してください。

Kimi ブラウザ拡張機能からログイン情報が漏れることはありますか？

いいえ。すべての実行処理はお使いのデバイス上でローカルに行われます。ログイン状態やウェブページの内容が端末の外へ送信されることはありません。エージェントがアクセスできるのは、あなたが許可した操作結果だけです。

操作が失敗するのはなぜですか？

ページ構造が複雑だったり、動的読み込みが行われていたりすると、操作に失敗することがあります。指示を簡潔にするか、実行前にまずエージェントにスクリーンショットを撮らせて、ページの状態を確認してください。

他のエージェントとの連携

対応している他のエージェントは？

Kimi ブラウザ拡張機能は、Claude Code、Codex、Cursor、Kimi Code、Hermes Claw など、すべてのローカルエージェントに対応しています。

エージェントによって設定方法は異なりますか？

設定コマンドはすべて共通です。1つの curl コマンドを実行するだけでインストールできます。詳細は各エージェントの Skill 設定を参照してください。

この記事は役に立ちましたか？