ego (lite) è solo un browser; ego è il tuo agente personale su tutti i dispositivi.
Iscriviti alla lista d'attesa
Scarica per Mac
Italiano
EnglishFrançaisDeutsch简体中文繁體中文日本語한국어РусскийPortuguêsEspañolItalianoहिन्दी
Soluzioni
DocumentazioneAziendeChangelogBlog

Come usare ego (lite) con il tuo Agent Harness

Collega il tuo Agent Harness a ego (lite). Verifica dove vengono eseguiti i comandi, concedi l'esecuzione sull'host solo quando necessario, carica ego-browser e completa un'attività nel browser.

llms.txt

Materiale di esempio: questa guida usa registrazioni di OpenClaw per mostrare un flusso di connessione di Agent Harness. Il tuo Harness potrebbe usare menu, comandi e nomi di permessi diversi.

Il tuo Agent Harness può controllare ego (lite) se può eseguire ego-browser sul computer dove è installato ego (lite). Prima identifica se stai usando un'interfaccia Desktop o una TUI, così sai dove cercare le impostazioni. Poi determina dove il Harness esegue i comandi. La seconda domanda decide se è richiesto l'accesso all'esecuzione sull'host.

Considera il video come un possibile flusso Desktop, non come un'interfaccia universale del Harness.

Prima di iniziare

Installa ego (lite), completa la configurazione iniziale e assicurati che il tuo Harness possa eseguire comandi Shell.

  1. Scarica il file DMG e aprilo
  2. Segui le istruzioni e fai doppio clic sull'icona di ego (lite) per installarlo
  3. Apri ego (lite) e completa la configurazione iniziale
    1. Apri il tuo Harness nella sua interfaccia Desktop o nella sua TUI
    1. Conferma che il Harness possa eseguire comandi sul computer dove è installato ego (lite)

ego (lite) installa la Skill condivisa ego-browser in ~/.agents/skills/. Se il tuo Harness supporta le Skill degli agenti, configuralo per scansionare quella cartella o importa la Skill con il metodo documentato dal Harness.

Dopo aver installato ego (lite), chiudi completamente l'app dell'agente e riaprila prima di continuare. Questo permette all'app di ricaricare la Skill ego-browser appena installata e mostrare il suo comando corrispondente nelle app che supportano i comandi a barra delle Skill. Chiudere solo la sessione o la finestra corrente potrebbe non ricaricare la Skill.

Desktop e TUI determinano dove si trovano le impostazioni

Un'app Desktop può eseguire comandi direttamente sul tuo computer o dentro una sandbox. Anche una TUI può fare entrambe le cose. Usa il tipo di interfaccia per trovare le impostazioni rilevanti, poi ispeziona l'ambiente di esecuzione dei comandi. Se Bypass permissions sia necessario dipende dal fatto che l'agente possa eseguire comandi sul computer dove è installato ego (lite).

  • In un'interfaccia Desktop, cerca i permessi nelle impostazioni di sessione, spazio di lavoro, agente, strumento o sicurezza.
  • In una TUI, controlla i flag di avvio, il file di configurazione, le variabili d'ambiente o la riga di stato della sessione.

Il passo successivo determina quale percorso di permessi si applica al tuo Harness.

Passaggio 1: verifica dove il tuo Harness esegue i comandi

Prima chiedi all'agente di eseguire questo comando dalla stessa sessione che svolgerà l'attività nel browser:

command -v ego-browser

Questo comando conferma solo se la sessione corrente può trovare ego-browser. Non prova che i comandi vengano eseguiti sul computer host. Usa le informazioni di sessione del Harness o la documentazione ufficiale per identificare l'ambiente di esecuzione, poi confermalo con il test reale di connessione al passaggio 4.

Scegli il passo successivo in base all'ambiente di esecuzione:

  1. I comandi vengono eseguiti direttamente su questo computer senza sandbox: ego-browser può avviare l'ego (lite) installato in locale. Potrebbe non esserci un'impostazione Bypass permissions, e non devi crearla. Continua al passaggio 3.
  2. L'agente gira dentro una sandbox locale: il Harness deve fornire una capacità ufficiale di esecuzione sull'host, non sandbox o con bridge verso l'host, che permetta all'agente di consegnare ego-browser a questo computer. Continua al passaggio 2.
  3. L'agente gira in un container, una macchina virtuale, un server remoto o un ambiente cloud: il Harness ha bisogno di un bridge verso l'host in grado di eseguire ego-browser su questo computer. Senza quel bridge, installare o caricare la Skill nell'ambiente remoto non basta per controllare l'app locale di ego (lite).

Se command -v ego-browser non restituisce alcun percorso, prima conferma che la configurazione iniziale di ego (lite) sia completata. Poi verifica se il Harness stia usando un PATH o un ambiente di esecuzione diverso dal tuo terminale normale.

Passaggio 2: assicurati che l'agente possa eseguire fuori dalla sandbox

Prima di continuare, assicurati che l'agente possa eseguire fuori dalla sandbox e lanciare ego-browser sul computer dove è installato ego (lite). Se l'agente gira già direttamente su questo computer senza sandbox, non serve alcun permesso aggiuntivo.

Se il Harness chiede conferma prima di ogni comando, puoi approvare i comandi manualmente o attivare la sua modalità senza approvazione per una sessione di fiducia. La modalità senza approvazione riduce solo le richieste di conferma; non è necessaria per connettersi a ego (lite).

Esempio Desktop: politica di approvazione

Questa registrazione mostra le impostazioni Exec Approvals di OpenClaw. Dimostra solo come un Harness Desktop può gestire le approvazioni dei comandi. Disattivare le richieste di approvazione non prova che l'agente abbia accesso all'esecuzione sull'host. Se il tuo Harness usa una sandbox, segui prima la sua documentazione ufficiale per abilitare l'esecuzione sull'host o un bridge verso l'host, poi regola la politica di approvazione se necessario.

Esempio TUI: modalità senza approvazione

Questa registrazione mostra OpenClaw che applica il proprio preset senza approvazione prima di aprire la TUI. Cambia la politica di approvazione di OpenClaw; non significa che un altro Harness possa ora uscire dalla sua sandbox. Non copiare il comando di OpenClaw in un altro Harness a meno che la sua documentazione non lo supporti. Cerca separatamente il metodo ufficiale di esecuzione sull'host e l'impostazione di approvazione forniti dal tuo Harness.

L'esecuzione sull'host amplia ciò a cui l'agente può accedere sul tuo computer. La modalità senza approvazione rimuove il passaggio di conferma prima di ogni comando. Questi controlli comportano rischi diversi. Attivali solo per un Harness, uno spazio di lavoro e un'attività di cui ti fidi. Se il Harness supporta una lista di autorizzazione dei comandi sull'host o una politica più ristretta, preferisci concedere accesso solo ai comandi necessari per questo flusso.

Passaggio 3: carica la Skill ego-browser

Esempio Desktop

La registrazione usa il selettore di Skill di OpenClaw per caricare ego-browser. Nel tuo Harness Desktop, apri una sessione di agente locale in grado di usare Shell e carica ego-browser dalla sua interfaccia Skill o Tools. Il comando esatto mostrato in OpenClaw è specifico del prodotto.

Esempio TUI

Se la tua TUI supporta i comandi a barra delle Skill, digita /ego-browser, aggiungi uno spazio e continua con l'attività nello stesso messaggio. Se non offre comandi a barra, chiedi all'agente di individuare e leggere la Skill ego-browser prima di iniziare. L'assenza di una voce di menu /ego-browser non significa di per sé che la Skill non possa essere usata.

Puoi usare questa verifica di compatibilità come primo prompt:

Prima determina se l'ambiente di esecuzione dei comandi gira direttamente su questo computer o dentro una sandbox, un container o un ambiente remoto. Se usa una sandbox, conferma di avere un permesso o un bridge ufficiale che permetta ai comandi di girare su questo computer. Non considerare le richieste di approvazione disattivate come prova di esecuzione sull'host.

Poi individua e leggi la Skill ego-browser. Prima controlla ~/.agents/skills/ego-browser/SKILL.md. Se non riesci a eseguire ego-browser su questo computer, fermati e spiega quale permesso o bridge di esecuzione sull'host manca.

Passaggio 4: esegui un semplice test di connessione

Prima di aprire un sito con accesso effettuato, prova la connessione con una semplice pagina pubblica:

Usa la Skill ego-browser per aprire https://example.com in ego (lite), riporta il titolo della pagina e lascia la pagina aperta.

Il percorso di esecuzione sull'host funziona quando ego (lite) apre un Agent Space, la pagina carica e il Harness restituisce il titolo della pagina. Se la pagina si apre dopo che approvi il comando manualmente, resta solo la politica di approvazione; puoi continuare ad approvare comandi o usare l'impostazione senza approvazione documentata dal Harness per una sessione di fiducia. Se il comando non raggiunge mai questo computer, torna ai passaggi 1 e 2 e verifica il permesso o il bridge di esecuzione sull'host.

Passaggio 5: lascia che il tuo agente completi un'attività nel browser

Una volta che il test di connessione funziona, affida al Harness una vera attività nel browser. La registrazione usa OpenClaw come controller di esempio, ma il flusso visibile di ego (lite) è lo stesso: l'agente carica la Skill, apre un Agent Space, visita la pagina di destinazione e raccoglie le informazioni richieste.

Prova la stessa attività usata in tutte queste guide:

Usa la Skill ego-browser per aprire il profilo ufficiale di Anthropic su X e raccogliere i primi cinque post mostrati nel feed Posts.

Se il Harness non supporta i comandi a barra delle Skill, questa istruzione in linguaggio naturale basta, purché l'agente riesca a individuare la Skill ed eseguire ego-browser sul computer host.

Passaggio 6: verifica il risultato completato

Quando l'attività finisce, conferma che il Harness abbia restituito le informazioni richieste e che la pagina di origine rimanga aperta in ego (lite). La registrazione mostra il risultato in OpenClaw; il tuo Harness potrebbe presentare la risposta in modo diverso.

Se il sito chiede un accesso, un CAPTCHA o una verifica dell'account, prendi il controllo nell'Agent Space di ego (lite) e completala tu stesso. Non mettere mai password o codici di verifica nel prompt dell'agente.

Risoluzione dei problemi

Il mio Harness non ha Bypass permissions

Può essere normale. Se i comandi girano già direttamente sul tuo computer senza sandbox, non c'è alcun permesso di sandbox da bypassare. Conferma che command -v ego-browser restituisca un percorso dalla sessione dell'agente, poi verifica la connessione al passaggio 4. Se il Harness chiede solo l'approvazione per ogni comando, puoi approvare ogni comando manualmente invece di cercare un'impostazione Bypass permissions.

/ego-browser non compare

I comandi a barra sono una funzione dell'interfaccia del Harness, non un requisito di ego (lite). Chiedi all'agente di leggere ~/.agents/skills/ego-browser/SKILL.md, oppure configura il Harness per scansionare ~/.agents/skills/ con il suo metodo di importazione delle Skill supportato.

ego-browser non viene trovato

Completa la configurazione iniziale di ego (lite), riavvia il Harness ed esegui di nuovo command -v ego-browser dalla stessa sessione dell'agente. Se il comando funziona nel tuo terminale normale ma non nel Harness, confronta i loro PATH e ambienti di esecuzione.

L'agente continua a chiedere approvazione

Significa solo che il Harness sta ancora applicando la sua politica di approvazione; non prova che l'agente sia intrappolato in una sandbox. Se ego (lite) si apre dopo l'approvazione manuale, continua ad approvare i comandi o usa l'impostazione senza approvazione documentata dal prodotto per una sessione di fiducia. Se il comando non raggiunge ancora l'host dopo l'approvazione, verifica il permesso o il bridge di esecuzione sull'host. Non copiare comandi o flag da un altro prodotto.

Il Harness gira in Docker, SSH o nel cloud

L'ambiente remoto di esecuzione non può controllare un'installazione locale di ego (lite) a meno che il Harness non fornisca un bridge di esecuzione sull'host. Esegui il Harness in locale, configura il suo bridge supportato, oppure installa ed esegui un ambiente browser compatibile sulla stessa macchina dell'ambiente di esecuzione dell'agente.

La Skill si carica ma ego (lite) non si apre

Conferma che l'agente stia eseguendo ego-browser sul computer dove è installato ego (lite). Caricare la Skill dà indicazioni all'agente; non sposta l'esecuzione dei comandi da una sandbox o da una macchina remota sul tuo computer.

Per approfondire