Primeros pasos
Descripción general de la incorporación
OpenClaw dispone de incorporación mediante terminal y mediante la aplicación para macOS. Ambas establecen primero la inferencia: detectan el acceso existente a la IA, requieren una respuesta en vivo y solo entonces inician OpenClaw para configurar el resto. Un Gateway accesible y configurado, cuyo agente predeterminado ya tenga un modelo configurado, omite la incorporación y abre la interfaz normal del agente. El flujo de terminal también ofrece el asistente clásico completo para una configuración detallada.
¿Qué opción debería utilizar?
| Incorporación mediante CLI | Incorporación mediante la aplicación para macOS | |
|---|---|---|
| Plataformas | macOS, Linux, Windows (nativo o WSL2) | Solo macOS |
| Interfaz | Configuración de inferencia y luego OpenClaw | Configuración de inferencia y luego OpenClaw |
| Ideal para | Servidores, sistemas sin interfaz gráfica, control total | Mac de escritorio, configuración visual |
| Automatización | --non-interactive para scripts |
Solo manual |
| Comando | openclaw onboard |
Iniciar la aplicación |
La mayoría de los usuarios debería comenzar con la incorporación mediante CLI: funciona en todas partes y ofrece el máximo control.
Qué configura la incorporación
La fase guiada de inferencia solo establece:
- Proveedor del modelo y autenticación: acceso detectado o inicio de sesión verificado en un proveedor, clave de API o token
- Inferencia verificada: una respuesta real con el modelo efectivo del agente predeterminado
Una vez superada esa respuesta, OpenClaw puede configurar el espacio de trabajo, el Gateway, el servicio Gateway, los canales, los agentes, los plugins y otras funciones opcionales.
El asistente clásico de la CLI también puede configurar:
- Canales (opcional): canales de chat integrados y agrupados, como Discord, Feishu, Google Chat, iMessage, Mattermost, Microsoft Teams, Telegram, WhatsApp y otros
- Controles avanzados del Gateway: modo remoto, ajustes de red y opciones del daemon
Incorporación mediante CLI
Ejecute en cualquier terminal:
openclaw onboardEl flujo guiado detecta el acceso existente a la IA, prueba en vivo los candidatos por orden
y continúa con el siguiente si se produce un fallo. Si se agotan las opciones detectadas, muestra primero OpenAI,
Anthropic, xAI (Grok), Google y OpenRouter. Más… contiene los
proveedores restantes agrupados por proveedor, con regiones, planes y métodos compatibles
mediante navegador, dispositivo, clave de API o token en un segundo menú. Guarda el modelo
y la credencial solo después de obtener una respuesta correcta y, a continuación, inicia OpenClaw para
configurar el espacio de trabajo, el Gateway, los canales, los agentes, los plugins y otras funciones
opcionales. Omitir por ahora sale sin iniciar OpenClaw. No existe
una transición al asistente clásico dentro del flujo; salga y ejecute openclaw onboard --classic cuando prefiera
utilizar el asistente clásico.
Una vez superada la inferencia, OpenClaw puede transferir la configuración de canales a un asistente
de terminal con entrada enmascarada. No abre la configuración guiada ni clásica del proveedor; salga de OpenClaw y
ejecute openclaw onboard para cambiar el proveedor del modelo o su autenticación.
Utilice openclaw onboard --classic para configurar detalladamente el modelo y la autenticación, los canales, las Skills,
el Gateway remoto o la importación. Añadir --install-daemon también selecciona el
flujo clásico e instala el servicio en segundo plano en un solo paso. Utilice openclaw openclaw para la configuración y reparación conversacionales no relacionadas con la inferencia. openclaw onboard --modern es un alias de compatibilidad que utiliza la misma
comprobación de inferencia en vivo.
Referencia completa: Incorporación (CLI)
Documentación del comando de la CLI: openclaw onboard
Incorporación mediante la aplicación para macOS
Abra la aplicación OpenClaw. Si el Gateway local o remoto configurado es accesible y el agente predeterminado ya tiene un modelo configurado, la aplicación omite la incorporación y OpenClaw, y abre inmediatamente la interfaz normal del agente.
En un Gateway nuevo o incompleto, el flujo de primera ejecución detecta el acceso existente a la IA (Claude Code, Codex o claves de API), prueba en vivo la mejor opción y la guarda solo después de recibir una respuesta real; recurre automáticamente a otras opciones y ofrece un paso manual verificado para introducir una clave de API cuando no encuentra ninguna. Las credenciales confidenciales utilizan entrada enmascarada. Una vez superada la inferencia, OpenClaw se inicia y ayuda a configurar el resto.
Gemini CLI sigue disponible para los agentes normales después de la configuración, pero no se ofrece para esta comprobación de inferencia porque no permite exigir una prueba sin herramientas.
Referencia completa: Incorporación (aplicación para macOS)
Proveedores personalizados o no incluidos
Si su proveedor no aparece en la lista, ejecute openclaw onboard --classic, elija
Proveedor personalizado e introduzca:
- Compatibilidad del endpoint: compatible con OpenAI (
/chat/completions), compatible con OpenAI Responses (/responses), compatible con Anthropic (/messages) o desconocida (prueba las tres opciones y la detecta automáticamente) - URL base y clave de API (la clave de API es opcional si el endpoint no la requiere)
- ID del modelo y alias opcional del modelo
Pueden coexistir varios endpoints personalizados; cada uno recibe su propio ID de endpoint.
