> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Primeros pasos

Instala OpenClaw, ejecuta la incorporación y chatea con tu asistente de IA en unos 5
minutos. Al final tendrás un Gateway en ejecución, autenticación configurada y una
sesión de chat funcional.

## Lo que necesitas

* **Node.js 22.19+, 23.11+ o 24+** (24 es el valor predeterminado recomendado)
* **Una clave de API** de un proveedor de modelos (Anthropic, OpenAI, Google, etc.); la incorporación te la pedirá

<Tip>
  Comprueba tu versión de Node con `node --version`.
  **Usuarios de Windows:** la app nativa Windows Hub es la ruta de escritorio más sencilla. También se admiten las rutas del instalador de PowerShell y del Gateway en WSL2. Consulta [Windows](/es/platforms/windows).
  ¿Necesitas instalar Node? Consulta [Configuración de Node](/es/install/node).
</Tip>

## Configuración rápida

<Steps>
  <Step title="Instalar OpenClaw">
    <Tabs>
      <Tab title="macOS / Linux">
        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        curl -fsSL https://openclaw.ai/install.sh | bash
        ```

        <img src="https://mintcdn.com/clawdhub/U8jr7qEbUc9OU9YR/assets/install-script.svg?fit=max&auto=format&n=U8jr7qEbUc9OU9YR&q=85&s=50706f81e3210a610262f14facb11f65" alt="Proceso del script de instalación" className="rounded-lg" width="1370" height="581" data-path="assets/install-script.svg" />
      </Tab>

      <Tab title="Windows (PowerShell)">
        ```powershell theme={"theme":{"light":"min-light","dark":"min-dark"}}
        iwr -useb https://openclaw.ai/install.ps1 | iex
        ```
      </Tab>
    </Tabs>

    <Note>
      Otros métodos de instalación (Docker, Nix, npm): [Instalación](/es/install).
    </Note>
  </Step>

  <Step title="Ejecutar la incorporación">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw onboard --install-daemon
    ```

    El asistente te guía para elegir un proveedor de modelos, configurar una clave de API
    y configurar el Gateway. QuickStart suele tomar solo unos minutos, pero
    el inicio de sesión del proveedor, el emparejamiento de canales, la instalación del daemon, las descargas de red, Skills
    o los plugins opcionales pueden hacer que la incorporación completa tarde más. Omite los pasos
    opcionales y vuelve más tarde con `openclaw configure`.

    Consulta [Incorporación (CLI)](/es/start/wizard) para ver la referencia completa.
  </Step>

  <Step title="Verificar que el Gateway está en ejecución">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw gateway status
    ```

    Deberías ver el Gateway escuchando en el puerto 18789.
  </Step>

  <Step title="Abrir el panel">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw dashboard
    ```

    Esto abre la Control UI en tu navegador. Si carga, todo funciona.
  </Step>

  <Step title="Enviar tu primer mensaje">
    Escribe un mensaje en el chat de la Control UI y deberías recibir una respuesta de IA.

    ¿Quieres chatear desde tu teléfono en su lugar? El canal más rápido de configurar es
    [Telegram](/es/channels/telegram) (solo un token de bot). Consulta [Canales](/es/channels)
    para ver todas las opciones.
  </Step>
</Steps>

<Accordion title="Avanzado: montar una compilación personalizada de la Control UI">
  Si mantienes una compilación localizada o personalizada del panel, apunta
  `gateway.controlUi.root` a un directorio que contenga tus recursos estáticos
  compilados y `index.html`.

  ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
  mkdir -p "$HOME/.openclaw/control-ui-custom"
  # Copy your built static files into that directory.
  ```

  Luego configura:

  ```json theme={"theme":{"light":"min-light","dark":"min-dark"}}
  {
    "gateway": {
      "controlUi": {
        "enabled": true,
        "root": "$HOME/.openclaw/control-ui-custom"
      }
    }
  }
  ```

  Reinicia el Gateway y vuelve a abrir el panel:

  ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
  openclaw gateway restart
  openclaw dashboard
  ```
</Accordion>

## Qué hacer a continuación

<Columns>
  <Card title="Conectar un canal" href="/es/channels" icon="message-square">
    Discord, Feishu, iMessage, Matrix, Microsoft Teams, Signal, Slack, Telegram, WhatsApp, Zalo y más.
  </Card>

  <Card title="Emparejamiento y seguridad" href="/es/channels/pairing" icon="shield">
    Controla quién puede enviar mensajes a tu agente.
  </Card>

  <Card title="Configurar el Gateway" href="/es/gateway/configuration" icon="settings">
    Modelos, herramientas, sandbox y configuración avanzada.
  </Card>

  <Card title="Explorar herramientas" href="/es/tools" icon="wrench">
    Navegador, exec, búsqueda web, Skills y plugins.
  </Card>
</Columns>

<Accordion title="Avanzado: variables de entorno">
  Si ejecutas OpenClaw como una cuenta de servicio o quieres rutas personalizadas:

  * `OPENCLAW_HOME` — directorio de inicio para la resolución de rutas internas
  * `OPENCLAW_STATE_DIR` — sobrescribe el directorio de estado
  * `OPENCLAW_CONFIG_PATH` — sobrescribe la ruta del archivo de configuración

  Referencia completa: [Variables de entorno](/es/help/environment).
</Accordion>

## Relacionado

* [Resumen de instalación](/es/install)
* [Resumen de canales](/es/channels)
* [Configuración](/es/start/setup)