English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

First steps

Primeros pasos

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

Lo que necesitas

  • Node.js — se recomienda Node 24 (también se admite Node 22.16+)
  • Una clave de API de un proveedor de modelos (Anthropic, OpenAI, Google, etc.) — la incorporación te la pedirá

Configuración rápida

  • Instalar OpenClaw

    macOS / Linux

    curl -fsSL https://openclaw.ai/install.sh | bash

    Proceso del script de instalación

    Windows (PowerShell)

    iwr -useb https://openclaw.ai/install.ps1 | iex

  • Ejecutar la incorporación

    openclaw onboard --install-daemon

    El asistente te guía para elegir un proveedor de modelos, configurar una clave de API y configurar el Gateway. Tarda unos 2 minutos.

    Consulta Incorporación (CLI) para ver la referencia completa.

  • Verificar que el Gateway esté en ejecución

    openclaw gateway status

    Deberías ver que el Gateway escucha en el puerto 18789.

  • Abrir el panel

    openclaw dashboard

    Esto abre la interfaz de control en tu navegador. Si carga, todo funciona.

  • Enviar tu primer mensaje

    Escribe un mensaje en el chat de la interfaz de control 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 (solo un token de bot). Consulta Canales para ver todas las opciones.

    • Avanzado: montar una compilación personalizada de la interfaz de control

    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.

    mkdir -p "$HOME/.openclaw/control-ui-custom"
# Copy your built static files into that directory.

    Luego configura:

    {
"gateway": {
  "controlUi": {
    "enabled": true,
    "root": "$HOME/.openclaw/control-ui-custom"
  }
}
}

    Reinicia el Gateway y vuelve a abrir el panel:

    openclaw gateway restart
openclaw dashboard

    Qué hacer después

    Conectar un canal

    Discord, Feishu, iMessage, Matrix, Microsoft Teams, Signal, Slack, Telegram, WhatsApp, Zalo y más.
    Emparejamiento y seguridad

    Controla quién puede enviar mensajes a tu agente.
    Configurar el Gateway

    Modelos, herramientas, sandbox y configuración avanzada.
    Explorar herramientas

    Navegador, exec, búsqueda web, Skills y plugins.
    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 interna de rutas
    • OPENCLAW_STATE_DIR — sobrescribe el directorio de estado
    • OPENCLAW_CONFIG_PATH — sobrescribe la ruta del archivo de configuración

    Referencia completa: Variables de entorno.

    Relacionado