Configura tu entorno con openclaw onboard

Configurar herramientas de desarrollo suele ser un proceso manual y tedioso. Te pasas el tiempo editando archivos JSON a mano, buscando dónde quedaron las API keys o intentando que un servicio se mantenga activo después de cerrar la terminal. El comando openclaw onboard elimina esa fricción automatizando el flujo inicial para que puedas enfocarte en construir.

Requisitos previos

Para completar la configuración, asegúrate de tener lo siguiente:

• Una suscripción de OpenAI Code, una API key de Anthropic o un setup token.
• Node.js (recomendado y obligatorio para WhatsApp y Telegram).
• Java 21 (solo si usas builds de Signal basadas en JVM).
• Acceso a sudo (opcional, para habilitar el linger en Linux).

Inicio rápido

Sigue estos pasos para tener tu entorno listo en menos de 5 minutos:

1. Inicia el asistente: Ejecuta openclaw onboard en tu terminal para iniciar el modo Local.
2. Gestiona tu configuración: Si el asistente detecta un archivo en ~/.openclaw/openclaw.json, elige entre Keep, Modify o Reset.
3. Configura el modelo: Selecciona tu proveedor. Recomendamos usar Anthropic API key para una configuración más directa.
4. Prepara el Workspace: El asistente creará los archivos necesarios en ~/.openclaw/workspace por defecto.
5. Configura el Gateway: Elige el puerto y bind. Mantén activa la autenticación por token incluso en loopback para proteger tus clientes locales.
6. Vincula tus Channels: Configura Telegram, Discord o WhatsApp (vía QR). Si usas Signal en Windows, asegúrate de tener WSL2 activo.
7. Instala el Daemon: Configura LaunchAgent (macOS) o systemd (Linux) para que el Gateway se inicie automáticamente.
8. Verifica la salud: El asistente ejecutará openclaw health al finalizar para confirmar que todo funciona.

Solución de problemas

• Configuración inválida o keys antiguas: Si el asistente se detiene por errores en el archivo JSON, ejecuta openclaw doctor para limpiar la configuración antes de reintentar.
• Bloqueos en el Daemon de macOS: Al usar Anthropic OAuth, selecciona “Always Allow” en el Keychain para que launchd pueda acceder a las credenciales sin intervención manual.
• Entornos sin GUI: Si el asistente no detecta una interfaz gráfica, imprimirá instrucciones de SSH port-forward para que accedas a la Control UI desde otra máquina.
• Errores en el Gateway: Usa el comando openclaw status --deep para obtener un diagnóstico detallado que incluya las sondas de salud del Gateway.

Si necesitas ayuda personalizada durante el proceso, consulta el AI Setup Assistant.

Próximos pasos

• Onboarding Wizard (CLI)
• CLI Automation
• Command reference: openclaw onboard
• Agent workspace