Kimi WebBridge 現名 Kimi 瀏覽器擴充功能。如果側邊欄能開啟，但本機 Agent 說瀏覽器離線，就分別檢查擴充功能、連線服務和 Agent。先讀工具呼叫的原始錯誤，單靠狀態標記無法辨認哪一段中斷。
一位 r/kimi 使用者回報，擴充功能顯示使用中，Claw 卻提示 WebBridge 離線。遇到這個情況，可以分段檢查連線。 r/kimi
重點
Kimi 列出的環境是 macOS 或 Windows 上的 Chrome 與 Edge。請在要執行任務的瀏覽器設定檔中安裝擴充功能。
側邊欄與本機 Agent 控制各自設定。側邊欄顯示使用中之後，還要確認本機連線。
Connection refused先查本機服務位址。extension_not_connected先查擴充功能與服務之間的連線。讓 Agent 操作前，先核對頁面標題、完整 URL 與一段可見文字。
先確認 Agent 應使用哪個瀏覽器
Kimi Code 桌面版右側有內建瀏覽器，分頁歸屬目前的工作階段。任務需要使用日常瀏覽器中已授權的登入狀態時，才選擇擴充功能。Kimi 文件列出 Chrome 和 Edge。瀏覽器和 Agent 的相容性是兩項獨立條件。
| 方式 | 在哪裡執行 | 適合何時使用 |
|---|---|---|
| 內建瀏覽器 | Kimi Code 工作階段 | 開啟該工作階段的網頁 |
| 擴充功能側邊欄 | 選定的瀏覽器設定檔 | 直接在分頁中操作 |
| 本機 Agent 控制 | Agent、本機服務、擴充功能 | 從 Agent 任務使用已授權的瀏覽器設定檔 |
內建瀏覽器和擴充功能各有工作階段。可參考如何在 Kimi Code 內建瀏覽器與 WebBridge 之間選擇了解兩個入口，或閱讀瀏覽器多設定檔、工作區與分頁群組差異：如何徹底隔離工作與個人瀏覽？了解登入狀態為何不同。
逐段核對連線
本機 Agent 向迴路位址上的服務發送請求。擴充功能透過 WebSocket 連到同一個服務，並在自己的瀏覽器設定檔中操作。官方 FAQ 提供的擴充功能預設位址是 ws://127.0.0.1:10086/ws。Agent 的本機 HTTP 端點和擴充功能的 WebSocket 網址各有用途。如果 Agent 在容器或另一臺電腦執行，迴路位址指向該環境。
Local Agent ── HTTP ──► Loopback service
Kimi extension ── WebSocket ──► Loopback service
Kimi extension ──► Browser profile ──► Test page若 Agent 在瀏覽器所在電腦之外執行，可用Codex 雲端為甚麼打不開電腦上的 localhost？對照位址的差異。
安裝後逐一確認元件
從 Kimi 官方連結前往 Chrome 線上應用程式商店或 Edge 附加元件商店安裝。若使用官網安裝包，先解壓縮，接著在瀏覽器的擴充功能管理頁啟用開發人員模式，載入解壓縮的資料夾。
使用 Kimi Work 時，從外掛市集安裝瀏覽器擴充功能外掛，再到「設定 → 自動操控 → 外部瀏覽器」按下「連線」。使用 Kimi Code CLI 時，依外掛文件安裝用戶端外掛與瀏覽器擴充功能。
使用其他本機 Agent 時，依 Kimi 安裝指南中對應用戶端的步驟設定。確認本機服務正在執行後，從擴充功能的「設定 → 本機 Agent 遠端控制」發起連線並檢查狀態。
其他本機用戶端同樣要選對設定檔，例如OpenClaw 瀏覽器設定：獨立瀏覽器還是已有登入工作階段。也可用如何用 DeepSeek Harness 控制瀏覽器對照用戶端與瀏覽器分開設定的做法。
讀原始錯誤定位問題
Connection refused 或 Failed to connect 表示呼叫端未連到該位址上的監聽服務。核對執行環境、連接埠和服務狀態。服務傳回 extension_not_connected 時，檢查服務到擴充功能的連線、目標設定檔和兩端連接埠。啟動錯誤若顯示可能有衝突，先找出監聽程序，再決定是否調整。
| 看到的訊號 | 先檢查哪裡 |
|---|---|
| Connection refused | Agent 到本機服務 |
extension_not_connected | 服務到擴充功能 |
URL / WEBBRIDGE-CHECK | 瀏覽器設定檔和可見標記 |
本機服務無法啟動時，先看同一筆錯誤附帶的記錄，確認是哪個程式占用連接埠。Kimi 預設使用 10086。確認衝突後，可選擇閒置的本機連接埠，以新位址重新啟動服務，再到擴充功能測試並儲存對應的 WebSocket 位址。讓 Agent 連到新連接埠，並從服務狀態確認連接埠與擴充功能的連線。設定檔和重啟指令請依 Kimi 文件操作。
能開啟網頁卻一直無法擷取快照、截圖或點擊時，Kimi FAQ 建議檢查擴充功能是否衝突。可在只啟用 Kimi 擴充功能的獨立設定檔重做同一個無風險操作。若成功，再於該設定檔中逐一比對其他擴充功能。
以唯讀任務確認目標視窗
在目標設定檔開啟一張無敏感資訊的測試頁，請 Agent 回報標題、完整網址和可見標記。例如使用標題為 WEBBRIDGE-CHECK 的頁面，要求只回傳這三個欄位，且不要點擊、輸入或送出表單。如果標記不符，先停止並核對網址與設定檔。保存紀錄時移除私人內容和憑證。
已登入的管理頁同樣依賴瀏覽器設定檔。把管理頁當作測試頁前，可先參考Codex 能讀取我已經登入的後台嗎？。
連上後先核對一個已授權的分頁
一位 r/codex 使用者描述，安裝擴充功能和相容的技能之後，可以操作已開啟的分頁。這是單一使用案例。用戶端的支援和設定請查各自的文件。 r/codex
確認連線後再重試任務
錯誤指向本機服務時，先恢復該段連線。擴充功能連上後，檢查瀏覽器設定檔，再用唯讀請求核對頁面。頁面資訊一致後，再重試原本的任務。
常見問題
什麼時候只用側邊欄就夠了？
直接在瀏覽器介面使用助手時，選側邊欄。如果需要讓另一個本機 Agent 將瀏覽器操作納入任務，則使用本機 Agent 遠端控制。
我該用哪個瀏覽器設定檔？
Kimi Code 桌面版右側有內建瀏覽器，分頁歸屬目前的工作階段。任務需要使用日常瀏覽器中已授權的登入狀態時，才選擇擴充功能。Kimi 文件列出 Chrome 和 Edge。瀏覽器和 Agent 的相容性是兩項獨立條件。
extension_not_connected 是什麼意思？
本機服務已收到請求，但瀏覽器擴充功能尚未連上。請開啟目標瀏覽器設定檔並啟用擴充功能，再核對它的連線位址和目前服務位址是否相同。
為什麼 Agent 顯示 Connection refused？
呼叫端無法連到該位址上的監聽服務。請確認本機服務狀態、實際連接埠及 Agent 的執行環境。
如何確認 Agent 找到正確的分頁？
在目標設定檔開啟一張無敏感資訊的測試頁，請 Agent 回報標題、完整網址和可見標記。例如使用標題為 WEBBRIDGE-CHECK 的頁面，要求只回傳這三個欄位，且不要點擊、輸入或送出表單。如果標記不符，先停止並核對網址與設定檔。保存紀錄時移除私人內容和憑證。
Agent 和擴充功能能使用不同連接埠嗎？
兩端都要連到同一個本機服務連接埠。Agent 使用 HTTP，擴充功能使用 WebSocket。