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 报告标题、完整 URL 和一个可见标记。比如用标题为 WEBBRIDGE-CHECK 的页面，要求只返回上述字段，不点击、不输入、不提交。标记不符时先暂停，核对实际 URL 和配置后再试。保存排查回执时去掉私人网页内容和凭据。
已登录的后台同样依赖浏览器配置。将后台用作测试前，可以先参考Codex 能读取我已经登录的后台吗？。
连接后先核对一个授权标签页
一位 r/codex 用户描述了安装扩展和配套技能后操作已打开标签页的过程。这是一个使用案例。具体客户端的支持和配置以各自文档为准。 r/codex
确认连接后再重试任务
原始报错指向本地服务时，先恢复这一段连接。扩展连上后再确认浏览器配置，用只读请求核对页面。页面信息一致后，再重试原任务。
常见问题
什么时候只用侧边栏就够了？
直接在浏览器界面里使用助手，可以选侧边栏。需要由另一个本地 Agent 把浏览器操作编入任务时，再使用本地 Agent 远程控制。
我应该用哪个浏览器配置？
Kimi Code 桌面版右侧有内置浏览器，标签页归属于当前会话。任务需要使用日常浏览器里的已授权登录态时，才选择浏览器扩展。Kimi 的扩展文档列出 Chrome 和 Edge。浏览器支持和 Agent 支持是两项独立条件。
extension_not_connected 是什么意思？
本地服务已收到请求，但扩展尚未连到服务。打开目标浏览器配置，启用扩展，再核对它的连接地址与当前服务地址是否一致。
为什么 Agent 会提示 Connection refused？
调用方无法在该地址连到监听服务。先查本地服务状态和实际端口，再确认 Agent 运行在哪个环境。
怎样确认 Agent 打开了正确的标签页？
在目标配置打开一张无敏感信息的测试页，让 Agent 报告标题、完整 URL 和一个可见标记。比如用标题为 WEBBRIDGE-CHECK 的页面，要求只返回上述字段，不点击、不输入、不提交。标记不符时先暂停，核对实际 URL 和配置后再试。保存排查回执时去掉私人网页内容和凭据。
Agent 和扩展能使用不同端口吗？
两端都要连接同一个本地服务端口。Agent 用 HTTP，扩展用 WebSocket。