Saltar al contenido principal

Primeros pasos

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

Qué necesitas

  • Node.js — se recomienda Node 24 (también se admite Node 22.14+)
  • Una clave de API de un proveedor de modelos (Anthropic, OpenAI, Google, etc.) — la incorporación te la solicitará
Comprueba tu versión de Node con node --version. Usuarios de Windows: tanto Windows nativo como WSL2 son compatibles. WSL2 es más estable y se recomienda para la experiencia completa. Consulta Windows. ¿Necesitas instalar Node? Consulta Configuración de Node.

Configuración rápida

1

Instalar OpenClaw

curl -fsSL https://openclaw.ai/install.sh | bash
Proceso del script de instalación
Otros métodos de instalación (Docker, Nix, npm): Instalación.
2

Ejecutar la incorporación

openclaw onboard --install-daemon
El asistente te guía para elegir un proveedor de modelos, establecer una clave de API y configurar la Gateway. Tarda unos 2 minutos.Consulta Incorporación (CLI) para la referencia completa.
3

Verificar que la Gateway está en ejecución

openclaw gateway status
Deberías ver que la Gateway está escuchando en el puerto 18789.
4

Abrir el panel

openclaw dashboard
Esto abre la IU de control en tu navegador. Si carga, todo está funcionando.
5

Enviar tu primer mensaje

Escribe un mensaje en el chat de la IU de control y deberías recibir una respuesta de la IA.¿Quieres chatear desde tu teléfono? El canal más rápido de configurar es Telegram (solo se necesita un token de bot). Consulta Canales para ver todas las opciones.
Si mantienes una compilación localizada o personalizada del panel, dirige gateway.controlUi.root a un directorio que contenga tus recursos estáticos compilados y index.html.
mkdir -p "$HOME/.openclaw/control-ui-custom"
# Copia tus archivos estáticos compilados en ese directorio.
Luego establece:
{
  "gateway": {
    "controlUi": {
      "enabled": true,
      "root": "$HOME/.openclaw/control-ui-custom"
    }
  }
}
Reinicia la 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 la Gateway

Modelos, herramientas, sandbox y configuraciones avanzadas.

Explorar herramientas

Navegador, exec, búsqueda web, Skills y plugins.
Si ejecutas OpenClaw como una cuenta de servicio o quieres rutas personalizadas:
  • OPENCLAW_HOME — directorio principal para la resolución interna de rutas
  • OPENCLAW_STATE_DIR — reemplaza el directorio de estado
  • OPENCLAW_CONFIG_PATH — reemplaza la ruta del archivo de configuración
Referencia completa: Variables de entorno.