Perguntas frequentes
Versão do produto
Qual é a relação entre o Kimi WebBridge e a Extensão de navegador Kimi?
O Kimi WebBridge foi renomeado para Extensão de navegador Kimi e ganhou novos recursos, incluindo a entrada pela barra lateral do navegador, a gravação de operações web e a decomposição de páginas da web em instruções. A forma como os Local Agents chamam a extensão permanece inalterada e pode continuar sendo usada; a nova entrada pela barra lateral exige login com sua conta Kimi.
Usar a barra lateral
O histórico de conversas é sincronizado com o kimi.com e o Kimi Desktop?
Não. O histórico de conversas da barra lateral fica salvo apenas no navegador atual e, por padrão, cada conta mantém as 10 conversas mais recentes. Para guardar as conversas por mais tempo, clique em “Export” abaixo da resposta para salvar o conteúdo como arquivo Markdown (.md).
Instalação e configuração
Quais navegadores são compatíveis?
Atualmente, são compatíveis o Chrome e o Edge. Recomendamos usar a versão mais recente para a melhor experiência.
Aparece “Não é possível adicionar apps deste site” ao instalar a extensão?
Certifique-se de instalar a partir da loja oficial (Chrome Web Store ou Edge Add-ons). Se você não conseguir acessar a loja, use o método de instalação manual disponível no site oficial.
No Windows, ao instalar a Extensão de navegador Kimi, ocorre o erro: Falha na instalação
A Extensão de navegador Kimi é compatível com o sistema operacional Windows, e o comando de instalação pode ser executado no PowerShell:
A Extensão de navegador Kimi exibe um aviso de compatibilidade com o Chrome após a instalação. O que isso significa?
Se a Extensão de navegador Kimi consegue abrir páginas normalmente, mas ações como snapshot, evaluate, screenshot ou click continuam falhando, a causa mais comum é um conflito com outras extensões do navegador.
Isso é especialmente comum com ferramentas de scraping, extensões auxiliares de sites, extensões de gravação de tela e extensões de assistentes de IA.
Recomendamos os seguintes passos para investigar:
- Abra a página de gerenciamento de extensões do seu navegador
- Desative temporariamente as outras extensões
- Mantenha apenas a Extensão de navegador Kimi ativada
- Reinicie o navegador e tente novamente
- Se a Extensão de navegador Kimi funcionar normalmente, reative as outras extensões uma a uma para identificar a extensão em conflito
Nada acontece depois de executar o comando de conexão?
Verifique sua conexão com a internet. Se o problema persistir, reinicie o Kimi Claw Desktop e execute o comando novamente.
Posso usar em vários computadores?
Sim, mas cada computador precisa ser instalado e configurado separadamente.
Não consigo encontrar o Kimi Claw Desktop?
O Kimi Claw Desktop é um Kimi Claw implantado no seu computador local. Abra o Kimi Desktop, encontre o Kimi Claw na barra lateral esquerda, crie um novo Claw e selecione “Implantar no meu computador”.
Conexão e uso
Como verifico a conexão? O que fazer se meu Agent local não consegue usar o navegador?
- Na barra lateral do navegador, abra “Settings” → “Local agent remote control” e confira “Connection”: se aparecer “Not connected”, clique em “Connect” para tentar novamente.
- Usuários do Kimi Work também podem conferir o status de “Conectar ao serviço” em “Configurações” → “Automação” → “Browser use” no Work e clicar em “Conectar” para tentar novamente.
Observação: conseguir abrir a barra lateral não significa que a conexão do Agent local esteja configurada.
Se o Kimi Work ou outro Agent local não conseguir usar o navegador, confira primeiro o erro original retornado pela ferramenta:
| Campo ou mensagem de erro | Significado e verificação |
|---|---|
error.code é extension_not_connected | O serviço local recebeu a solicitação, mas a extensão não está conectada. Confira navegador e extensão na etapa 1 e o endereço na etapa 4 |
Connection refused ou Failed to connect ao acessar o serviço local | A chamada não alcançou o serviço local. Confira instalação e inicialização nas etapas 2 e 3, depois o endereço na etapa 4 |
Na inicialização, aparecem daemon did not come up e Port … is most likely held by another program | O serviço não iniciou, possivelmente porque a porta está ocupada. Verifique a etapa 5 e os logs anexos |
Faça as verificações nesta ordem:
1. O navegador está aberto e a extensão está ativada?
Abra o Chrome ou Edge com a Extensão de navegador Kimi instalada e confira se ela está ativada na página de extensões. Depois clique em “Conectar” no Kimi Work ou em “Connect” nas configurações da extensão.
2. Você instalou apenas a extensão, sem configurar o Agent local?
É necessário instalar a extensão e os componentes de conexão do Agent local. No Kimi Work, instale o plugin Kimi Browser Extension pelo marketplace de plugins e siga as instruções de instalação e conexão.
Se usa outro Agent local ou ainda não configurou o serviço, clique em “Connect” na extensão e envie ao Agent as instruções da janela. Você também pode copiar a solicitação correspondente ao seu sistema:
macOS ou Linux
Windows
Confirme que a instalação e a inicialização deram certo e confira “Connection” novamente.
3. O serviço local instalado está em execução?
Instalar o serviço não garante que ele continue em execução. No Kimi Work, clique primeiro em “Conectar” nas configurações indicadas. Com outro Agent local, peça que verifique o serviço local da Extensão de navegador Kimi e o inicie se necessário. Depois clique em “Connect” na extensão. Se a inicialização falhar, verifique se há conflito de porta.
4. O endereço da extensão corresponde ao do serviço local?
Confira “Settings” → “Local agent remote control” → “Connection address”. O padrão é ws://127.0.0.1:10086/ws. Se alterou a porta do serviço, a extensão deve usar a mesma. Alterar apenas um dos lados impede a conexão.
5. O erro menciona uma possível porta ocupada?
Se aparecer Port … is most likely held by another program, peça ao Agent local que confira a porta indicada, o programa que a utiliza e os logs anexos. A mensagem indica uma possibilidade, sem comprovar a causa. Confirmado o conflito, siga a orientação abaixo.
Se ainda não conseguir conectar, use “Settings” → “Feedback” na extensão. Informe as versões do Kimi Work ou do Agent local, do navegador e da extensão, uma captura do estado da conexão, o erro completo e as etapas já tentadas.
O que fazer se a porta está ocupada? Como altero a porta de conexão?
O serviço de conexão local usa a porta 10086 por padrão. Identifique primeiro o programa que a ocupa. Se puder fechá-lo, feche e tente conectar novamente. Se ele precisar continuar em execução, siga os passos abaixo para trocar a porta.
O Kimi Work 3.2.18 e outros Agents locais podem usar o mesmo procedimento para trocar a porta. Se você usa uma versão antiga do Work, atualize primeiro para a 3.2.18 ou posterior. O serviço local da Extensão de navegador Kimi deve ser v2.0.22 ou posterior.
Você pode alterar a porta do serviço e da extensão em conjunto. O exemplo usa 12086; peça primeiro ao Agent local que confirme se está livre. Aguarde o fim das tarefas do navegador, pois reiniciar o serviço interrompe a conexão atual.
1. Edite a configuração do serviço local.
Abra o arquivo abaixo ou crie-o se não existir. Preserve os outros campos e altere apenas addr. Se aparecer um erro de configuração, confira a sintaxe JSON e se addr segue o formato de endereço abaixo, corrija e tente novamente:
- macOS / Linux:
~/.kimi-webbridge/config.json - Windows:
%USERPROFILE%\.kimi-webbridge\config.json
2. Reinicie o serviço local e confira o estado.
Execute os comandos do seu sistema operacional ou peça ao Agent local que os execute:
Confirme running: true e que port seja 12086. Se a porta antiga continuar aparecendo ou o serviço não iniciar, resolva primeiro o erro do serviço. O Work reutiliza um serviço ativo em bom estado; salvar a configuração ou reabrir o Work não o transfere automaticamente para a nova porta.
3. Altere o endereço de conexão da extensão.
Na barra lateral, abra “Settings” → “Local agent remote control” → “Connection address”, digite ws://127.0.0.1:12086/ws e clique em “Test”. Se o teste funcionar, clique em “Save”. Volte às configurações e confirme que “Connection” mostra “Connected”.
4. Oriente seu Agent local a usar o novo endereço.
No Kimi Work, reabra o Work após os passos acima e clique em “Conectar” em “Configurações” → “Automação” → “Browser use”. Para outro Agent local, informe que o serviço agora usa 127.0.0.1:12086 e que deve continuar usando a porta real retornada por status. extension_connected: true indica que a extensão está conectada. Se for false, confira se o navegador está aberto, a extensão está ativa e o endereço corresponde ao passo 3.
Para restaurar o padrão, mude addr de volta para 127.0.0.1:10086, reinicie o serviço e clique em “Reset to default” na página “Connection address”. Antes, confirme que nenhum outro programa ocupa 10086.
A Extensão de navegador Kimi vai vazar minhas informações de login?
Não. Toda a execução acontece localmente no seu dispositivo — estados de login e conteúdo das páginas nunca saem da sua máquina. O Agent só pode acessar os resultados das operações que você autorizar.
Por que as operações falham?
Estruturas de página complexas ou carregamento dinâmico podem fazer com que as operações falhem. Tente simplificar suas instruções ou peça ao Agent para tirar uma captura de tela primeiro, a fim de confirmar o estado da página antes de executar.
Trabalhando com outros agentes
Quais outros Agents são compatíveis?
A Extensão de navegador Kimi é compatível com todos os Local Agents, incluindo Claude Code, Codex, Cursor, Kimi Code, Hermes Claw e muitos outros.
A configuração é a mesma para diferentes Agents?
O comando de configuração é o mesmo para todos — basta executar um único comando curl para instalar. Consulte a configuração de Skill de cada Agent para mais detalhes.
Este artigo foi útil?