---
read_when:
    - Ejecutar o configurar la incorporación de la CLI
    - Configurar una máquina nueva
sidebarTitle: 'Onboarding: CLI'
summary: 'Incorporación de CLI: configuración guiada para Gateway, espacio de trabajo, canales y Skills'
title: Incorporación (CLI)
x-i18n:
    generated_at: "2026-05-11T20:54:21Z"
    model: gpt-5.5
    provider: openai
    source_hash: 6d8093f2375240f7a784b22c97c824a49b4d39b9217c0d1c0a1490bb15160700
    source_path: start/wizard.md
    workflow: 16
---

La incorporación por CLI es la forma **recomendada** de configurar OpenClaw en macOS,
Linux o Windows (mediante WSL2; muy recomendado).
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.

```bash
openclaw onboard
```

<Info>
Primer chat más rápido: abre la interfaz de control (no se necesita configurar canales). Ejecuta
`openclaw dashboard` y chatea en el navegador. Documentación: [Dashboard](/es/web/dashboard).
</Info>

Para reconfigurar más tarde:

```bash
openclaw configure
openclaw agents add <name>
```

<Note>
`--json` no implica modo no interactivo. Para scripts, usa `--non-interactive`.
</Note>

<Tip>
La incorporación por CLI incluye un paso de búsqueda web donde puedes elegir un proveedor
como Brave, DuckDuckGo, Exa, Firecrawl, Gemini, Grok, Kimi, MiniMax Search,
Ollama Web Search, Perplexity, SearXNG o Tavily. Algunos proveedores requieren una
clave de API, mientras que otros no requieren clave. También puedes configurarlo más tarde con
`openclaw configure --section web`. Documentación: [Herramientas web](/es/tools/web).
</Tip>

## QuickStart vs Advanced

La incorporación comienza con **QuickStart** (valores predeterminados) vs **Advanced** (control total).

<Tabs>
  <Tab title="QuickStart (valores predeterminados)">
    - Gateway local (loopback)
    - Valor predeterminado del espacio de trabajo (o espacio de trabajo existente)
    - Puerto del Gateway **18789**
    - Autenticación del Gateway **Token** (generado automáticamente, incluso en loopback)
    - Valor predeterminado de la política de herramientas para nuevas configuraciones locales: `tools.profile: "coding"` (se conserva el perfil explícito existente)
    - Valor predeterminado de aislamiento de DM: la incorporación local escribe `session.dmScope: "per-channel-peer"` cuando no está establecido. Detalles: [Referencia de configuración por CLI](/es/start/wizard-cli-reference#outputs-and-internals)
    - Exposición de Tailscale **desactivada**
    - Los DM de Telegram + WhatsApp usan **lista de permitidos** de forma predeterminada (se te pedirá tu número de teléfono)

  </Tab>
  <Tab title="Advanced (control total)">
    - Expone cada paso (modo, espacio de trabajo, gateway, canales, daemon, Skills).

  </Tab>
</Tabs>

## Qué configura la incorporación

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

1. **Modelo/Auth** — elige cualquier proveedor/flujo de autenticación compatible (clave de API, OAuth o autenticación manual específica del proveedor), incluido Custom Provider
   (compatible con OpenAI, compatible con Anthropic o detección automática Unknown). 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 inyectar mediante 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 clave de API en texto plano.
   En modo `ref` no interactivo, la variable de entorno del proveedor debe estar establecida; 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 previa rápida antes de guardar.
   Para Anthropic, la incorporación/configuración interactiva ofrece **Anthropic Claude CLI** como la ruta local preferida y **clave de API de Anthropic** como la ruta recomendada para producción. Anthropic setup-token también sigue disponible como ruta compatible de autenticación por token.
2. **Espacio de trabajo** — ubicación para los archivos del agente (predeterminado `~/.openclaw/workspace`). Siembra archivos de arranque.
3. **Gateway** — puerto, dirección de enlace, modo de autenticación, exposición de Tailscale.
   En modo token interactivo, elige almacenamiento de token en texto plano predeterminado u opta por SecretRef.
   Ruta SecretRef de token no interactiva: `--gateway-token-ref-env <ENV_VAR>`.
4. **Canales** — canales de chat incorporados y empaquetados 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 de carpeta Startup por usuario.
   Si la autenticación por token requiere un token y `gateway.auth.token` está gestionado por SecretRef, la instalación del daemon lo valida pero no persiste el token resuelto en los metadatos del entorno del servicio supervisor.
   Si la autenticación por token requiere un token y el SecretRef de token configurado no se puede resolver, la instalación del daemon se bloquea con orientación accionable.
   Si `gateway.auth.token` y `gateway.auth.password` están configurados y `gateway.auth.mode` no está establecido, la instalación del daemon se bloquea hasta que el modo se establezca explícitamente.
6. **Comprobación de estado** — inicia el Gateway y verifica que esté en ejecución.
7. **Skills** — instala Skills recomendadas y dependencias opcionales.

<Note>
Volver a ejecutar la incorporación **no** borra nada a menos que elijas explícitamente **Reset** (o pases `--reset`).
CLI `--reset` se aplica de forma predeterminada a configuración, credenciales y sesiones; usa `--reset-scope full` para incluir el espacio de trabajo.
Si la configuración no es válida o contiene claves heredadas, la incorporación te pide que ejecutes `openclaw doctor` primero.
</Note>

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 independiente con su propio espacio de trabajo,
sesiones y perfiles de autenticación. Ejecutarlo sin `--workspace` inicia la incorporación.

Qué establece:

- `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](/es/start/wizard-cli-reference).
Para ejemplos no interactivos, consulta [Automatización de CLI](/es/start/wizard-cli-automation).
Para la referencia técnica más profunda, incluidos los detalles de RPC, consulta
[Referencia de incorporación](/es/reference/wizard).

## Documentación relacionada

- Referencia de comandos de CLI: [`openclaw onboard`](/es/cli/onboard)
- Resumen de incorporación: [Resumen de incorporación](/es/start/onboarding-overview)
- Incorporación de la app de macOS: [Incorporación](/es/start/onboarding)
- Ritual de primera ejecución del agente: [Arranque del agente](/es/start/bootstrapping)