常见问题（FAQ）
产品版本
Kimi WebBridge 和 Kimi 浏览器扩展是什么关系？
Kimi WebBridge 更名为 Kimi 浏览器扩展，并新增了浏览器侧边栏入口、录制网页操作、拆解网页生成指令等功能。通过本地 Agent 调用扩展的方式保持不变，可继续使用；新增的侧边栏入口需登录 Kimi 账号后使用。
侧边栏日常使用
会话历史会和 kimi.com、Kimi 桌面版同步吗？
不会。侧边栏的会话历史仅保存在当前浏览器中，每个账号默认保留最近 10 条。需要长期保存时，可点击回答下方的「导出」，将内容保存为 Markdown（.md）文件。
安装与配置
支持哪些浏览器？
目前支持 Chrome 和 Edge 浏览器，建议使用最新版本以获得最佳体验。
安装扩展时提示「无法从该网站添加应用」？
请确保从官方应用商店（Chrome Web Store 或 Edge Add-ons）安装。如无法访问应用商店，可使用官网提供的手动安装方式。
在 Windows 中安装 Kimi 浏览器扩展，报错：安装失败
Kimi 浏览器扩展支持 Windows 操作系统，可以在 PowerShell 中运行安装命令：
已经完成安装步骤，但使用时提示和 Chrome 不兼容，这是怎么回事？
如果 Kimi 浏览器扩展能正常打开网页，但 snapshot、evaluate、screenshot、click 这类操作一直失败，更常见的原因是浏览器里的其他插件发生了冲突。
尤其是爬虫类、网站助手类、录屏类、AI 辅助类插件，更容易影响 Kimi 浏览器扩展的正常使用。
建议你这样排查：
- 打开浏览器扩展管理页
- 先临时关闭其他插件
- 只保留 Kimi 浏览器扩展
- 重启浏览器后再试一次
- 如果恢复正常，再把其他插件一个个打开，定位冲突插件
运行连接指令后没有反应？
请检查网络连接是否正常。如仍有问题，尝试重启 Kimi Claw Desktop 后再次运行指令。
可以在多台电脑上使用吗？
可以，每台电脑需要单独安装和配置 Kimi 浏览器扩展。
找不到 Kimi Claw Desktop？
Kimi Claw Desktop 是部署在你本地电脑上的 Kimi Claw。打开 Kimi 桌面版，在左侧边栏找到 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，点击「测试」，成功后点击「保存」。返回设置，确认「连接状态」为「已连接」。
4. 让本地 Agent 使用新地址。
使用 Kimi Work 时，完成上述步骤后重新打开 Work，并在「设置」→「自动操控」→「外部浏览器」中点击「连接」。使用其他本地 Agent 时，告诉它本地服务已改到 127.0.0.1:12086，按 status 返回的实际端口继续操作浏览器。状态中的 extension_connected: true 表示扩展已连接；若为 false，请检查浏览器是否打开、扩展是否启用，以及第 3 步的地址是否一致。
需要恢复默认时，将配置中的 addr 改回 127.0.0.1:10086 并重启服务，再在扩展「连接地址」页点击「恢复默认」。恢复前也需确认 10086 没有被其他程序占用。
Kimi 浏览器扩展会泄露我的登录信息吗？
不会。所有执行都在你本地完成，登录态和网页内容不会离开你的设备。Agent 只能获取你授权的操作结果。
为什么有时候操作会失败？
网页结构复杂或动态加载可能导致操作失败。可以尝试简化指令，或让 Agent 先截图确认页面状态后再执行操作。
与其他 Agent 配合
除了 Kimi，还支持哪些 Agent？
Kimi 浏览器扩展支持所有 Local Agent，包括 Claude Code、Codex、Cursor、Kimi Code、Hermes Claw 等。
不同 Agent 的配置方式一样吗？
配置指令相同，都是运行一条 curl 命令完成安装。具体可参考各 Agent 的 Skill 配置方式。
反馈与帮助
如果你在使用过程中遇到问题或有建议，欢迎提供反馈。
反馈时信息越完整，我们越能快速定位和解决问题。
反馈时请提供：
- 浏览器版本：例如 Chrome 124.0.6367.82
- Kimi 浏览器扩展版本：可在浏览器扩展管理页面查看
- 你使用的 AI Agent：例如 Kimi Desktop、Claude Code、Cursor 等
- 问题描述和截图：请尽量描述复现步骤
- 相关日志（如有）：可在插件界面或浏览器控制台获取
本文是否对你有帮助