Incorporación (CLI)

openclaw onboard

La incorporación mediante la CLI es la ruta recomendada para la configuración desde el terminal en macOS, Linux y Windows (nativo o WSL2). De forma predeterminada, detecta el acceso a IA ya disponible en el equipo, lo verifica con una finalización real e inicia Crestodian para configurar el espacio de trabajo, el Gateway y las funciones opcionales. openclaw setup ejecuta el mismo flujo (Configuración abarca la variante --baseline que solo configura). Los usuarios de escritorio de Windows también pueden comenzar desde Windows Hub.

La incorporación guiada establece primero la inferencia. Detecta el acceso a IA disponible, exige una finalización real y solo entonces inicia Crestodian para configurar el resto de OpenClaw. Elegir Skip for now finaliza la incorporación sin iniciar Crestodian.

El asistente clásico sigue disponible para proveedores personalizados, la configuración de un Gateway remoto, la vinculación de canales, los controles del demonio, Skills y las importaciones. Ejecútelo explícitamente con openclaw onboard --classic; el selector de inferencia guiado no delega en él. Una vez superada la inferencia, Crestodian puede usar open channel wizard for <channel> para transferir la configuración de canales que requiere secretos a un asistente de terminal con datos ocultos. Para cambiar el proveedor del modelo o su autenticación, salga de Crestodian y ejecute openclaw onboard; Crestodian no abre los flujos de proveedores guiados ni clásicos.

Configuración regional

El asistente localiza los textos fijos de incorporación. Orden de resolución: OPENCLAW_LOCALE, LC_ALL, LC_MESSAGES, LANG y, por último, inglés. Configuraciones regionales compatibles: en, zh-CN, zh-TW.

OPENCLAW_LOCALE=zh-CN openclaw onboard

Los nombres de productos, comandos, claves de configuración, URL, identificadores de proveedores, identificadores de modelos y etiquetas de plugins y canales permanecen en inglés independientemente de la configuración regional.

Para volver a configurar más adelante los ajustes no relacionados con la inferencia:

openclaw configureopenclaw agents add <name>

Flujo guiado predeterminado

La ejecución simple de openclaw onboard sigue esta ruta:

1. Acepte el aviso de seguridad.
2. Detecte los modelos configurados, las variables de entorno de claves de API y las CLI de IA locales compatibles.
3. Pruebe el primer candidato detectado con una finalización real. Si falla, muestre el motivo y continúe con el siguiente candidato utilizable.
4. Si se agotan las opciones detectadas, elija OpenAI, Anthropic, xAI (Grok), Google u OpenRouter, o elija More… para ver los proveedores restantes. Las regiones, los planes y los métodos compatibles mediante navegador, dispositivo, clave de API o token de cada proveedor aparecen en un segundo menú y se prueban con la misma finalización real. Elija Skip for now para salir sin iniciar Crestodian.
5. Conserve únicamente la ruta del modelo verificada y cualquier estado de credenciales o plugins que requiera. La configuración del espacio de trabajo y del Gateway permanece intacta.
6. Inicie Crestodian con el modelo verificado para que pueda configurar el espacio de trabajo, el Gateway, los canales, los agentes, los plugins y el resto de la configuración opcional.

Al volver a ejecutar el comando en una instalación configurada, primero se prueba el modelo predeterminado actual, lo que convierte el flujo guiado en una comprobación y reparación. Una comprobación fallida nunca sustituye automáticamente el modelo configurado; la incorporación se detiene y pregunta cómo continuar. Ejecute openclaw channels add o openclaw configure para añadir posteriormente elementos no relacionados con la inferencia; use openclaw onboard para cambiar el proveedor o la ruta de autenticación.

Asistente clásico: QuickStart frente a Advanced

Ejecute openclaw onboard --classic para abrir el asistente completo. Comienza con una elección entre QuickStart (valores predeterminados) y Advanced (control total). Pase --flow quickstart o --flow advanced (alias manual) para seleccionar el flujo clásico y omitir esa pregunta.

El modo remoto (--mode remote) siempre utiliza el flujo avanzado; únicamente configura este equipo para conectarse a un Gateway ubicado en otro lugar y nunca instala ni cambia nada en el host remoto.

Qué configura la incorporación clásica

El modo local (predeterminado) recorre estos pasos:

1. Modelo/autenticación: elija un flujo de autenticación del proveedor (clave de API, OAuth o autenticación manual específica del proveedor), incluido un proveedor personalizado (compatible con OpenAI, compatible con OpenAI Responses, compatible con Anthropic o detección automática desconocida). Elija un modelo predeterminado. Una configuración nueva con clave de API de OpenAI utiliza de forma predeterminada openai/gpt-5.6 (el identificador básico de la API directa se resuelve como Sol); una configuración nueva de ChatGPT/Codex utiliza de forma predeterminada openai/gpt-5.6-sol. Al volver a ejecutar la configuración, se conserva cualquier modelo explícito existente, incluido openai/gpt-5.5. Seleccione openai/gpt-5.5 explícitamente si la cuenta no ofrece GPT-5.6. Nota de seguridad: si este agente va a ejecutar herramientas o procesar contenido de Webhook o enlaces, prefiera el modelo de última generación más potente disponible y mantenga una política de herramientas estricta; los niveles menos potentes o antiguos son más vulnerables a la inyección de instrucciones. En ejecuciones no interactivas, --secret-input-mode ref almacena referencias respaldadas por variables de entorno en lugar de valores de claves de API en texto sin formato; la variable de entorno referenciada ya debe estar definida o la incorporación falla inmediatamente. El modo interactivo de referencia de secretos puede apuntar a una variable de entorno o a una referencia de proveedor configurada (file o exec), con una comprobación preliminar rápida antes de guardar. Después de configurar el modelo y la autenticación, el asistente ofrece una prueba opcional de finalización en vivo; si falla, puede volver una vez a la configuración del modelo y la autenticación o ignorarse sin bloquear el resto del asistente clásico. Ignorarla no desbloquea Crestodian; la configuración conversacional sigue exigiendo una comprobación de inferencia satisfactoria.
2. Espacio de trabajo: directorio para los archivos del agente (valor predeterminado: ~/.openclaw/workspace). Crea los archivos de arranque iniciales.
3. Gateway: puerto, dirección de vinculación, modo de autenticación y exposición mediante Tailscale. En el modo interactivo con token, elija almacenar el token en texto sin formato (opción predeterminada) o utilizar una SecretRef. Ruta no interactiva de SecretRef: --gateway-token-ref-env <ENV_VAR>.
4. Canales: canales de chat integrados y de plugins oficiales, incluidos Discord, Feishu, Google Chat, iMessage, Mattermost, Microsoft Teams, QQ Bot, Signal, Slack, Telegram, WhatsApp y más.
5. Demonio: instala un LaunchAgent (macOS), una unidad de usuario de systemd (Linux/WSL2) o una tarea programada nativa de Windows con un mecanismo alternativo por usuario en la carpeta de inicio. Si se requiere autenticación mediante token y gateway.auth.token está gestionado mediante SecretRef, la instalación del demonio lo valida, pero no conserva un token resuelto en los metadatos del entorno del servicio supervisor; una SecretRef sin resolver bloquea la instalación y proporciona instrucciones. Si gateway.auth.token y gateway.auth.password están definidos mientras gateway.auth.mode no lo está, la instalación se bloquea hasta que se defina explícitamente el modo.
6. Comprobación de estado: inicia el Gateway y verifica que sea accesible.
7. Skills: instala las Skills recomendadas y sus dependencias opcionales.

--flow import ejecuta un flujo de migración detectado (por ejemplo, Hermes) en el asistente clásico en lugar de una configuración nueva; consulte Migración y las guías de migración en Instalación. openclaw onboard --modern es un alias de compatibilidad para Crestodian. Utiliza el mismo control de inferencia que openclaw crestodian: una inferencia verificada inicia el asistente, mientras que un fallo interactivo vuelve a la configuración guiada de inferencia.

Añadir otro agente

Use openclaw agents add <name> para crear un agente independiente con su propio espacio de trabajo, sesiones y perfiles de autenticación. Ejecutarlo sin --workspace inicia un flujo interactivo para el nombre, el espacio de trabajo, la autenticación, los canales y las vinculaciones; no es el asistente completo openclaw onboard.

Elementos que configura:

• agents.list[].name
• agents.list[].workspace
• agents.list[].agentDir

Notas:

• Espacio de trabajo predeterminado: ~/.openclaw/workspace-<agentId> (o dentro de agents.defaults.workspace si está definido).
• Añada bindings para dirigir los mensajes entrantes a este agente (la incorporación puede hacerlo automáticamente).
• Opciones no interactivas: --model, --agent-dir, --bind, --non-interactive.

Referencia completa

Para obtener información detallada paso a paso sobre el comportamiento y los resultados de configuración, consulte Referencia de configuración de la CLI. Para ver ejemplos no interactivos, consulte Automatización de la CLI. Para consultar la referencia completa de opciones, consulte openclaw onboard.

Documentación relacionada

• Referencia de comandos de la CLI: openclaw onboard
• Descripción general de la incorporación: Descripción general de la incorporación
• Incorporación en la aplicación para macOS: Incorporación
• Ritual de primera ejecución del agente: Arranque inicial del agente