常見問題
產品版本
Kimi WebBridge 和 Kimi 瀏覽器擴充功能是什麼關係？
Kimi WebBridge 更名為 Kimi 瀏覽器擴充功能，並新增了瀏覽器側邊欄入口、錄製網頁操作、拆解網頁生成指令等功能。透過本機 Agent 呼叫擴充功能的方式保持不變，可繼續使用；新增的側邊欄入口需登入 Kimi 帳號後使用。
側邊欄日常使用
歷史紀錄會和 kimi.com、Kimi 桌面版同步嗎？
不會。側邊欄的歷史紀錄僅儲存在目前的瀏覽器中，每個帳號預設保留最近 10 筆會話。需要長期保存時，可點選回答下方的「导出」，將內容儲存為 Markdown（.md）檔案。
安裝與設定
支援哪些瀏覽器？
目前支援 Chrome 與 Edge。建議使用最新版本以獲得最佳體驗。
安裝擴充功能時看到「無法從這個網站新增應用程式」？
請確認你是從官方線上應用程式商店安裝（Chrome Web Store 或 Edge Add-ons）。若無法存取線上應用程式商店，請使用官方網站提供的手動安裝方式。
在 Windows 安裝 Kimi 瀏覽器擴充功能時出現錯誤：Installation failed
Kimi 瀏覽器擴充功能支援 Windows 作業系統，安裝指令可在 PowerShell 中執行：
Kimi 瀏覽器擴充功能安裝後顯示 Chrome 相容性警告，這代表什麼？
如果 Kimi 瀏覽器擴充功能可以正常開啟頁面，但 snapshot、evaluate、screenshot 或 click 等操作持續失敗，較常見的原因是與其他瀏覽器擴充功能衝突。
這種情況尤其常見於網頁擷取工具、網站輔助擴充功能、螢幕錄影擴充功能，以及 AI 助理擴充功能。
建議依照以下步驟排除：
- 開啟瀏覽器的擴充功能管理頁面
- 暫時停用其他擴充功能
- 只保留 Kimi 瀏覽器擴充功能啟用
- 重新啟動瀏覽器後再試一次
- 如果 Kimi 瀏覽器擴充功能可以正常運作，請逐一重新啟用其他擴充功能，以找出造成衝突的擴充功能
執行連線指令後沒有任何反應？
請檢查你的網路連線。若問題仍然存在，請嘗試重新啟動 Kimi Claw Desktop，然後再次執行指令。
可以在多台電腦上使用嗎？
可以，但每台電腦都需要分別安裝與設定。
找不到 Kimi Claw Desktop？
Kimi Claw Desktop 是部署在你本機電腦上的 Kimi Claw。開啟 Kimi Desktop，在左側邊欄找到 Kimi Claw，建立新的 Claw，並選擇「部署在我的電腦上」。
連線與使用
本機 Agent 無法呼叫瀏覽器，如何查看連線狀態？
- 瀏覽器側邊欄「设置」→「本地 Agent 远程控制」中查看「连接状态」：若顯示「未连接」，點選「去连接」重試。
- Kimi Work 使用者也可在 Work 的「設定」→「自動化」→「操作瀏覽器」中查看「連線服務」狀態，並點選「連線」重試。
注意：能開啟側邊欄，不代表本機 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 點選「連線」，或在擴充功能設定中點選「去连接」。
2. 是否只安裝了瀏覽器擴充功能，尚未設定本機 Agent？
瀏覽器擴充功能與本機 Agent 的連線元件都需要安裝。使用 Kimi Work 時，請在 Work 的外掛市集中安裝「Kimi 浏览器扩展」，並完成頁面上的安裝與連線引導。
使用其他本機 Agent，或尚未完成本機服務設定時，可點選擴充功能設定中的「去连接」，將對話方塊內的安裝設定指令傳給本機 Agent。也可依作業系統複製下列指令：
macOS 或 Linux
Windows
請確認安裝與服務啟動皆成功，再回到「连接状态」檢查。
3. 安裝過的本機服務是否正在執行？
完成安裝不代表服務會一直執行。先在 Kimi Work 的上述設定頁點選「連線」。使用其他本機 Agent 時，請它檢查本機 Kimi 瀏覽器擴充功能服務，未執行則啟動。接著在擴充功能設定中點選「去连接」。若啟動失敗，請繼續檢查連接埠占用訊息。
4. 擴充功能的連線位址是否與本機服務一致？
在擴充功能的「设置」→「本地 Agent 远程控制」→「连接地址」中檢查。預設位址為 ws://127.0.0.1:10086/ws；若修改過服務連接埠，擴充功能也必須使用相同連接埠。只修改其中一側會導致無法連線。
5. 錯誤是否提到連接埠可能遭占用？
若啟動錯誤包含 Port … is most likely held by another program，請本機 Agent 檢查實際連接埠、占用程式及附帶記錄。這只表示「可能遭占用」，不能單憑此句判定原因。確認後，請依下一題的連接埠指引處理。
若仍無法連線，請透過擴充功能「设置」→「反馈问题」提供 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
2. 重新啟動本機服務並查看狀態。
依作業系統執行以下命令，或請本機 Agent 執行：
確認傳回 running: true，且 port 為 12086。若仍是舊連接埠或啟動失敗，請先處理服務錯誤。Work 會重用正常執行的服務；只儲存設定或重新開啟 Work，不會讓現有服務自動遷移至新連接埠。
3. 修改擴充功能連線位址。
開啟側邊欄「设置」→「本地 Agent 远程控制」→「连接地址」，填入 ws://127.0.0.1:12086/ws，點選「测试」，成功後點選「保存」。回到設定確認「连接状态」為「已连接」。英文按鈕為 “Test” 和 “Save”。
4. 讓本機 Agent 使用新位址。
使用 Kimi Work 時，完成上述步驟後重新開啟 Work，並在「設定」→「自動化」→「操作瀏覽器」點選「連線」。使用其他本機 Agent 時，告知本機服務已改為 127.0.0.1:12086，依 status 傳回的實際連接埠繼續操作瀏覽器。extension_connected: true 表示擴充功能已連線；若為 false，請檢查瀏覽器是否開啟、擴充功能是否啟用，以及位址是否與第 3 步一致。
若要還原預設值，將 addr 改回 127.0.0.1:10086 並重新啟動服務，再於擴充功能「连接地址」頁點選「恢复默认」（“Reset to default”）。還原前也須確認 10086 未被其他程式占用。
Kimi 瀏覽器擴充功能會洩漏我的登入資訊嗎？
不會。所有執行都在你的裝置本機完成——登入狀態與網頁內容都不會離開你的電腦。Agent 只能存取你授權的操作結果。
為什麼操作會失敗？
複雜的頁面結構或動態載入可能導致操作失敗。你可以嘗試簡化指令，或先請 Agent 截圖確認頁面狀態，再執行操作。
搭配其他 Agent 使用
支援哪些其他 Agent？
Kimi 瀏覽器擴充功能支援所有本機 Agent，包括 Claude Code、Codex、Cursor、Kimi Code、Hermes Claw 等。
不同 Agent 的設定方式一樣嗎？
所有 Agent 的安裝指令都相同——只要執行一個 curl 指令即可安裝。詳細資訊請參考各 Agent 的 Skill 設定。
本文是否對你有幫助