Configura OpenClaw en minutos con el CLI Onboarding Wizard

Configurar agentes de IA desde cero suele ser un proceso lento y lleno de errores manuales. Entre gestionar claves de API, configurar Gateways y conectar canales de mensajería, es fácil perder el hilo de lo que realmente importa: crear algo útil.

Si estás cansado de editar archivos de configuración interminables y quieres una base sólida para tu proyecto sin fricciones, el asistente de OpenClaw es lo que necesitas.

Requisitos previos

• Un sistema operativo compatible: macOS, Linux o Windows (vía WSL2).
• Acceso a la terminal de tu sistema.

Inicio rápido

El onboarding wizard es la forma recomendada de preparar tu entorno. Configura un Gateway local o remoto, canales, skills y los valores por defecto de tu workspace en un solo flujo guiado.

Para empezar, ejecuta:

openclaw onboard

Si quieres chatear de inmediato sin configurar canales, usa la Control UI ejecutando:

openclaw dashboard

Opciones de configuración

El asistente te permite elegir entre dos caminos:

• QuickStart (defaults): Configura un Gateway local en el puerto 18789 con autenticación por Token generada automáticamente. Aplica el perfil de herramientas tools.profile: "coding" y configura el aislamiento de mensajes para Telegram y WhatsApp mediante una allowlist.
• Advanced (full control): Te permite gestionar cada paso manualmente, incluyendo el modo, workspace, Gateway, canales, daemon y skills.

Si necesitas hacer cambios más tarde, puedes usar estos comandos:

openclaw configure
openclaw agents add <name>

Nota: Usar el flag --json no activa el modo no-interactivo. Para scripts, utiliza siempre --non-interactive.

Cómo funciona el asistente

Cuando eliges el Local mode (por defecto), el wizard sigue estos pasos:

1. Model/Auth: Seleccionas tu proveedor (OpenAI, Anthropic o Custom) y el modelo. Puedes usar claves de API o SecretRef para mayor seguridad.
2. Workspace: Define dónde se guardarán los archivos del agente (por defecto ~/.openclaw/workspace).
3. Gateway: Configura el puerto, la dirección de escucha y si quieres exponerlo mediante Tailscale.
4. Channels: Conecta con WhatsApp, Telegram, Discord, Google Chat, Mattermost, Signal, BlueBubbles o iMessage.
5. Daemon: Instala un LaunchAgent en macOS o una unidad de systemd en Linux/WSL2 para que el servicio corra de fondo.
6. Health check: Inicia el Gateway y verifica que todo funcione correctamente.
7. Skills: Instala las herramientas recomendadas y sus dependencias.

Añadir más agentes

Para crear un agente separado con su propio workspace y perfiles de autenticación, usa:

openclaw agents add <name>

Este comando configura automáticamente:

• El nombre en agents.list[].name.
• La ruta en agents.list[].workspace.
• El directorio agents.list[].agentDir.
• Los bindings para el enrutamiento de mensajes.

Solución de problemas

• Configuración inválida: Si el asistente detecta claves antiguas o errores en el archivo de configuración, te pedirá que ejecutes openclaw doctor antes de continuar.
• Problemas con el Daemon: La instalación del daemon se detendrá si la autenticación por token requiere un SecretRef que no se puede resolver. También se bloqueará si gateway.auth.token y gateway.auth.password están configurados al mismo tiempo sin un modo explícito.
• Resetear ajustes: Re-ejecutar el wizard no borra tus datos. Si quieres empezar de cero, usa openclaw onboard --reset. Para incluir el workspace en el borrado, usa --reset-scope full.

¿Tienes dudas específicas sobre la configuración? Prueba nuestro AI Setup Assistant.

Próximos pasos

• CLI Onboarding Reference
• Web tools configuration
• Agent Bootstrapping
• Wizard Full Reference