Kimi WebBridge agora se chama Kimi Browser Extension. Se a barra lateral abre, mas o agente local diz que o navegador está offline, verifique a extensão, o serviço e o agente separadamente. Comece pela mensagem original da ferramenta. Um indicador de status não identifica sozinho o ponto da falha.
Um usuário do r/kimi relatou que o Claw dizia que o WebBridge estava offline mesmo com a extensão aparecendo como ativa. Esse sintoma pede uma verificação de cada parte da conexão. r/kimi
Pontos principais
A Kimi documenta Chrome e Edge no macOS ou Windows. Instale a extensão no perfil que vai executar a tarefa.
O painel lateral e o controle por um agente local são configurados separadamente. Um painel ativo confirma apenas parte da configuração.
Connection refusedaponta para o serviço local.extension_not_connectedaponta para a conexão entre esse serviço e a extensão.Confira o título, a URL completa e um texto visível antes de autorizar ações.
Escolha o navegador que o agente deve usar
O Kimi Code Desktop tem um navegador integrado no painel direito. Suas abas pertencem à sessão atual. Use a extensão se a tarefa autorizada precisar do perfil onde o site já está aberto. A documentação do Kimi lista Chrome e Edge. Verifique separadamente a compatibilidade do agente e do navegador.
Navegador integrado Sessões existentes
| Modo | Onde funciona | Quando usar |
|---|---|---|
| Navegador integrado | Sessão do Kimi Code | Abrir uma página para essa sessão |
| Barra lateral | Perfil escolhido | Trabalhar na aba |
| Agente local | Agente, serviço local e extensão | Usar um perfil autorizado em uma tarefa do agente |
O navegador integrado e a extensão usam sessões separadas. Consulte Quando usar o navegador integrado do Kimi Code ou o WebBridge para escolher a opção ou Perfis vs Espaços de Trabalho vs Grupos de Guias: Como Separar Trabalho e Vida Pessoal para entender por que os logins podem ser diferentes.
Acompanhe a conexão até a página
O agente local chama o serviço no endereço de loopback. A extensão se conecta ao mesmo serviço por WebSocket e opera em seu próprio perfil. O endereço padrão informado pelo Kimi é ws://127.0.0.1:10086/ws. O endpoint HTTP do agente e a URL WebSocket da extensão têm funções distintas. Se o agente roda em um contêiner ou em outro computador, seu endereço local aponta para esse ambiente.
Local Agent ── HTTP ──► Loopback service
Kimi extension ── WebSocket ──► Loopback service
Kimi extension ──► Browser profile ──► Test pageSe o agente roda fora do computador do navegador, Por que o Codex Cloud não abre o localhost do seu computador explica o que muda no endereço.
Instale e confira cada componente
Instale a extensão pela Chrome Web Store ou pelo Edge Add-ons usando os links da Kimi. Para a instalação manual, descompacte o pacote oficial, abra a página de extensões, ative o modo desenvolvedor e carregue a pasta descompactada.
No Kimi Work, instale o plugin pelo catálogo e clique em Conectar em Configurações > Controle automático > Navegador externo. No Kimi Code CLI, siga o guia e instale o plugin do cliente e a extensão.
Para outro agente local, siga as instruções da Kimi para o seu cliente e confirme que o serviço está em execução. Nas configurações da extensão, abra o controle remoto por agente local, conecte e confira o status.
Instalação oficial Kimi Code CLI
Para escolher um perfil em outro cliente local, consulte Como configurar o navegador do OpenClaw e escolher o perfil. A configuração separada do cliente e do navegador também aparece em Como controlar um navegador com o DeepSeek Harness.
Use o erro original para localizar a falha
Connection refused ou Failed to connect indica que o cliente não chegou a um serviço que escutasse naquele endereço. Verifique o ambiente, a porta e o serviço. Se o serviço retornar extension_not_connected, confira a conexão com a extensão, o perfil e a porta nas duas pontas. Se a inicialização avisar sobre possível conflito de porta, identifique o processo antes de alterar a configuração.
| Sinal observado | Primeira verificação |
|---|---|
| Connection refused | Do agente ao serviço local |
extension_not_connected | Do serviço à extensão |
URL / WEBBRIDGE-CHECK | Perfil e marcador visível |
Se o serviço não iniciar, leia o registro associado ao erro e descubra qual programa está usando a porta. A Kimi usa a porta 10086 por padrão. Se houver conflito, escolha uma porta local livre, reinicie o serviço com o novo endereço e teste e salve a URL WebSocket correspondente na extensão. Reconecte o agente e confira no status do serviço a porta ativa e a conexão da extensão. Consulte a documentação da Kimi para editar o arquivo de configuração e reiniciar o serviço.
Se a página abre, mas o snapshot, a captura de tela ou o clique falha repetidamente, a Kimi sugere investigar um conflito entre extensões. Repita a mesma ação sem risco em um perfil dedicado com apenas a extensão da Kimi ativa. Se funcionar, compare as extensões uma de cada vez nesse perfil.
Confirme a janela com um teste somente de leitura
Abra uma página sem dados sensíveis no perfil desejado. Peça ao agente o título, a URL exata e um marcador visível como WEBBRIDGE-CHECK. Não inclua cliques, digitação ou envio de formulários. Se o marcador estiver errado, pare e confira a URL e o perfil. Registre o resultado sem dados privados ou credenciais.
Um painel já autenticado também depende do perfil. Antes de usá-lo como página de teste, consulte O Codex pode ler um painel em que você já entrou?.
Depois de conectar, confira uma aba autorizada
Um usuário do r/codex contou que conseguiu operar abas já abertas após instalar a extensão e uma skill compatível. É um exemplo de uso. Consulte a documentação do seu cliente para confirmar o suporte e a configuração. r/codex
Confira a conexão antes de repetir a tarefa
Se o erro original aponta para o serviço, restabeleça essa conexão primeiro. Quando a extensão estiver conectada, confira o perfil e verifique a página com uma solicitação somente de leitura. Repita a tarefa quando os dados da página corresponderem ao esperado.
Perguntas frequentes
Quando a barra lateral é suficiente?
Use-a para trabalhar pela interface do navegador. Use o controle remoto do agente local quando a ação no navegador precisar fazer parte de uma tarefa de outro agente.
Qual perfil de navegador devo usar?
O Kimi Code Desktop tem um navegador integrado no painel direito. Suas abas pertencem à sessão atual. Use a extensão se a tarefa autorizada precisar do perfil onde o site já está aberto. A documentação do Kimi lista Chrome e Edge. Verifique separadamente a compatibilidade do agente e do navegador.
O que significa extension_not_connected?
O serviço local recebeu a solicitação, mas a extensão ainda não se conectou a ele. Abra o perfil pretendido, ative a extensão e compare seu endereço de conexão com o do serviço em execução.
Por que o agente mostra Connection refused?
O cliente não conseguiu alcançar um serviço escutando naquele endereço. Confira o status do serviço, a porta ativa e o ambiente em que o agente roda.
Como confirmo que o agente encontrou a aba certa?
Abra uma página sem dados sensíveis no perfil desejado. Peça ao agente o título, a URL exata e um marcador visível como WEBBRIDGE-CHECK. Não inclua cliques, digitação ou envio de formulários. Se o marcador estiver errado, pare e confira a URL e o perfil. Registre o resultado sem dados privados ou credenciais.
O agente e a extensão podem usar portas diferentes?
Os dois se conectam à mesma porta do serviço local. O agente usa HTTP e a extensão usa WebSocket.