Incorporación (aplicación macOS)

Este documento describe el flujo de configuración de primer inicio actual. El objetivo es una experiencia fluida del “día 0”: elegir dónde se ejecuta el Gateway, conectar la autenticación, ejecutar el asistente y dejar que el agente se inicie automáticamente. Para obtener una descripción general de las rutas de incorporación, consulte Información general sobre la incorporación.

1. Aprobar advertencia de macOS

   

2. Approve find local networks

   

3. Bienvenida y aviso de seguridad

   

   Modelo de confianza de seguridad:

   • De forma predeterminada, OpenClaw es un agente personal: un límite de un operador de confianza.
   • Las configuraciones compartidas/multiusuario requieren bloqueo (dividir los límites de confianza, mantener el acceso a las herramientas al mínimo y seguir Seguridad).
   • La incorporación local ahora establece de forma predeterminada las nuevas configuraciones en tools.profile: "coding" para que las configuraciones locales nuevas mantengan las herramientas de sistema de archivos/ejecución sin forzar el perfil full sin restricciones.
   • Si se habilitan hooks/webhooks u otras fuentes de contenido que no son de confianza, utilice un nivel de modelo moderno y sólido y mantenga una política estricta de herramientas y sandbox.

4. Local vs. Remoto

   

   ¿Dónde se ejecuta el Gateway?

   • Esta Mac (solo local): la incorporación puede configurar la autenticación y escribir las credenciales localmente.
   • Remoto (a través de SSH/Tailnet): la incorporación no configura la autenticación local; las credenciales deben existir en el host de la puerta de enlace.
   • Configurar más tarde: omitir la configuración y dejar la aplicación sin configurar.

   Tip

   Sugerencia de autenticación del Gateway:

   • El asistente ahora genera un token incluso para el bucle local, por lo que los clientes de WS locales deben autenticarse.
   • Si deshabilita la autenticación, cualquier proceso local puede conectarse; úselo solo en máquinas de total confianza.
   • Use un token para el acceso de varias máquinas o enlaces que no sean de bucle local.

5. Permisos

   

   La incorporación solicita los permisos TCC necesarios para:

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

6. CLI

   Info

   Este paso es opcional

   La aplicación puede instalar la openclaw CLI global a través de npm, pnpm o bun. Prefiere npm primero, luego pnpm, y luego bun si ese es el único gestor de paquetes detectado. Para el tiempo de ejecución de Gateway, Node sigue siendo la ruta recomendada.

7. Chat de incorporación (sesión dedicada)

   Después de la configuración, la aplicación 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 de primer inicio separada de su conversación normal. Consulte Inicialización para ver qué sucede en el host de la puerta de enlace durante la primera ejecución del agente.

Relacionado

• Descripción general de la incorporación
• Primeros pasos