Onboarding
A first run does not open the wizard. OpenCrabs goes straight to the chat, with its built-in provider already provisioned and the agent greeting you. The onboarding wizard is opt-in: run opencrabs --onboard, or /onboard from inside a session.
Los vídeos guiados están en la página Vídeos de onboarding.
Inicio Rápido (3 minutos)
La vía rápida te permite chatear con el agente en menos de 3 minutos.
| Paso | Acción |
|---|---|
| 1. Modo | Pulsa Enter en QuickStart |
| 2. Workspace | Pulsa Enter para aceptar la ruta por defecto |
| 3. Proveedor | Usa las flechas para ir a tu proveedor (por ejemplo z.ai) y pulsa Enter. Usa la flecha abajo para elegir un plan (por ejemplo Coding) y pulsa Enter |
| 4. API Key | Pega tu clave (Cmd+V / Ctrl+V / Cmd+Shift+V / Ctrl+Shift+V) y pulsa Enter. La lista de modelos se carga en vivo |
| 5. Modelo | Usa las flechas para ir a tu modelo (por ejemplo gemini-2.5-pro) y pulsa Enter |
| 6. Daemon | Usa las flechas para elegir si quieres ejecutarlo como daemon en segundo plano y pulsa Enter |
| 7. Vibe Check | Todas las comprobaciones deben mostrar ✅. Pulsa Enter |
| 8. Sobre ti | Escribe algo sobre ti. Cuanto más sepa el agente, mejor. Pulsa Enter |
| 9. Sobre el agente | Escribe algo sobre la personalidad del agente. Pulsa Enter |
| 10. Chat | Ya estás dentro. Empieza a hablar con tu agente |
Configuración avanzada (7 minutos)
Configuración completa con Telegram, voz local, visión y generación de imágenes.
| Paso | Acción |
|---|---|
| 1. Modo | Pulsa Enter en QuickStart |
| 2. Workspace | Pulsa Enter para aceptar la ruta por defecto |
| 3. Proveedor | Usa las flechas para ir a tu proveedor (por ejemplo z.ai) y pulsa Enter. Usa la flecha abajo para elegir un plan y pulsa Enter |
| 4. API Key | Pega tu clave y pulsa Enter. La lista de modelos se carga en vivo |
| 5. Modelo | Usa las flechas para ir a tu modelo y pulsa Enter |
| 6. Channels | Usa las flechas para ir a Other, pulsa Space para seleccionar Telegram y pulsa Enter. Pega el token de tu bot, sigue las instrucciones para obtener tu chat ID y pulsa Enter. Elige el modo de mención y pulsa Enter. Cuando diga Connected, pulsa Enter de nuevo. Usa la flecha abajo para ir a Continue y pulsa Enter |
| 7. STT | Selecciona Local y pulsa Enter. Elige el tamaño del modelo (por ejemplo tiny para mayor velocidad) y pulsa Enter |
| 8. TTS | Vuelve a seleccionar Local y pulsa Enter. Elige una voz (por ejemplo Ryan) y pulsa Enter. Espera a que termine la descarga del modelo, usa la flecha abajo para ir a Continue y pulsa Enter |
| 9. Image | Pulsa Space para seleccionar Vision y Image Generation y pulsa Enter. Pega tu clave de API de Gemini y pulsa Enter |
| 10. Daemon | Usa las flechas para elegir si quieres ejecutarlo como daemon en segundo plano y pulsa Enter |
| 11. Vibe Check | Todas las comprobaciones deben mostrar ✅. Pulsa Enter |
| 12. Sobre ti | Escribe algo sobre ti. Cuanto más sepa el agente, mejor. Pulsa Enter |
| 13. Sobre el agente | Escribe algo sobre la personalidad del agente. Pulsa Enter |
| 14. Chat | Ya estás dentro. Empieza a hablar con tu agente |
Flujo de onboarding
El asistente es una TUI controlada con el teclado y tiene 8 pasos. Navega con las flechas, usa Tab para avanzar y Esc para volver.
| Paso | Pantalla | Qué haces |
|---|---|---|
| 1 | Selección de modo | Elige QuickStart (omite los channels) o Advanced |
| 2 | Workspace | Elige un directorio de trabajo para las operaciones con archivos |
| 3 | Proveedor y autenticación | Selecciona el proveedor → pega la clave de API → elige el modelo (se obtiene en vivo) |
| 4 | Channels | Space para activar o desactivar cada channel → Enter en cada uno para configurarlo |
| 5 | Voz | Proveedor de STT (Groq, Whisper local o desactivado) + voz de TTS |
| 6 | Imagen | Activación de Vision + modelo de generación + clave de API |
| 7 | Daemon | Instala el daemon en segundo plano (opcional) |
| 8 | Brain Setup | Genera SOUL.md automáticamente a partir de tu perfil |
Configuración de channels (paso 4)
La pantalla de channels muestra 5 integraciones: Telegram, Discord, WhatsApp, Slack y Trello.
Spaceactiva o desactiva un channelEnteren un channel activado abre su pantalla de configuración (token, IDs, listas de permitidos)Enteren Continue oTabpasa al siguiente paso- Cada pantalla de configuración de channels tiene un botón Test Connection
Consulta Channels Overview para ver la guía de navegación completa.
Volver a ejecutar la configuración
Puedes ir a cualquier paso sin volver a ejecutar el asistente completo:
| Comando | Paso |
|---|---|
/onboard | Asistente completo |
/onboard:provider | Selección de proveedor y modelo |
/onboard:channels | Selector de channels |
/onboard:voice | Configuración de voz |
/onboard:image | Configuración de imagen |
/onboard:brain | Generación de archivos de brain |
Al terminar el onboarding, tu agente se inicia y se presenta. Lee sus archivos de brain (SOUL.md, AGENTS.md, TOOLS.md) y empieza una conversación.
Bootstrap
En la primera ejecución, el agente pasa por una fase de bootstrap:
- Te conoce (nombre, preferencias, forma de trabajar)
- Define su identidad (nombre, personalidad, emoji)
- Abre
SOUL.mdcontigo para hablar de sus valores - Configura
USER.mdcon tu perfil
El archivo de bootstrap (BOOTSTRAP.md) se elimina solo al completarse.
Migrar desde otra herramienta
¿Ya usas ClaudeCode, OpenClaw, Hermes u otro arnés de agente de IA? Tu agente puede migrar tus datos existentes (memoria, skills, comandos personalizados, preferencias) a sus propios archivos de brain usando lenguaje natural. No necesitas mover archivos a mano.
Funciona con cualquier agente o arnés de programación que guarde su configuración en local. La migración busca en tu sistema de archivos los directorios de configuración de la otra herramienta, lee su contenido y lo convierte al formato de archivos de brain de OpenCrabs (SOUL.md, USER.md, TOOLS.md, MEMORY.md, AGENTS.md, CODE.md).
Migración guiada
Si quieres revisar qué se migra antes de que ocurra:
Busca en local mis datos de ClaudeCode/OpenClaw/Hermes (o de cualquier otro arnés de agente que haya usado) y audita una migración a nuestros propios archivos de brain. Informa cuando termine y ejecútala cuando yo confirme y apruebe.
El agente:
- Busca en tu sistema de archivos los directorios de configuración de la otra herramienta
- Lee y analiza todos los archivos relevantes (memoria, comandos, skills, preferencias)
- Genera una auditoría que muestra exactamente qué se asigna a dónde
- Espera tu confirmación
- Ejecuta la migración e informa de un desglose completo
Migración autónoma
Si solo quieres que se haga:
Busca en local mis datos existentes de agentes o arneses y migra todo a nuestros propios archivos de brain, sin necesidad de mi aprobación. Adelante: planifica y ejecuta, e informa cuando termine con un desglose completo.
El agente omite el paso de auditoría, planifica la migración internamente, la ejecuta y te entrega un resumen de todo lo que se movió.
Qué se asigna
| Fuente | Destino | Ejemplo |
|---|---|---|
| Memoria / CLAUDE.md / archivos de contexto | MEMORY.md | Decisiones del proyecto, contexto previo |
| Comandos personalizados | commands.toml | Comandos slash y sus definiciones |
| Skills / instrucciones del agente | AGENTS.md, TOOLS.md | Reglas de flujo de trabajo, configuraciones de herramientas |
| Preferencias / perfil del usuario | USER.md | Nombre, zona horaria, estilo de programación |
| Estándares de código / reglas de linting | CODE.md | Guías de estilo, convenciones |
Consejo: Ejecuta la migración justo después del onboarding, mientras el contexto está fresco. El agente ya tiene tu
USER.mdy tuSOUL.mddel asistente, así que puede combinarlos de forma inteligente en lugar de sobrescribirlos.
Comandos principales
| Comando | Descripción |
|---|---|
/help | Muestra todos los comandos disponibles |
/models | Cambia de proveedor o de modelo |
/new | Crea una nueva session |
/sessions | Cambia entre sessions |
/cd | Cambia el directorio de trabajo |
/compact | Compacta el contexto manualmente |
/evolve | Descarga la última versión |
/rebuild | Compila desde el código fuente |
/approve | Define la política de aprobación |
Modos de aprobación
Controla cuánta autonomía tiene el agente:
| Modo | Comportamiento |
|---|---|
/approve | Pregunta antes de cada uso de herramienta (por defecto) |
/approve auto | Aprueba automáticamente en esta session |
/approve yolo | Aprueba siempre automáticamente (se mantiene) |
Directorio de trabajo
El agente opera dentro de un directorio de trabajo para las operaciones con archivos. Cámbialo con:
- Comando
/cden el chat - Selector de directorios en la TUI (Tab para seleccionar)
- Herramienta
config_manager set_working_directory
El directorio de trabajo se guarda por session. Al cambiar de session, el directorio se restaura automáticamente.
Pista de filtro de modelos (v0.3.78)
El selector de modelos del onboarding ahora siempre muestra una pista de filtro encima de la lista de modelos (“Type to filter…”). Antes, la pista solo aparecía después de empezar a escribir, así que los usuarios no sabían que había filtrado. Además, un ID de modelo escrito exactamente ahora tiene prioridad sobre una coincidencia parcial: si escribes claude-opus-4-8 exactamente, selecciona ese modelo aunque otros modelos contengan la misma subcadena.