Incorporación de la App macOS

Descripción General

Esta guía describe la experiencia de incorporación del primer inicio de la aplicación macOS de Clawdbot, cubriendo la configuración desde el lanzamiento inicial hasta el arranque del agente.

Flujo de Configuración

La incorporación sigue 8 pasos:

Paso 1: Bienvenida

Pantalla de bienvenida inicial con aviso de seguridad sobre las capacidades de Clawdbot.

Paso 2: Selección de Gateway

Elige tu modo de Gateway:

Paso 3: Autenticación

Para configuraciones locales, autentícate con tu proveedor de IA:

• Anthropic OAuth - Para suscriptores de Claude Pro/Max
• Anthropic API Key - Acceso directo a la API
• OpenAI - Modelos GPT
• Otros Proveedores - Varias opciones

El flujo OAuth abre tu navegador para autenticación PKCE. Pega el valor código/estado cuando se te solicite.

Credenciales almacenadas en: ~/.clawdbot/credentials/oauth.json

Paso 4: Asistente de Configuración

Configuración guiada por Gateway para:

• Configuración de puerto y red
• Integraciones de canales
• Instalación de habilidades

Paso 5: Permisos

macOS requiere concesiones explícitas de permisos:

Concede permisos según se solicite. Algunas funciones requieren permisos específicos para funcionar.

Paso 6: Instalación de CLI

Instalación opcional del comando global clawdbot:

# Instalado en /usr/local/bin/clawdbot
clawdbot --version

Paso 7: Chat de Incorporación

Una sesión dedicada para la introducción del agente:

• El agente crea el espacio de trabajo (~/.clawdbot/workspace)
• Inicializa archivos iniciales: AGENTS.md, BOOTSTRAP.md, IDENTITY.md, USER.md
• Realiza preguntas y respuestas para personalizar tu experiencia
• Aprende tus preferencias y casos de uso

Paso 8: Listo

Configuración completa. Ahora puedes:

• Chatear con tu asistente
• Configurar canales adicionales
• Instalar habilidades
• Personalizar tu espacio de trabajo

Modos de Gateway

Modo Local

• Gateway se ejecuta en tu Mac
• Los flujos OAuth funcionan directamente
• Credenciales almacenadas localmente
• Mejor para uso personal

Modo Remoto

Cuando uses un Gateway remoto:

• Todas las credenciales residen en el host del Gateway
• Los archivos del espacio de trabajo están en la máquina remota
• El Mac local actúa solo como cliente
• Útil para despliegues compartidos o en servidor

Arranque del Agente

En el primer inicio, el agente:

1. Crea el directorio del espacio de trabajo
2. Inicializa archivos de instrucciones
3. Realiza Q&A de personalización
4. Configura preferencias iniciales

Archivos de Arranque

Solución de Problemas

Problemas de Permisos

Si las funciones no funcionan:

1. Abre Preferencias del Sistema → Privacidad y Seguridad
2. Verifica cada categoría de permisos
3. Asegúrate de que Clawdbot esté habilitado
4. Reinicia la app si es necesario

Fallos de OAuth

Si la autenticación falla:

1. Verifica tu conexión a internet
2. Confirma el estado de tu suscripción
3. Intenta ingresar la API key manualmente
4. Revisa ~/.clawdbot/credentials/ por problemas

El Gateway No Inicia

1. Verifica si el puerto 18789 está disponible
2. Revisa los logs en /tmp/clawdbot/
3. Intenta clawdbot health desde la terminal

Próximos Pasos

• Guía de Configuración - Configuración detallada
• Construir un Asistente - Crea tu asistente
• Canales - Conectar plataformas de mensajería