Saltar al contenido principal

​
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. Para una visión general de las rutas de onboarding, consulta Onboarding Overview.
1

Approve macOS warning

2

Approve find local networks

3

Welcome and security notice

4

Local vs Remote

¿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.
5

Permissions

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
6

CLI

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.
7

Onboarding Chat (dedicated session)

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.