FAQ
Versione del prodotto
Qual è il rapporto tra Kimi WebBridge e l'Estensione del browser Kimi?
Kimi WebBridge è stato rinominato Estensione del browser Kimi e ha introdotto nuove funzionalità, tra cui la barra laterale del browser, la registrazione delle azioni web e la scomposizione delle pagine web in istruzioni. La modalità con cui i Local Agent chiamano l'estensione resta invariata e può continuare a essere utilizzata; la nuova barra laterale richiede invece l'accesso con il tuo account Kimi.
Usare la barra laterale
La cronologia delle conversazioni si sincronizza con kimi.com e Kimi Desktop?
No. La cronologia delle conversazioni della barra laterale è salvata solo nel browser attuale e ogni account conserva per impostazione predefinita le 10 conversazioni più recenti. Per conservarle a lungo, fai clic su “Export” sotto una risposta per salvare i contenuti come file Markdown (.md).
Installazione e configurazione
Quali browser sono supportati?
Attualmente sono supportati Chrome ed Edge. Per la migliore esperienza ti consigliamo di utilizzare la versione più recente.
Compare il messaggio “Cannot add apps from this website” durante l'installazione dell'estensione?
Assicurati di installare dallo store ufficiale (Chrome Web Store o Edge Add-ons). Se non riesci ad accedere allo store, utilizza il metodo di installazione manuale indicato sul sito ufficiale.
Su Windows, installando l'Estensione del browser Kimi, errore: Installazione non riuscita
L'Estensione del browser Kimi supporta il sistema operativo Windows e il comando di installazione può essere eseguito in PowerShell:
Dopo l'installazione l'Estensione del browser Kimi mostra un avviso di compatibilità con Chrome. Cosa significa?
Se l'Estensione del browser Kimi riesce ad aprire le pagine normalmente, ma azioni come snapshot, evaluate, screenshot o click continuano a fallire, la causa più frequente è un conflitto con altre estensioni del browser.
Questo è particolarmente comune con strumenti di scraping, estensioni di assistenza ai siti web, estensioni di registrazione dello schermo ed estensioni di assistenti IA.
Ti consigliamo i seguenti passaggi per risolvere il problema:
- Apri la pagina di gestione delle estensioni del tuo browser
- Disattiva temporaneamente le altre estensioni
- Mantieni attiva solo l'Estensione del browser Kimi
- Riavvia il browser e riprova
- Se l'Estensione del browser Kimi funziona correttamente, riattiva le altre estensioni una alla volta per individuare quella in conflitto
Non succede nulla dopo aver eseguito il comando di connessione?
Verifica la connessione a Internet. Se il problema persiste, prova a riavviare Kimi Claw Desktop ed esegui di nuovo il comando.
Posso usarlo su più computer?
Sì, ma ogni computer deve essere installato e configurato separatamente.
Non riesco a trovare Kimi Claw Desktop?
Kimi Claw Desktop è un Kimi Claw distribuito sul tuo computer locale. Apri Kimi Desktop, trova Kimi Claw nella barra laterale sinistra, crea un nuovo Claw e seleziona “Distribuisci sul mio computer”.
Connessione e utilizzo
L'Agent locale non riesce a usare il browser: come verifico lo stato della connessione?
- Nella barra laterale, apri “Settings” → “Local agent remote control” e controlla “Connection”: se mostra “Not connected”, fai clic su “Connect” per riprovare.
- In Kimi Work puoi anche controllare lo stato di “Connetti servizio” in “Impostazioni” → “Automazione” → “Browser use” e fare clic su “Connetti” per riprovare.
Nota: riuscire ad aprire la barra laterale non significa che la connessione dell'Agent locale sia configurata.
Se Kimi Work o un altro Agent locale non riesce a usare il browser, controlla prima l'errore originale restituito dallo strumento:
| Campo o messaggio di errore | Significato e controlli |
|---|---|
error.code è extension_not_connected | Il servizio locale ha ricevuto la richiesta, ma l'estensione non è collegata. Controlla browser ed estensione al punto 1 e l'indirizzo al punto 4 |
Connection refused o Failed to connect accedendo al servizio locale | Il servizio locale non è stato raggiunto. Controlla installazione e avvio ai punti 2 e 3, poi l'indirizzo al punto 4 |
All'avvio compaiono daemon did not come up e Port … is most likely held by another program | Il servizio non si è avviato, forse perché la porta è occupata. Verifica al punto 5 e consulta i log allegati |
Esegui questi controlli nell'ordine indicato:
1. Il browser è aperto e l'estensione è attiva?
Apri Chrome o Edge con l'Estensione del browser Kimi installata e verifica che sia attiva nella pagina delle estensioni. Quindi fai clic su “Connetti” in Kimi Work o su “Connect” nelle impostazioni dell'estensione.
2. Hai installato solo l'estensione, senza configurare l'Agent locale?
Servono sia l'estensione sia i componenti di connessione dell'Agent locale. In Kimi Work, installa il plugin Kimi Browser Extension dal marketplace e segui le istruzioni di installazione e connessione.
Se usi un altro Agent locale o non hai ancora configurato il servizio, fai clic su “Connect” nell'estensione e invia all'Agent le istruzioni mostrate nella finestra. In alternativa, copia la richiesta per il tuo sistema operativo:
macOS o Linux
Windows
Verifica che installazione e avvio siano riusciti, poi controlla nuovamente “Connection”.
3. Il servizio locale installato è in esecuzione?
L'installazione non garantisce che il servizio resti attivo. In Kimi Work, fai prima clic su “Connetti” nelle impostazioni indicate. Con un altro Agent locale, chiedigli di controllare il servizio locale dell'Estensione del browser Kimi e avviarlo se necessario. Poi fai clic su “Connect” nell'estensione. Se l'avvio fallisce, verifica eventuali conflitti di porta.
4. L'indirizzo dell'estensione coincide con quello del servizio locale?
Controlla “Settings” → “Local agent remote control” → “Connection address”. L'indirizzo predefinito è ws://127.0.0.1:10086/ws. Se hai cambiato la porta del servizio, l'estensione deve usare la stessa. Modificarla da un solo lato impedisce la connessione.
5. L'errore segnala una porta potenzialmente occupata?
Se compare Port … is most likely held by another program, chiedi all'Agent locale di controllare la porta indicata, il programma che la usa e i log allegati. Il messaggio segnala una possibilità, senza confermare la causa. Una volta verificato il conflitto, segui la guida qui sotto.
Se ancora non riesci a collegarti, usa “Settings” → “Feedback” nell'estensione. Includi le versioni di Kimi Work o dell'Agent locale, del browser e dell'estensione, uno screenshot dello stato, l'errore completo e i tentativi già effettuati.
Cosa fare se la porta è occupata? Come cambio la porta di connessione?
Il servizio di connessione locale usa la porta 10086 per impostazione predefinita. Identifica prima il programma che la occupa. Se puoi chiuderlo, fallo e riprova la connessione. Se deve restare attivo, segui questi passaggi per cambiare porta.
Kimi Work 3.2.18 e gli altri Agent locali possono usare la stessa procedura per cambiare porta. Se usi una versione precedente di Work, aggiorna prima alla 3.2.18 o successiva. Il servizio locale dell’Estensione del browser Kimi deve essere v2.0.22 o successivo.
Puoi cambiare la porta sia del servizio sia dell'estensione. L'esempio usa 12086: chiedi prima all'Agent di verificare che sia libera. Attendi che le attività del browser terminino, perché il riavvio interrompe la connessione attuale.
1. Modifica la configurazione del servizio locale.
Apri il file seguente o crealo se manca. Conserva gli altri campi e modifica solo addr. Se compare un errore di configurazione, controlla la sintassi JSON e che addr segua il formato dell’indirizzo qui sotto, correggi e riprova:
- macOS / Linux:
~/.kimi-webbridge/config.json - Windows:
%USERPROFILE%\.kimi-webbridge\config.json
2. Riavvia il servizio locale e controlla lo stato.
Esegui i comandi per il tuo sistema operativo oppure chiedi all'Agent locale di farlo:
Verifica running: true e che port sia 12086. Se resta la vecchia porta o l’avvio fallisce, risolvi prima l’errore del servizio. Work riutilizza un servizio attivo funzionante; salvare la configurazione o riaprire Work non lo sposta automaticamente sulla nuova porta.
3. Modifica l'indirizzo di connessione dell'estensione.
Nella barra laterale, apri “Settings” → “Local agent remote control” → “Connection address”, inserisci ws://127.0.0.1:12086/ws e fai clic su “Test”. Se il test riesce, fai clic su “Save”. Torna alle impostazioni e verifica che “Connection” mostri “Connected”.
4. Chiedi all'Agent locale di usare il nuovo indirizzo.
In Kimi Work, riapri Work dopo questi passaggi e fai clic su “Connetti” in “Impostazioni” → “Automazione” → “Browser use”. Per un altro Agent locale, comunica che il servizio ora usa 127.0.0.1:12086 e deve proseguire usando la porta effettiva restituita da status. extension_connected: true indica che l’estensione è connessa. Se è false, verifica che il browser sia aperto, l’estensione attiva e l’indirizzo coincida con il passaggio 3.
Per ripristinare la porta predefinita, riporta addr a 127.0.0.1:10086, riavvia il servizio e fai clic su “Reset to default” nella pagina “Connection address”. Verifica prima che nessun altro programma occupi 10086.
L'Estensione del browser Kimi può compromettere le mie informazioni di accesso?
No. Tutta l'esecuzione avviene localmente sul tuo dispositivo: gli stati di accesso e i contenuti delle pagine web non lasciano mai la tua macchina. L'Agent può accedere solo ai risultati delle operazioni che autorizzi.
Perché le operazioni falliscono?
Strutture di pagina complesse o caricamenti dinamici possono causare il fallimento delle operazioni. Prova a semplificare le tue istruzioni, oppure chiedi all'Agent di acquisire prima uno screenshot per confermare lo stato della pagina prima dell'esecuzione.
Utilizzo con altri agent
Quali altri Agent sono supportati?
L'Estensione del browser Kimi supporta tutti i Local Agent, tra cui Claude Code, Codex, Cursor, Kimi Code, Hermes Claw e altri.
La configurazione è uguale per i diversi Agent?
Il comando di configurazione è lo stesso per tutti: basta eseguire un singolo comando curl per l'installazione. Per i dettagli, consulta la configurazione delle Skill di ciascun Agent.
Questo articolo ti è stato utile?