Incorporación
Flujo de incorporación de primera ejecución para la aplicación OpenClaw macOS.
Este documento describe el flujo de incorporación de **primera ejecución actual**. El objetivo es una experiencia fluida del "Día 0": elegir dónde se ejecuta el Gateway, autenticarse, ejecutar el asistente y dejar que el Agente se inicialice automáticamente.
Orden de Páginas (Actual)
1. Bienvenida + Nota de Seguridad
2. **Selección de Gateway** (Local / Remoto / Configurar Después)
3. **Autenticación (Anthropic OAuth)** — Solo modo local
4. **Asistente de Configuración** (Impulsado por el Gateway)
5. **Permisos** (Alertas de autorización TCC)
6. **CLI** (Opcional)
7. **Chat de Incorporación** (Sesión dedicada)
8. Finalizado
1) Bienvenida + Nota de Seguridad
Lee las notas de seguridad mostradas y decide si proceder en consecuencia.
2) Local vs Remoto
¿Dónde se está ejecutando el **Gateway**?
- **Local (Este Mac):** La incorporación puede ejecutar el flujo OAuth y escribir credenciales localmente.
- **Remoto (vía SSH/Tailnet):** La incorporación **no** ejecutará OAuth localmente; las credenciales ya deben existir en el host del gateway.
- **Configurar Después:** Omitir configuración y dejar la aplicación sin configurar.
Consejos de Autenticación del Gateway:
- Ahora incluso loopback requiere un **token** generado por el asistente, así que los clientes WS locales también deben autenticarse.
- Si desactivas la autenticación, cualquier proceso local puede conectarse; solo usa esto en máquinas de confianza total.
- Usa un **token** para acceso multi-máquina o enlaces que no sean loopback.
3) Autenticación para Modo Solo Local (Anthropic OAuth)
La aplicación macOS soporta Anthropic OAuth (Claude Pro/Max). El flujo es el siguiente:
- Abrir navegador para OAuth (PKCE)
- Pedir al usuario que pegue el valor `code#state`
- Escribir credenciales en `~/.openclaw/credentials/oauth.json`
Otros proveedores (OpenAI, API Personalizada) se configuran actualmente mediante variables de entorno o archivos de configuración.
4) Asistente de Configuración (Impulsado por el Gateway)
La aplicación puede ejecutar el mismo asistente de configuración que la CLI. Esto mantiene la incorporación consistente con el comportamiento del Gateway y evita duplicar lógica en SwiftUI.
5) Permisos
La incorporación solicitará permisos TCC requeridos por OpenClaw, incluyendo:
- Notificaciones
- Accesibilidad
- Grabación de Pantalla
- Micrófono / Reconocimiento de Voz
- Automatización (AppleScript)
6) CLI (Opcional)
La aplicación puede instalar la CLI global `openclaw` vía npm/pnpm, haciendo que los flujos de trabajo de terminal y tareas launchd funcionen de inmediato.
7) Chat de Incorporación (Sesión Dedicada)
Después de completar la configuración, la aplicación abre una sesión de chat de incorporación dedicada donde el Agente se presenta y guía los siguientes pasos. Esto separa la guía de primera ejecución de las conversaciones diarias.
Ceremonia de Inicialización del Agente
Al ejecutar el Agente por primera vez, OpenClaw inicializa un espacio de trabajo (predeterminado en `~/.openclaw/workspace`):
- Genera `AGENTS.md`, `BOOTSTRAP.md`, `IDENTITY.md`, `USER.md`
- Realiza una ceremonia corta de preguntas y respuestas (una pregunta a la vez)
- Escribe identidad y preferencias en `IDENTITY.md`, `USER.md`, `SOUL.md`
- Elimina `BOOTSTRAP.md` al completar para asegurar que solo se ejecute una vez
Opcional: Hooks de Gmail (Manual)
Gmail Pub/Sub todavía requiere configuración manual por ahora. Usa:
openclaw webhooks gmail setup --account [email protected]
Ver /automation/gmail-pubsub para más detalles.
Notas sobre Modo Remoto
Cuando el Gateway se ejecuta en otra máquina, las credenciales y archivos del espacio de trabajo se encuentran en **ese host**. Si necesitas usar OAuth en modo remoto, crea lo siguiente en el host del gateway:
- `~/.openclaw/credentials/oauth.json`
- `<code2>~/.openclaw/agents/<agentId>/agent/auth-profiles.json</code2>`