ego (lite) é só um navegador, ego é o seu agente pessoal em qualquer dispositivo.
Entrar na lista de espera
Baixar para Mac
Português
EnglishFrançaisDeutsch简体中文繁體中文日本語한국어РусскийPortuguêsEspañolItalianoहिन्दी
Soluções
DocumentaçãoEmpresasRegistro de alteraçõesBlog

Como usar o ego (lite) com o seu próprio Agent Harness

Conecte o seu próprio Agent Harness ao ego (lite). Verifique onde os comandos são executados, conceda a execução no host apenas quando necessário, carregue o ego-browser e conclua uma tarefa no navegador.

llms.txt

Material de exemplo: este guia usa gravações do OpenClaw para demonstrar um fluxo de conexão de Agent Harness. O seu Harness pode usar menus, comandos e nomes de permissão diferentes.

O seu próprio Agent Harness pode controlar o ego (lite) desde que consiga executar ego-browser no computador onde o ego (lite) está instalado. Primeiro, identifique se você está usando uma interface Desktop ou uma TUI para saber onde procurar as configurações. Depois, determine onde o Harness executa os comandos. A segunda pergunta decide se o acesso de execução no host é necessário.

Trate o vídeo como um fluxo Desktop possível, não como uma interface universal de Harness.

Antes de começar

Instale o ego (lite), conclua a configuração inicial e garanta que o seu Harness consegue executar comandos Shell.

  1. Baixe o arquivo DMG e abra-o
  2. Siga as instruções e dê um clique duplo no ícone do ego (lite) para instalar
  3. Abra o ego (lite) e conclua a configuração inicial
    1. Abra o seu Harness na interface Desktop ou na TUI
    1. Confirme que o Harness consegue executar comandos no computador onde o ego (lite) está instalado

O ego (lite) instala a Skill compartilhada ego-browser em ~/.agents/skills/. Se o seu Harness suporta Agent Skills, configure-o para varrer essa pasta ou importe a Skill usando o método documentado pelo Harness.

Depois de instalar o ego (lite), feche o aplicativo do agente por completo e reabra antes de continuar. Isso permite que o aplicativo recarregue a Skill ego-browser recém-instalada e mostre o comando correspondente nos aplicativos que suportam comandos de barra de Skill. Fechar apenas a sessão ou a janela atual pode não recarregar a Skill.

Desktop e TUI determinam onde ficam as configurações

Um aplicativo Desktop pode executar comandos diretamente no seu computador ou dentro de um sandbox. Uma TUI também pode fazer qualquer um dos dois. Use o tipo de interface para encontrar as configurações relevantes e depois inspecione o ambiente de execução dos comandos. Se o Bypass permissions é necessário depende de o agente conseguir executar comandos no computador onde o ego (lite) está instalado.

  • Em uma interface Desktop, procure as permissões nas configurações de sessão, espaço de trabalho, agente, ferramenta ou segurança.
  • Em uma TUI, verifique os flags de inicialização, o arquivo de configuração, as variáveis de ambiente ou a linha de status da sessão.

O próximo passo determina qual caminho de permissão se aplica ao seu Harness.

Etapa 1: verifique onde o seu Harness executa os comandos

Primeiro, peça ao agente para executar este comando na mesma sessão que vai realizar a tarefa de navegador:

command -v ego-browser

Este comando apenas confirma se a sessão atual consegue encontrar ego-browser. Ele não prova que os comandos são executados no computador host. Use as informações de sessão do Harness ou a documentação oficial para identificar o ambiente de execução e confirme-o com o teste real de conexão na etapa 4.

Escolha o próximo passo com base no ambiente de execução:

  1. Os comandos são executados diretamente neste computador, sem sandbox: o ego-browser consegue iniciar o ego (lite) instalado localmente. Pode não haver uma configuração de Bypass permissions, e você não precisa criar uma. Vá para a etapa 3.
  2. O agente roda dentro de um sandbox local: o Harness deve fornecer uma capacidade oficial de execução no host, sem sandbox ou com ponte para o host, que permita ao agente entregar o ego-browser a este computador. Vá para a etapa 2.
  3. O agente roda em um contêiner, máquina virtual, servidor remoto ou ambiente de nuvem: o Harness precisa de uma ponte para o host capaz de executar ego-browser neste computador. Sem essa ponte, instalar ou carregar a Skill no ambiente remoto não é suficiente para controlar o aplicativo local do ego (lite).

Se command -v ego-browser não retornar nenhum caminho, primeiro confirme que a configuração inicial do ego (lite) foi concluída. Depois, verifique se o Harness está usando um PATH ou um ambiente de execução diferente do seu terminal normal.

Etapa 2: garanta que o agente possa executar fora do sandbox

Antes de continuar, garanta que o agente possa executar fora do sandbox e rodar ego-browser no computador onde o ego (lite) está instalado. Se o agente já roda diretamente neste computador sem sandbox, nenhuma permissão adicional é necessária.

Se o Harness pedir confirmação antes de cada comando, você pode aprovar os comandos manualmente ou ativar o modo sem aprovação para uma sessão confiável. O modo sem aprovação apenas reduz os pedidos de confirmação; ele não é necessário para conectar ao ego (lite).

Exemplo Desktop: política de aprovação

Esta gravação mostra as configurações de Exec Approvals do OpenClaw. Ela apenas demonstra como um Harness Desktop pode gerenciar as aprovações de comandos. Desativar os pedidos de aprovação não prova que o agente tem acesso de execução no host. Se o seu Harness usa um sandbox, siga primeiro a documentação oficial dele para ativar a execução no host ou uma ponte para o host e depois ajuste a política de aprovação, se necessário.

Exemplo TUI: modo sem aprovação

Esta gravação mostra o OpenClaw aplicando a própria predefinição sem aprovação antes de abrir a TUI. Ela muda a política de aprovação do OpenClaw; não significa que outro Harness agora possa escapar do sandbox dela. Não copie o comando do OpenClaw para outro Harness a menos que a documentação dele suporte isso. Procure separadamente o método oficial de execução no host e a configuração de aprovação fornecidos pelo seu Harness.

A execução no host amplia o que o agente pode acessar no seu computador. O modo sem aprovação remove a etapa de confirmação antes de cada comando. Esses controles carregam riscos diferentes. Ative-os apenas para um Harness, um espaço de trabalho e uma tarefa em que você confia. Se o Harness suporta uma lista de permissão de comandos do host ou uma política mais restrita, prefira conceder acesso apenas aos comandos necessários para este fluxo.

Etapa 3: carregue a Skill ego-browser

Exemplo Desktop

A gravação usa o seletor de Skills do OpenClaw para carregar o ego-browser. No seu próprio Harness Desktop, abra uma sessão de agente local capaz de Shell e carregue o ego-browser pela interface de Skills ou de Tools. O comando exato exibido no OpenClaw é específico do produto.

Exemplo TUI

Se a sua TUI suporta comandos de barra de Skill, digite /ego-browser, adicione um espaço e continue com a tarefa na mesma mensagem. Se ela não oferecer comandos de barra, peça ao agente para localizar e ler a Skill ego-browser antes de começar. Um item de menu /ego-browser ausente não significa por si só que a Skill não possa ser usada.

Você pode usar esta verificação de compatibilidade como primeiro prompt:

Primeiro, determine se o seu ambiente de execução de comandos está rodando diretamente neste computador ou dentro de um sandbox, contêiner ou ambiente remoto. Se usar sandbox, confirme que você tem uma permissão ou ponte oficial que permita aos comandos rodarem neste computador. Não trate os pedidos de aprovação desativados como prova de execução no host.

Depois, localize e leia a Skill ego-browser. Verifique primeiro ~/.agents/skills/ego-browser/SKILL.md. Se você não conseguir executar o ego-browser neste computador, pare e explique qual permissão ou ponte de execução no host está faltando.

Etapa 4: execute um teste simples de conexão

Antes de abrir um site com login, teste a conexão com uma página pública simples:

Use a Skill ego-browser para abrir https://example.com no ego (lite), informe o título da página e deixe a página aberta.

O caminho de execução no host funciona quando o ego (lite) abre um Agent Space, a página carrega e o Harness retorna o título da página. Se a página abrir depois que você aprovar o comando manualmente, resta apenas a política de aprovação; você pode continuar aprovando comandos ou usar a configuração sem aprovação documentada do Harness para uma sessão confiável. Se o comando nunca chegar a este computador, volte às etapas 1 e 2 e verifique a permissão ou ponte de execução no host.

Etapa 5: deixe o seu agente concluir uma tarefa de navegador

Assim que o teste de conexão funcionar, entregue ao Harness uma tarefa real de navegador. A gravação usa o OpenClaw como controlador de exemplo, mas o fluxo visível no ego (lite) é o mesmo: o agente carrega a Skill, abre um Agent Space, visita a página alvo e coleta as informações solicitadas.

Tente a mesma tarefa usada ao longo destes guias:

Use a Skill ego-browser para abrir o perfil oficial da Anthropic no X e coletar as cinco primeiras publicações mostradas no feed Posts.

Se o Harness não suportar comandos de barra de Skill, esta instrução em linguagem natural é suficiente desde que o agente consiga localizar a Skill e executar ego-browser no computador host.

Etapa 6: verifique o resultado concluído

Quando a tarefa terminar, confirme que o Harness retornou as informações solicitadas e que a página de origem permanece aberta no ego (lite). A gravação mostra o resultado no OpenClaw; o seu próprio Harness pode apresentar a resposta de forma diferente.

Se o site pedir login, CAPTCHA ou verificação de conta, assuma o controle no Agent Space do ego (lite) e conclua você mesmo. Nunca coloque senhas ou códigos de verificação no prompt do agente.

Solução de problemas

O meu Harness não tem Bypass permissions

Isso pode ser normal. Se os comandos já rodam diretamente no seu computador sem sandbox, não há permissão de sandbox para contornar. Confirme que command -v ego-browser retorna um caminho a partir da sessão do agente e depois verifique a conexão na etapa 4. Se o Harness pede apenas aprovação por comando, você pode aprovar cada comando manualmente em vez de procurar uma configuração de Bypass permissions.

/ego-browser não aparece

Comandos de barra são um recurso de interface do Harness, não um requisito do ego (lite). Peça ao agente para ler ~/.agents/skills/ego-browser/SKILL.md ou configure o Harness para varrer ~/.agents/skills/ usando o método de importação de Skill suportado por ele.

ego-browser não é encontrado

Conclua a configuração inicial do ego (lite), reinicie o Harness e execute command -v ego-browser novamente na mesma sessão de agente. Se o comando funcionar no seu terminal normal, mas não no Harness, compare os PATH e os ambientes de execução.

O agente fica pedindo aprovação

Isso apenas significa que o Harness ainda está aplicando a política de aprovação; não prova que o agente está preso em um sandbox. Se o ego (lite) abrir após a aprovação manual, continue aprovando comandos ou use a configuração sem aprovação documentada do produto para uma sessão confiável. Se o comando ainda não chegar ao host após a aprovação, verifique a permissão ou ponte de execução no host. Não copie comandos ou flags de outro produto.

O Harness roda em Docker, SSH ou na nuvem

O ambiente remoto de execução não pode controlar uma instalação local do ego (lite) a menos que o Harness forneça uma ponte de execução no host. Execute o Harness localmente, configure a ponte suportada por ele ou instale e execute um ambiente de navegador compatível na mesma máquina do ambiente de execução do agente.

A Skill carrega, mas o ego (lite) não abre

Confirme que o agente está executando ego-browser no computador onde o ego (lite) está instalado. Carregar a Skill dá instruções ao agente; isso não move a execução dos comandos de um sandbox ou de uma máquina remota para o seu computador.

Indo mais fundo