ego (lite) es solo un navegador, ego es su agente personal en todos sus dispositivos.
Únanse a la lista de espera
Descargar para Mac
Español
EnglishFrançaisDeutsch简体中文繁體中文日本語한국어РусскийPortuguêsEspañolItalianoहिन्दी
Soluciones
DocumentaciónEmpresasRegistro de cambiosBlog

Cómo usar ego (lite) con tu propio Agent Harness

Conecta tu propio Agent Harness a ego (lite). Comprueba dónde se ejecutan los comandos, concede la ejecución en el host solo cuando sea necesario, carga ego-browser y completa una tarea en el navegador.

llms.txt

Material de ejemplo: esta guía usa grabaciones de OpenClaw para mostrar un flujo de conexión de Agent Harness. Tu Harness puede usar menús, comandos y nombres de permisos diferentes.

Tu propio Agent Harness puede controlar ego (lite) siempre que pueda ejecutar ego-browser en el equipo donde está instalado ego (lite). Primero identifica si estás usando una interfaz Desktop o una TUI para saber dónde buscar la configuración. Luego determina dónde ejecuta los comandos el Harness. La segunda pregunta decide si se requiere acceso de ejecución en el host.

Considera el video como un flujo Desktop posible, no como una interfaz universal de Harness.

Antes de empezar

Instala ego (lite), completa la configuración inicial y asegúrate de que tu Harness pueda ejecutar comandos de Shell.

  1. Descarga el archivo DMG y ábrelo
  2. Sigue las indicaciones y haz doble clic en el icono de ego (lite) para instalarlo
  3. Abre ego (lite) y completa la configuración inicial
    1. Abre tu Harness en su interfaz Desktop o su TUI
    1. Confirma que el Harness puede ejecutar comandos en el equipo donde está instalado ego (lite)

ego (lite) instala la Skill compartida ego-browser en ~/.agents/skills/. Si tu Harness admite Agent Skills, configúralo para escanear ese directorio o importa la Skill con el método documentado por el Harness.

Después de instalar ego (lite), cierra la aplicación del agente por completo y vuelve a abrirla antes de continuar. Esto permite que la aplicación recargue la Skill ego-browser recién instalada y muestre su comando correspondiente en las aplicaciones que admiten comandos de barra de Skill. Cerrar solo la sesión o la ventana actual puede no recargar la Skill.

Desktop y TUI determinan dónde está la configuración

Una aplicación Desktop puede ejecutar comandos directamente en tu equipo o dentro de un sandbox. Una TUI también puede hacer cualquiera de las dos cosas. Usa el tipo de interfaz para encontrar la configuración relevante y luego inspecciona el entorno de ejecución de los comandos. Si se requiere Bypass permissions depende de si el agente puede ejecutar comandos en el equipo donde está instalado ego (lite).

  • En una interfaz Desktop, busca los permisos en la configuración de sesión, espacio de trabajo, agente, herramienta o seguridad.
  • En una TUI, revisa las banderas de inicio, el archivo de configuración, las variables de entorno o la línea de estado de la sesión.

El siguiente paso determina qué ruta de permisos aplica a tu Harness.

Paso 1: comprueba dónde ejecuta los comandos tu Harness

Primero pídele al agente que ejecute este comando desde la misma sesión que realizará la tarea del navegador:

command -v ego-browser

Este comando solo confirma si la sesión actual puede encontrar ego-browser. No prueba que los comandos se ejecuten en el equipo host. Usa la información de sesión del Harness o la documentación oficial para identificar el entorno de ejecución y luego confírmalo con la prueba de conexión real del paso 4.

Elige el siguiente paso según el entorno de ejecución:

  1. Los comandos se ejecutan directamente en este equipo sin sandbox: ego-browser puede iniciar el ego (lite) instalado localmente. Puede que no exista una configuración de Bypass permissions, y no necesitas crear una. Continúa al paso 3.
  2. El agente se ejecuta dentro de un sandbox local: el Harness debe proporcionar una capacidad oficial de ejecución en el host, sin sandbox o con puente al host, que permita al agente entregar ego-browser a este equipo. Continúa al paso 2.
  3. El agente se ejecuta en un contenedor, máquina virtual, servidor remoto o entorno en la nube: el Harness necesita un puente al host capaz de ejecutar ego-browser en este equipo. Sin ese puente, instalar o cargar la Skill en el entorno remoto no basta para controlar la aplicación local de ego (lite).

Si command -v ego-browser no devuelve ninguna ruta, primero confirma que la configuración inicial de ego (lite) esté completa. Luego comprueba si el Harness usa un PATH o un entorno de ejecución diferente al de tu terminal habitual.

Paso 2: asegúrate de que el agente pueda ejecutarse fuera del sandbox

Antes de continuar, asegúrate de que el agente pueda ejecutarse fuera del sandbox y ejecutar ego-browser en el equipo donde está instalado ego (lite). Si el agente ya se ejecuta directamente en este equipo sin sandbox, no se necesita ningún permiso adicional.

Si el Harness pide confirmación antes de cada comando, puedes aprobar los comandos manualmente o activar su modo sin aprobación para una sesión de confianza. El modo sin aprobación solo reduce las solicitudes de confirmación; no es necesario para conectarse a ego (lite).

Ejemplo Desktop: política de aprobación

Esta grabación muestra la configuración de Exec Approvals de OpenClaw. Solo demuestra cómo un Harness Desktop puede gestionar las aprobaciones de comandos. Desactivar las solicitudes de aprobación no prueba que el agente tenga acceso de ejecución en el host. Si tu Harness usa un sandbox, sigue primero su documentación oficial para habilitar la ejecución en el host o un puente al host y luego ajusta la política de aprobación si es necesario.

Ejemplo TUI: modo sin aprobación

Esta grabación muestra a OpenClaw aplicando su propio preajuste sin aprobación antes de abrir la TUI. Cambia la política de aprobación de OpenClaw; no significa que otro Harness pueda ahora escapar de su sandbox. No copies el comando de OpenClaw en otro Harness a menos que su documentación lo respalde. Busca por separado el método oficial de ejecución en el host y la configuración de aprobación que proporciona tu Harness.

La ejecución en el host amplía lo que el agente puede acceder en tu equipo. El modo sin aprobación elimina el paso de confirmación antes de cada comando. Estos controles conllevan riesgos distintos. Actívalos solo para un Harness, un espacio de trabajo y una tarea en los que confíes. Si el Harness admite una lista de permisos de comandos del host o una política más restringida, prefiere conceder acceso solo a los comandos necesarios para este flujo.

Paso 3: carga la Skill ego-browser

Ejemplo Desktop

La grabación usa el selector de Skills de OpenClaw para cargar ego-browser. En tu propio Harness Desktop, abre una sesión de agente local capaz de Shell y carga ego-browser desde su interfaz de Skills o Tools. El comando exacto que se muestra en OpenClaw es específico del producto.

Ejemplo TUI

Si tu TUI admite comandos de barra de Skill, escribe /ego-browser, añade un espacio y continúa con la tarea en el mismo mensaje. Si no ofrece comandos de barra, pídele al agente que localice y lea la Skill ego-browser antes de comenzar. Que falte un elemento de menú /ego-browser no significa por sí mismo que la Skill no se pueda usar.

Puedes usar esta comprobación de compatibilidad como primera indicación:

Primero determina si tu entorno de ejecución de comandos está corriendo directamente en este equipo o dentro de un sandbox, contenedor o entorno remoto. Si usa un sandbox, confirma que tienes un permiso o puente oficial que permita ejecutar comandos en este equipo. No trates las solicitudes de aprobación desactivadas como prueba de ejecución en el host.

Luego localiza y lee la Skill ego-browser. Primero revisa ~/.agents/skills/ego-browser/SKILL.md. Si no puedes ejecutar ego-browser en este equipo, detente y explica qué permiso o puente de ejecución en el host falta.

Paso 4: ejecuta una prueba simple de conexión

Antes de abrir un sitio con sesión iniciada, prueba la conexión con una página pública simple:

Usa la Skill ego-browser para abrir https://example.com en ego (lite), informa el título de la página y deja la página abierta.

La ruta de ejecución en el host funciona cuando ego (lite) abre un Agent Space, la página carga y el Harness devuelve el título de la página. Si la página se abre después de aprobar el comando manualmente, solo queda la política de aprobación; puedes seguir aprobando comandos o usar la configuración sin aprobación documentada del Harness para una sesión de confianza. Si el comando nunca llega a este equipo, regresa a los pasos 1 y 2 y verifica el permiso o puente de ejecución en el host.

Paso 5: deja que tu agente complete una tarea del navegador

Una vez que la prueba de conexión funcione, dale al Harness una tarea real del navegador. La grabación usa OpenClaw como controlador de ejemplo, pero el flujo visible de ego (lite) es el mismo: el agente carga la Skill, abre un Agent Space, visita la página objetivo y recopila la información solicitada.

Prueba la misma tarea usada a lo largo de estas guías:

Usa la Skill ego-browser para abrir el perfil oficial de Anthropic en X y recopilar las cinco primeras publicaciones que se muestran en el feed de Posts.

Si el Harness no admite comandos de barra de Skill, esta instrucción en lenguaje natural es suficiente siempre que el agente pueda localizar la Skill y ejecutar ego-browser en el equipo host.

Paso 6: verifica el resultado completado

Cuando la tarea termine, confirma que el Harness devolvió la información solicitada y que la página de origen permanece abierta en ego (lite). La grabación muestra el resultado en OpenClaw; tu propio Harness puede presentar la respuesta de forma diferente.

Si el sitio pide un inicio de sesión, un CAPTCHA o una verificación de cuenta, toma el control en el Agent Space de ego (lite) y complétalo tú mismo. Nunca pongas contraseñas ni códigos de verificación en la indicación del agente.

Solución de problemas

Mi Harness no tiene Bypass permissions

Puede ser normal. Si los comandos ya se ejecutan directamente en tu equipo sin sandbox, no hay ningún permiso de sandbox que evadir. Confirma que command -v ego-browser devuelve una ruta desde la sesión del agente y luego verifica la conexión en el paso 4. Si el Harness solo pide aprobación por comando, puedes aprobar cada comando manualmente en lugar de buscar una configuración de Bypass permissions.

/ego-browser no aparece

Los comandos de barra son una función de la interfaz del Harness, no un requisito de ego (lite). Pídele al agente que lea ~/.agents/skills/ego-browser/SKILL.md o configura el Harness para escanear ~/.agents/skills/ con su método de importación de Skills compatible.

ego-browser no se encuentra

Completa la configuración inicial de ego (lite), reinicia el Harness y vuelve a ejecutar command -v ego-browser desde la misma sesión del agente. Si el comando funciona en tu terminal habitual pero no en el Harness, compara sus PATH y entornos de ejecución.

El agente sigue pidiendo aprobación

Esto solo significa que el Harness aún está aplicando su política de aprobación; no prueba que el agente esté atrapado en un sandbox. Si ego (lite) se abre tras la aprobación manual, sigue aprobando comandos o usa la configuración sin aprobación documentada del producto para una sesión de confianza. Si el comando aún no llega al host después de la aprobación, verifica el permiso o puente de ejecución en el host. No copies comandos ni banderas de otro producto.

El Harness se ejecuta en Docker, SSH o la nube

El entorno remoto de ejecución no puede controlar una instalación local de ego (lite) a menos que el Harness proporcione un puente de ejecución en el host. Ejecuta el Harness localmente, configura su puente compatible o instala y ejecuta un entorno de navegador compatible en el mismo equipo que el entorno de ejecución del agente.

La Skill se carga pero ego (lite) no se abre

Confirma que el agente está ejecutando ego-browser en el equipo donde está instalado ego (lite). Cargar la Skill le da instrucciones al agente; no mueve la ejecución de los comandos desde un sandbox o una máquina remota a tu equipo.

Para profundizar