First steps
Incorporación (aplicación de macOS)
Este documento describe el flujo de configuración de primera ejecución actual. El objetivo es una experiencia de "día 0" fluida: elegir dónde se ejecuta el Gateway, conectar la autenticación, ejecutar el asistente y dejar que el agente se inicialice por sí mismo. Para obtener una descripción general de las rutas de incorporación, consulta Descripción general de la incorporación.
Aprobar advertencia de macOS
Aprobar búsqueda de redes locales
Bienvenida y aviso de seguridad
Modelo de confianza de seguridad:
- De forma predeterminada, OpenClaw es un agente personal: un límite de operador de confianza.
- Las configuraciones compartidas/multiusuario requieren bloqueo estricto (separar límites de confianza, mantener el acceso a herramientas al mínimo y seguir Seguridad).
- La incorporación local ahora establece de forma predeterminada las configuraciones nuevas en
tools.profile: "coding"para que las configuraciones locales nuevas mantengan las herramientas de sistema de archivos/tiempo de ejecución sin forzar el perfilfullsin restricciones. - Si los hooks/webhooks u otras fuentes de contenido no confiables están habilitados, usa un nivel de modelo moderno y potente, y mantén una política de herramientas/sandboxing estricta.
Local vs. remoto
¿Dónde se ejecuta el Gateway?
- Este Mac (solo local): la incorporación puede configurar la autenticación y escribir credenciales localmente.
- Remoto (por SSH/Tailnet): la incorporación no configura la autenticación local;
las credenciales deben existir en el host del gateway. El campo de token del gateway remoto
almacena el token usado por la app de macOS para conectarse a ese Gateway; los valores
gateway.remote.tokenno en texto plano existentes se conservan hasta que los reemplaces. - Configurar más tarde: omitir la configuración y dejar la app sin configurar.
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
Chat de incorporación (sesión dedicada)
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 de primera ejecución separada de tu conversación normal. Consulta Inicialización para ver qué ocurre en el host del gateway durante la primera ejecución del agente.
