Incorporación (aplicación macOS)

Este documento describe el flujo de configuración de primera ejecución actual. El objetivo es una experiencia fluida de “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.

Approve macOS warning
Approve find local networks
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.
Local vs. Remoto
¿Dónde se ejecuta el Gateway?
- Este 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: omita la configuración y deje la aplicación sin configurar.
Tip
Consejo de autenticación de Gateway:
- El asistente ahora genera un token incluso para el bucle invertido, por lo que los clientes 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 a varias máquinas o enlaces que no sean de bucle invertido.
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
CLI
Info
Este paso es opcional
La aplicación puede instalar la openclaw CLI global a través de npm/pnpm para que los flujos de trabajo de la terminal y las tareas de launchd funcionen de inmediato.
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 orientación de la primera ejecución separada de su conversación normal. Consulte Inicialización para obtener información sobre lo que sucede en el host de la puerta de enlace durante la primera ejecución del agente.