Incorporación (App de macOS)¶

Este documento describe el flujo de incorporación actual en el primer inicio. El objetivo es una experiencia fluida desde el “día 0”: elegir dónde se ejecuta el Gateway, conectar la autenticación, ejecutar el asistente y permitir que el agente se inicialice por sí mismo.

¿Dónde se ejecuta el Gateway?

• Este Mac (solo local): la incorporación puede ejecutar flujos OAuth y escribir credenciales localmente.
• Remoto (por SSH/Tailnet): la incorporación no ejecuta OAuth localmente; las credenciales deben existir en el host del Gateway.
• Configurar más tarde: omitir la configuración y dejar la app sin configurar.

Consejo de autenticación del Gateway: - El asistente ahora genera un token incluso para loopback, por lo que los clientes WS locales deben autenticarse. - Si deshabilita la autenticación, cualquier proceso local puede conectarse; úselo solo en máquinas totalmente confiables. - Use un token para acceso desde varias máquinas o enlaces que no sean loopback.

La incorporación solicita permisos TCC necesarios para:

• Automatización (AppleScript)
• Notificaciones
• Accesibilidad
• Grabación de pantalla
• Micrófono
• Reconocimiento de voz
• Cámara
• Ubicación

Este paso es opcional La app puede instalar la CLI global openclaw mediante npm/pnpm para que los flujos de trabajo en terminal y las tareas de launchd funcionen de inmediato. Después de la configuración, la app abre una sesión de chat de incorporación dedicada para que el agente pueda presentarse y guiar los siguientes pasos. Esto mantiene la guía del primer inicio separada de su conversación normal. Consulte Bootstrapping para saber qué sucede en el host del Gateway durante la primera ejecución del agente.