OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

First steps

Primeros pasos

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

Lo que necesitas

  • Node.js 22.19+, 23.11+ o 24+ (24 es la opción predeterminada recomendada)
  • Una clave de API de un proveedor de modelos (Anthropic, OpenAI, Google, etc.); la incorporación te la solicitará

Configuración rápida

  • Instalar OpenClaw

    macOS / Linux

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

    Proceso del script de instalación

    Windows (PowerShell)

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

  • Ejecutar la incorporación

    bash
    openclaw onboard --install-daemon

    El asistente te guía para elegir un proveedor de modelos, establecer una clave de API y configurar el Gateway. QuickStart normalmente solo tarda unos minutos, pero el inicio de sesión con el proveedor, la vinculación de canales, la instalación del daemon, las descargas de red, las 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) para obtener la referencia completa.

  • Verificar que el Gateway esté en ejecución

    bash
    openclaw gateway status

    Deberías ver que el Gateway está escuchando en el puerto 18789.

  • Abrir el panel

    bash
    openclaw dashboard

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

  • Enviar tu primer mensaje

    Escribe un mensaje en el chat de la interfaz de control y deberías recibir una respuesta de la IA.

    ¿Prefieres conversar desde tu teléfono? El canal más rápido de configurar es Telegram (solo necesitas 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, configura gateway.controlUi.root para que apunte a un directorio que contenga tus recursos estáticos compilados y index.html.

    bash
    mkdir -p "$HOME/.openclaw/control-ui-custom"# Copia tus archivos estáticos compilados en ese directorio.

    A continuación, configura:

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

    Reinicia el Gateway y vuelve a abrir el panel:

    bash
    openclaw gateway restartopenclaw dashboard

    Qué hacer a continuación

    Conectar un canal

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

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

    Modelos, herramientas, entorno aislado y configuración avanzada.
    Explorar herramientas

    Navegador, ejecución, búsqueda web, Skills y plugins.
    Avanzado: variables de entorno

    Si ejecutas OpenClaw como una cuenta de servicio o quieres usar 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.

    Contenido relacionado

    Was this useful?
    On this page

    On this page