Incorporación (CLI)

CLI onboarding es la ruta de configuración de terminal recomendada para OpenClaw en macOS, Linux o Windows. Los usuarios de escritorio de Windows también pueden empezar con Windows Hub. Configura un Gateway local o una conexión a un Gateway remoto, además de canales, Skills y valores predeterminados del espacio de trabajo en un único flujo guiado.

openclaw onboard

Inicio rápido suele tomar solo unos minutos, pero la incorporación completa puede tardar más cuando el inicio de sesión del proveedor, el emparejamiento de canales, la instalación del daemon, las descargas de red, Skills o plugins opcionales requieren configuración adicional. El asistente muestra esta cronología por adelantado, y los pasos opcionales se pueden omitir y retomar más tarde con openclaw configure.

Configuración regional

El asistente de la CLI localiza el texto fijo de incorporación. Resuelve la configuración regional desde OPENCLAW_LOCALE, luego LC_ALL, luego LC_MESSAGES, luego LANG, y usa inglés como alternativa. Las configuraciones regionales compatibles del asistente son en, zh-CN y zh-TW.

OPENCLAW_LOCALE=zh-CN openclaw onboard

Los nombres e identificadores estables permanecen literales: OpenClaw, Gateway, Tailscale, comandos, claves de configuración, URL, ID de proveedores, ID de modelos y etiquetas de plugin/canal no se traducen.

Para reconfigurar más tarde:

openclaw configureopenclaw agents add <name>

Inicio rápido frente a avanzado

La incorporación empieza con Inicio rápido (valores predeterminados) frente a Avanzado (control total).

Qué configura la incorporación

El modo local (predeterminado) te guía por estos pasos:

1. Modelo/autenticación — elige cualquier proveedor/flujo de autenticación compatible (clave de API, OAuth o autenticación manual específica del proveedor), incluido Proveedor personalizado (compatible con OpenAI, compatible con Anthropic o detección automática desconocida). Elige un modelo predeterminado. Nota de seguridad: si este agente ejecutará herramientas o procesará contenido de Webhook/hooks, prefiere el modelo de última generación más potente disponible y mantén estricta la política de herramientas. Los niveles más débiles/antiguos son más fáciles de manipular mediante inyección de prompts. Para ejecuciones no interactivas, --secret-input-mode ref almacena referencias respaldadas por variables de entorno en perfiles de autenticación en lugar de valores de claves de API en texto plano. En modo ref no interactivo, la variable de entorno del proveedor debe estar definida; pasar flags de clave en línea sin esa variable de entorno falla de inmediato. En ejecuciones interactivas, elegir el modo de referencia secreta te permite apuntar a una variable de entorno o a una referencia de proveedor configurada (file o exec), con una validación preliminar rápida antes de guardar. Para Anthropic, la incorporación/configuración interactiva ofrece Anthropic Claude CLI como ruta local preferida y clave de API de Anthropic como ruta recomendada para producción. Anthropic setup-token también sigue disponible como ruta compatible de autenticación con token.
2. Espacio de trabajo — ubicación para archivos del agente (valor predeterminado ~/.openclaw/workspace). Siembra archivos de arranque.
3. Gateway — puerto, dirección de enlace, modo de autenticación, exposición con Tailscale. En modo de token interactivo, elige el almacenamiento predeterminado de token en texto plano u opta por SecretRef. Ruta SecretRef de token no interactiva: --gateway-token-ref-env <ENV_VAR>.
4. Canales — canales de chat integrados y de plugins oficiales como iMessage, Discord, Feishu, Google Chat, Mattermost, Microsoft Teams, QQ Bot, Signal, Slack, Telegram, WhatsApp y más.
5. Daemon — instala un LaunchAgent (macOS), una unidad de usuario systemd (Linux/WSL2) o una tarea programada nativa de Windows con alternativa por usuario en la carpeta de inicio. Si la autenticación con token requiere un token y gateway.auth.token está administrado por SecretRef, la instalación del daemon lo valida pero no persiste el token resuelto en los metadatos de entorno del servicio supervisor. Si la autenticación con token requiere un token y la SecretRef de token configurada no se resuelve, la instalación del daemon se bloquea con orientación accionable. Si tanto gateway.auth.token como gateway.auth.password están configurados y gateway.auth.mode no está definido, la instalación del daemon se bloquea hasta que el modo se defina explícitamente.
6. Comprobación de estado — inicia el Gateway y verifica que se esté ejecutando.
7. Skills — instala Skills recomendadas y dependencias opcionales.

El modo remoto solo configura el cliente local para conectarse a un Gateway en otro lugar. No instala ni cambia nada en el host remoto.

Añadir otro agente

Usa openclaw agents add <name> para crear un agente separado con su propio espacio de trabajo, sesiones y perfiles de autenticación. Ejecutarlo sin --workspace inicia la incorporación.

Lo que define:

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

Notas:

• Los espacios de trabajo predeterminados siguen ~/.openclaw/workspace-<agentId>.
• Añade bindings para enrutar mensajes entrantes (la incorporación puede hacerlo).
• Flags no interactivos: --model, --agent-dir, --bind, --non-interactive.

Referencia completa

Para desgloses detallados paso a paso y salidas de configuración, consulta Referencia de configuración por CLI. Para ejemplos no interactivos, consulta Automatización de CLI. Para la referencia técnica más profunda, incluidos detalles de RPC, consulta Referencia de incorporación.

Documentación relacionada

• Referencia de comandos de CLI: openclaw onboard
• Descripción general de incorporación: Descripción general de incorporación
• Incorporación de la app macOS: Incorporación
• Ritual de primer inicio del agente: Arranque del agente