Частые вопросы
Версия продукта
Как связаны Kimi WebBridge и Расширение браузера Kimi?
Kimi WebBridge был переименован в Расширение браузера Kimi и получил новые возможности: вход через боковую панель браузера, запись действий на веб-страницах и разбор веб-страниц с созданием инструкций. Способ вызова расширения локальными агентами остался прежним, и им можно продолжать пользоваться; для нового входа через боковую панель требуется войти с учётной записью Kimi.
Работа с боковой панелью
Синхронизируется ли история чатов с kimi.com и настольным приложением Kimi?
Нет. История чатов боковой панели хранится только в текущем браузере; по умолчанию для каждого аккаунта сохраняются 10 последних чатов. Для длительного хранения нажмите «Export» под ответом, чтобы сохранить содержимое в файл Markdown (.md).
Установка и настройка
Какие браузеры поддерживаются?
Сейчас поддерживаются Chrome и Edge. Для наилучшей работы рекомендуем использовать последнюю версию.
При установке расширения появляется сообщение «Cannot add apps from this website»?
Убедитесь, что устанавливаете расширение из официального магазина (Chrome Web Store или Edge Add-ons). Если магазин недоступен, воспользуйтесь способом ручной установки, описанным на официальном сайте.
При установке Расширения браузера Kimi в Windows возникает ошибка: 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 и выберите «Deploy on my computer».
Подключение и использование
Как проверить подключение? Что делать, если локальный 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. Браузер открыт, а расширение включено?
Откройте Chrome или Edge, в котором установлено Расширение браузера Kimi, и убедитесь на странице управления расширениями, что оно включено. Затем нажмите «Подключить» в Kimi Work или «Connect» в настройках расширения.
2. Установлено только расширение, а локальный Agent ещё не настроен?
Нужны и расширение браузера, и компоненты подключения локального Agent. В Kimi Work установите плагин Kimi Browser Extension из каталога плагинов и выполните инструкции по установке и подключению.
Если вы используете другой локальный Agent или ещё не настроили службу, нажмите «Connect» в расширении и отправьте Agent инструкции из диалогового окна. Можно также скопировать запрос для вашей операционной системы:
macOS или Linux
Windows
Убедитесь, что установка и запуск службы прошли успешно, затем снова проверьте «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 и другие локальные Agents могут использовать одинаковую процедуру смены порта. Если у вас старая версия 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. Измените адрес подключения расширения.
В боковой панели откройте «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, перезапустите службу и нажмите «Reset to default» на странице «Connection address» расширения. Сначала убедитесь, что другая программа не занимает 10086.
Не приведет ли Расширение браузера Kimi к утечке моих данных для входа?
Нет. Все выполняется локально на вашем устройстве — состояния входа и содержимое веб-страниц не покидают ваш компьютер. Агент получает доступ только к тем результатам операций, которые вы разрешаете.
Почему операции завершаются с ошибкой?
Сложная структура страницы или динамическая загрузка могут приводить к сбоям. Попробуйте упростить инструкции или попросите агента сначала сделать снимок экрана, чтобы перед выполнением подтвердить состояние страницы.
Работа с другими агентами
Какие другие агенты поддерживаются?
Расширение браузера Kimi поддерживает все локальные агенты, включая Claude Code, Codex, Cursor, Kimi Code, Hermes Claw и другие.
Одинакова ли настройка для разных агентов?
Команда настройки одна и та же для всех — достаточно выполнить одну команду curl для установки. Подробности смотрите в конфигурации Skill соответствующего агента.
Была ли эта статья полезной?