--- read_when: - Necesita información detallada sobre el comportamiento de `openclaw onboard` - Estás depurando resultados de incorporación o integrando clientes de incorporación sidebarTitle: CLI reference summary: Referencia completa del flujo de configuración de la CLI, configuración de autenticación/modelo, salidas e internals title: Referencia de configuración de la CLI x-i18n: generated_at: "2026-07-04T06:22:30Z" model: gpt-5.5 postprocess_version: locale-links-v1 provider: openai source_hash: 016ea0c85cefd5cc70d0988e82f2cbb5898c0ae3134f68df645dddb58c2dfe9a source_path: start/wizard-cli-reference.md workflow: 16 --- Esta página es la referencia completa para `openclaw onboard`. Para la guía breve, consulta [Incorporación (CLI)](/es/start/wizard). ## Qué hace el asistente El modo local (predeterminado) te guía por: - Configuración de modelo y autenticación (OAuth de suscripción de OpenAI Code, CLI o clave de API de Anthropic Claude, además de opciones de MiniMax, GLM, Ollama, Moonshot, StepFun y AI Gateway) - Ubicación del espacio de trabajo y archivos de arranque - Configuración de Gateway (puerto, enlace, autenticación, Tailscale) - Canales y proveedores (Telegram, WhatsApp, Discord, Google Chat, Mattermost, Signal, iMessage y otros plugins de canal incluidos) - Instalación del daemon (LaunchAgent, unidad de usuario systemd o tarea programada nativa de Windows con alternativa de carpeta de inicio) - Comprobación de estado - Configuración de Skills El modo remoto configura esta máquina para conectarse a un gateway en otra ubicación. No instala ni modifica nada en el host remoto. ## Detalles del flujo local - Si `~/.openclaw/openclaw.json` existe, elige Mantener, Modificar o Restablecer. - Volver a ejecutar el asistente no borra nada a menos que elijas explícitamente Restablecer (o pases `--reset`). - CLI `--reset` usa `config+creds+sessions` de forma predeterminada; usa `--reset-scope full` para eliminar también el espacio de trabajo. - Si la configuración no es válida o contiene claves heredadas, el asistente se detiene y te pide ejecutar `openclaw doctor` antes de continuar. - Restablecer usa `trash` y ofrece ámbitos: - Solo configuración - Configuración + credenciales + sesiones - Restablecimiento completo (también elimina el espacio de trabajo) - La matriz completa de opciones está en [Opciones de autenticación y modelo](#auth-and-model-options). - Predeterminado: `~/.openclaw/workspace` (configurable). - Siembra los archivos del espacio de trabajo necesarios para el ritual de arranque de primera ejecución. - Diseño del espacio de trabajo: [Espacio de trabajo del agente](/es/concepts/agent-workspace). - Solicita puerto, enlace, modo de autenticación y exposición de Tailscale. - Recomendado: mantén la autenticación con token activada incluso para loopback, para que los clientes WS locales deban autenticarse. - En modo token, la configuración interactiva ofrece: - **Generar/almacenar token en texto plano** (predeterminado) - **Usar SecretRef** (opcional) - En modo contraseña, la configuración interactiva también admite almacenamiento en texto plano o SecretRef. - Ruta no interactiva de SecretRef de token: `--gateway-token-ref-env `. - Requiere una variable de entorno no vacía en el entorno del proceso de incorporación. - No se puede combinar con `--gateway-token`. - Desactiva la autenticación solo si confías plenamente en todos los procesos locales. - Los enlaces que no son loopback siguen requiriendo autenticación. - [WhatsApp](/es/channels/whatsapp): inicio de sesión QR opcional - [Telegram](/es/channels/telegram): token de bot - [Discord](/es/channels/discord): token de bot - [Google Chat](/es/channels/googlechat): JSON de cuenta de servicio + audiencia de Webhook - [Mattermost](/es/channels/mattermost): token de bot + URL base - [Signal](/es/channels/signal): instalación opcional de `signal-cli` + configuración de cuenta - [iMessage](/es/channels/imessage): ruta de CLI `imsg` + acceso a la base de datos de Messages; usa un contenedor SSH cuando el Gateway se ejecute fuera de Mac - Seguridad de DM: el valor predeterminado es el emparejamiento. El primer DM envía un código; apruébalo mediante `openclaw pairing approve ` o usa listas de permitidos. - macOS: LaunchAgent - Requiere una sesión de usuario iniciada; para entornos sin interfaz, usa un LaunchDaemon personalizado (no incluido). - Linux y Windows mediante WSL2: unidad de usuario systemd - El asistente intenta `loginctl enable-linger ` para que el gateway permanezca activo después de cerrar sesión. - Puede solicitar sudo (escribe en `/var/lib/systemd/linger`); primero lo intenta sin sudo. - Windows nativo: primero, tarea programada - Si se deniega la creación de la tarea, OpenClaw recurre a un elemento de inicio de sesión por usuario en la carpeta de inicio e inicia el gateway inmediatamente. - Las tareas programadas siguen siendo preferibles porque ofrecen mejor estado de supervisión. - Selección de runtime: Node (recomendado; requerido para WhatsApp y Telegram). Bun no está recomendado. - Inicia el gateway (si es necesario) y ejecuta `openclaw health`. - `openclaw status --deep` agrega la sonda de estado del gateway en vivo a la salida de estado, incluidas las sondas de canales cuando se admiten. - Lee las skills disponibles y comprueba los requisitos. - Te permite elegir el gestor de node: npm, pnpm o bun. - Instala dependencias opcionales para skills incluidas de confianza cuando el instalador requerido está disponible. - Omite los instaladores de Homebrew, uv y Go no disponibles, y luego agrupa las skills afectadas con orientación de configuración manual. Ejecuta `openclaw doctor` después de instalar los prerrequisitos faltantes. - Resumen y próximos pasos, incluidas las opciones de aplicaciones para iOS, Android y macOS. Si no se detecta ninguna GUI, el asistente imprime instrucciones de reenvío de puertos SSH para la Control UI en lugar de abrir un navegador. Si faltan los recursos de la Control UI, el asistente intenta compilarlos; la alternativa es `pnpm ui:build` (instala automáticamente las dependencias de la UI). ## Detalles del modo remoto El modo remoto configura esta máquina para conectarse a un gateway en otra ubicación. El modo remoto no instala ni modifica nada en el host remoto. Lo que configuras: - URL del gateway remoto (`ws://...`) - Token si el gateway remoto requiere autenticación (recomendado) - Si el gateway es solo loopback, usa tunelización SSH o una tailnet. - Sugerencias de descubrimiento: - macOS: Bonjour (`dns-sd`) - Linux: Avahi (`avahi-browse`) ## Opciones de autenticación y modelo Usa `ANTHROPIC_API_KEY` si está presente o solicita una clave, y luego la guarda para uso del daemon. Flujo del navegador; pega `code#state`. Establece `agents.defaults.model` en `openai/gpt-5.5` mediante el runtime de Codex cuando el modelo no está configurado o ya pertenece a la familia OpenAI. Flujo de emparejamiento del navegador con un código de dispositivo de corta duración. Establece `agents.defaults.model` en `openai/gpt-5.5` mediante el runtime de Codex cuando el modelo no está configurado o ya pertenece a la familia OpenAI. Usa `OPENAI_API_KEY` si está presente o solicita una clave, y luego almacena la credencial en perfiles de autenticación. Establece `agents.defaults.model` en `openai/gpt-5.5` cuando el modelo no está configurado, es `openai/*` o son referencias de modelo Codex heredadas. Inicio de sesión en el navegador para cuentas SuperGrok o X Premium elegibles. Esta es la ruta xAI recomendada para la mayoría de los usuarios. OpenClaw almacena el perfil de autenticación resultante para modelos Grok, Grok `web_search`, `x_search` y `code_execution`. Inicio de sesión en el navegador compatible con remoto mediante un código corto en lugar de una devolución de llamada de localhost. Úsalo desde hosts SSH, Docker o VPS. Solicita `XAI_API_KEY` y configura xAI como proveedor de modelos. Úsalo cuando quieras una clave de API de xAI Console en lugar de OAuth de suscripción. Solicita `OPENCODE_API_KEY` (o `OPENCODE_ZEN_API_KEY`) y te permite elegir el catálogo Zen o Go. URL de configuración: [opencode.ai/auth](https://opencode.ai/auth). Almacena la clave por ti. Solicita `AI_GATEWAY_API_KEY`. Más detalles: [Vercel AI Gateway](/es/providers/vercel-ai-gateway). Solicita el ID de cuenta, el ID de gateway y `CLOUDFLARE_AI_GATEWAY_API_KEY`. Más detalles: [Cloudflare AI Gateway](/es/providers/cloudflare-ai-gateway). La configuración se escribe automáticamente. El valor predeterminado alojado es `MiniMax-M3`; la configuración con clave de API usa `minimax/...`, y la configuración con OAuth usa `minimax-portal/...`. Más detalles: [MiniMax](/es/providers/minimax). La configuración se escribe automáticamente para StepFun estándar o Step Plan en endpoints de China o globales. Actualmente, Estándar incluye `step-3.5-flash`, y Step Plan también incluye `step-3.5-flash-2603`. Más detalles: [StepFun](/es/providers/stepfun). Solicita `SYNTHETIC_API_KEY`. Más detalles: [Synthetic](/es/providers/synthetic). Primero solicita `Cloud + Local`, `Cloud only` o `Local only`. `Cloud only` usa `OLLAMA_API_KEY` con `https://ollama.com`. Los modos respaldados por host solicitan la URL base (predeterminada `http://127.0.0.1:11434`), descubren los modelos disponibles y sugieren valores predeterminados. `Cloud + Local` también comprueba si ese host de Ollama ha iniciado sesión para acceso a la nube. Más detalles: [Ollama](/es/providers/ollama). Las configuraciones de Moonshot (Kimi K2) y Kimi Coding se escriben automáticamente. Más detalles: [Moonshot AI (Kimi + Kimi Coding)](/es/providers/moonshot). Funciona con endpoints compatibles con OpenAI y compatibles con Anthropic. La incorporación interactiva admite las mismas opciones de almacenamiento de clave de API que otros flujos de clave de API de proveedor: - **Pegar clave de API ahora** (texto plano) - **Usar referencia secreta** (referencia de entorno o referencia de proveedor configurada, con validación previa) Flags no interactivos: - `--auth-choice custom-api-key` - `--custom-base-url` - `--custom-model-id` - `--custom-api-key` (opcional; recurre a `CUSTOM_API_KEY`) - `--custom-provider-id` (opcional) - `--custom-compatibility ` (opcional; predeterminado `openai`) - `--custom-image-input` / `--custom-text-input` (opcional; reemplaza la capacidad de entrada del modelo inferida) Deja la autenticación sin configurar. Comportamiento del modelo: - Elige el modelo predeterminado de las opciones detectadas, o introduce el proveedor y el modelo manualmente. - La incorporación de proveedor personalizado infiere la compatibilidad con imágenes para ID de modelo comunes y solo pregunta cuando se desconoce el nombre del modelo. - Cuando la incorporación empieza desde una opción de autenticación de proveedor, el selector de modelo prefiere ese proveedor automáticamente. Para Volcengine y BytePlus, la misma preferencia también coincide con sus variantes de plan de codificación (`volcengine-plan/*`, `byteplus-plan/*`). - Si ese filtro de proveedor preferido quedara vacío, el selector vuelve al catálogo completo en lugar de no mostrar modelos. - El asistente ejecuta una comprobación de modelo y advierte si el modelo configurado es desconocido o no tiene autenticación. Rutas de credenciales y perfiles: - Perfiles de autenticación (claves de API + OAuth): `~/.openclaw/agents//agent/auth-profiles.json` - Importación de OAuth heredada: `~/.openclaw/credentials/oauth.json` Modo de almacenamiento de credenciales: - El comportamiento de incorporación predeterminado conserva las claves de API como valores de texto plano en los perfiles de autenticación. - `--secret-input-mode ref` habilita el modo de referencia en lugar del almacenamiento de claves en texto plano. En la configuración interactiva, puedes elegir: - referencia de variable de entorno (por ejemplo `keyRef: { source: "env", provider: "default", id: "OPENAI_API_KEY" }`) - referencia de proveedor configurado (`file` o `exec`) con alias de proveedor + id - El modo de referencia interactivo ejecuta una validación preliminar rápida antes de guardar. - Referencias de entorno: valida el nombre de la variable + un valor no vacío en el entorno de incorporación actual. - Referencias de proveedor: valida la configuración del proveedor y resuelve el id solicitado. - Si la validación preliminar falla, la incorporación muestra el error y te permite reintentarlo. - En modo no interactivo, `--secret-input-mode ref` solo está respaldado por entorno. - Define la variable de entorno del proveedor en el entorno del proceso de incorporación. - Las marcas de clave en línea (por ejemplo `--openai-api-key`) requieren que esa variable de entorno esté definida; de lo contrario, la incorporación falla de inmediato. - Para proveedores personalizados, el modo `ref` no interactivo almacena `models.providers..apiKey` como `{ source: "env", provider: "default", id: "CUSTOM_API_KEY" }`. - En ese caso de proveedor personalizado, `--custom-api-key` requiere que `CUSTOM_API_KEY` esté definida; de lo contrario, la incorporación falla de inmediato. - Las credenciales de autenticación de Gateway admiten opciones de texto plano y SecretRef en la configuración interactiva: - Modo de token: **Generar/almacenar token en texto plano** (predeterminado) o **Usar SecretRef**. - Modo de contraseña: texto plano o SecretRef. - Ruta de SecretRef de token no interactiva: `--gateway-token-ref-env `. - Las configuraciones existentes con texto plano siguen funcionando sin cambios. Consejo para headless y servidores: completa OAuth en una máquina con navegador y luego copia el `auth-profiles.json` de ese agente (por ejemplo `~/.openclaw/agents//agent/auth-profiles.json`, o la ruta correspondiente `$OPENCLAW_STATE_DIR/...`) al host del Gateway. `credentials/oauth.json` es solo una fuente de importación heredada. ## Salidas e internos Campos habituales en `~/.openclaw/openclaw.json`: - `agents.defaults.workspace` - `agents.defaults.skipBootstrap` cuando se pasa `--skip-bootstrap` - `agents.defaults.model` / `models.providers` (si se elige Minimax) - `tools.profile` (la incorporación local usa `"coding"` de forma predeterminada cuando no está definido; los valores explícitos existentes se conservan) - `gateway.*` (modo, enlace, autenticación, tailscale) - `session.dmScope` (la incorporación local usa `per-channel-peer` de forma predeterminada cuando no está definido; los valores explícitos existentes se conservan) - `channels.telegram.botToken`, `channels.discord.token`, `channels.matrix.*`, `channels.signal.*`, `channels.imessage.*` - Listas de permitidos de canales (Slack, Discord, Matrix, Microsoft Teams) cuando aceptas durante los avisos (los nombres se resuelven a ID cuando es posible) - `skills.install.nodeManager` - La marca `setup --node-manager` acepta `npm`, `pnpm` o `bun`. - La configuración manual aún puede definir `skills.install.nodeManager: "yarn"` más adelante. - `wizard.lastRunAt` - `wizard.lastRunVersion` - `wizard.lastRunCommit` - `wizard.lastRunCommand` - `wizard.lastRunMode` - `wizard.securityAcknowledgedAt` `openclaw agents add` escribe `agents.list[]` y `bindings` opcionales. Las credenciales de WhatsApp van en `~/.openclaw/credentials/whatsapp//`. Las sesiones se almacenan en `~/.openclaw/agents//sessions/`. Algunos canales se entregan como plugins. Cuando se seleccionan durante la configuración, el asistente solicita instalar el plugin (npm o ruta local) antes de configurar el canal. RPC del asistente de Gateway: - `wizard.start` - `wizard.next` - `wizard.cancel` - `wizard.status` Los clientes (app de macOS y Control UI) pueden renderizar pasos sin volver a implementar la lógica de incorporación. Comportamiento de configuración de Signal: - Descarga el recurso de lanzamiento apropiado - Lo almacena en `~/.openclaw/tools/signal-cli//` - Escribe `channels.signal.cliPath` en la configuración - Las compilaciones JVM requieren Java 21 - Las compilaciones nativas se usan cuando están disponibles - Windows usa WSL2 y sigue el flujo de signal-cli de Linux dentro de WSL ## Documentos relacionados - Centro de incorporación: [Incorporación (CLI)](/es/start/wizard) - Automatización y scripts: [Automatización de CLI](/es/start/wizard-cli-automation) - Referencia de comandos: [`openclaw onboard`](/es/cli/onboard)