Guía completa de instalación de OpenClaw: desde la preparación hasta la primera ejecución

2026-06-08 actualización: revisé en la documentación oficial de OpenClaw la versión de Node (v24 recomendada, mínimo v22.14+), el script de una línea y el flujo onboard, y añadí lecturas relacionadas de la misma serie. Los comandos y puertos siguen la documentación oficial.

La instalación de OpenClaw fue más sencilla de lo esperado: ya sea en Mac, Linux o Windows, seguir esta guía evita la mayoría de los problemas. Este artículo es para quienes no se sienten cómodos con la línea de comandos pero quieren probar: aquí está la experiencia de instalación, estructurada paso a paso.

Guía de “cría de langosta” de bajo costo: ArkClaw democratiza los agentes de IA

¿OpenClaw (la langosta) es potente pero la configuración resulta desalentadora? ArkClaw, de Volcano Engine de ByteDance, reduce la barrera al mínimo. Sin servidores ni configuración de tokens: un “asistente de IA 24 horas” capaz de controlar el navegador, ejecutar scripts y gestionar el calendario, con un solo clic.

El precio es realmente bajo: ¥9,9/mes; con mi código de invitación ZLKUK54M (regístrate aquí), solo ¥8,9. Desarrolladores: Coding Plan Pro incluye la oferta de forma gratuita.

¿Qué es OpenClaw?

Antes de instalar, aclaremos qué es OpenClaw. En resumen, es una plataforma de asistente de inteligencia artificial de código abierto que conecta grandes modelos de lenguaje como ChatGPT o Claude con tus herramientas de mensajería habituales: Telegram o WhatsApp, por ejemplo.

¿Por qué instalarlo localmente en lugar de usar la IA en el navegador?

Cada opción tiene sus ventajas. En local, puedes:

• Controlar tus datos y tu privacidad
• Personalizar funciones y habilidades
• Integrar la IA en tu flujo de trabajo
• Si te gusta experimentar, usar modelos locales sin depender de la nube

Para mí, lo más atractivo es conectar la IA a Telegram: basta con chatear a diario, sin hacer malabarismos entre aplicaciones.

Preparación: verifica tu sistema

OpenClaw es bastante flexible en cuanto a requisitos. Aun así, antes de empezar conviene confirmar algunos puntos.

Compatibilidad del sistema operativo

OpenClaw es compatible de forma nativa con macOS y Linux. En Windows, la documentación de instalación oficial cubre Windows nativo y WSL2; si vas a copiar los comandos de Linux de abajo, WSL2 suele ser lo más sencillo.

WSL2 ejecuta un entorno Linux ligero dentro de Windows. Para instalarlo, abre PowerShell y ejecuta:

wsl --install

Tras la instalación, reinicia el equipo y luego escribe wsl en PowerShell para entrar al entorno Linux.

Requisitos de hardware

OpenClaw no es exigente. Recomendaciones oficiales:

• Memoria: 8 GB es suficiente, 16 GB es mejor
• Almacenamiento: al menos 20 GB libres (un SSD mejora claramente la experiencia)

En la práctica, si tu PC ejecuta un navegador sin ralentizarse, OpenClaw funcionará bien. Yo uso un viejo MacBook de 8 GB, sin problema.

Entorno Node.js

Es el paso clave. OpenClaw está basado en Node.js: primero debes instalarlo. Según la documentación oficial: Node 24 recomendado, Node 22.14+ mínimo; el script de un clic avisa o ayuda si la versión es insuficiente.

Con nvm, instala 24 como versión actual de desarrollo.

Instalar Node.js en macOS

En Mac, Homebrew es lo más sencillo:

Vultr - Servidor cloud NVMe de alto rendimiento, 32 ubicaciones globales, despliegue Docker con un clic

Ver precios →Anuncio

# Si Homebrew aún no está instalado
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Luego instala Node.js
brew install node

Instalar Node.js en Linux

En Linux, recomiendo nvm (Node Version Manager) para cambiar de versión fácilmente:

# Instalar nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# Tras reiniciar la terminal, instala Node.js (24 recomendado)
nvm install 24
nvm use 24

Instalar Node.js en Windows (WSL2)

En WSL2, el método es el mismo que en Linux con nvm.

Luego verifica la versión:

node --version

Si ves v22.14+ o v24.x (recomendado), cumples con los requisitos oficiales actuales.

Gestor de paquetes: ¿npm o pnpm?

Node.js incluye npm (Node Package Manager). OpenClaw funciona perfectamente con npm.

Si conoces pnpm, también puedes usarlo. Comparado con npm:

• Instalación más rápida
• Menos espacio en disco
• Gestión de dependencias más estricta

Para la mayoría de los usuarios, cualquiera de los dos está bien. Yo prefiero pnpm, pero es cuestión de gustos.

Para instalar pnpm:

npm install -g pnpm

Instalar OpenClaw

Preparativos completos, pasemos a la instalación. Existen varios métodos; estos son los que recomiendo, en orden de preferencia.

Método 1: script oficial (el más recomendado)

El más simple, un solo comando:

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

El script:

• Comprueba el entorno del sistema
• Instala las dependencias necesarias
• Descarga e instala la CLI de OpenClaw
• Te solicita ejecutar la configuración inicial

Espera de 1 a 2 minutos según tu conexión. La primera vez, ver los logs desplazarse por la terminal da cierta satisfacción.

Método 2: instalación global con npm

Si prefieres el gestor de paquetes:

npm install -g openclaw@latest

@latest garantiza la última versión. Después, el comando openclaw queda disponible en la terminal.

Método 3: instalación global con pnpm

Con pnpm:

pnpm add -g openclaw@latest

Mismo resultado que con npm, solo cambia la herramienta.

Método 4: desde el código fuente (avanzado)

Para contribuir o experimentar a fondo, clona el repositorio de GitHub:

# Clonar el repositorio
git clone https://github.com/openclaw/openclaw.git

# Entrar en el directorio
cd openclaw

# Instalar las dependencias
pnpm install

# Compilar
pnpm ui:build

Reservado a desarrolladores; no se recomienda para usuarios ocasionales.

Configuración inicial: poner en marcha OpenClaw

Después de la instalación, debes pasar por el asistente de configuración. Es un paso importante pero sencillo.

Inicia el asistente onboard

En la terminal:

openclaw onboard --install-daemon

Esto inicia un asistente interactivo. --install-daemon instala OpenClaw como un servicio del sistema: inicio automático al arrancar, sin reiniciarlo manualmente en cada sesión.

El asistente hace varias preguntas:

Railway - Plataforma de despliegue moderna, sin ops complejas, en producción en minutos

Empezar ahora →Anuncio

1. Elige el modo de ejecución

En general, el modo local (Local gateway) es suficiente, a menos que vayas a desplegar en un servidor remoto.

2. Configurar el modelo de IA

Elige el proveedor:

• OpenAI (GPT-5, etc.)
• Anthropic (serie Claude)
• Modelos locales (configuración adicional)

Introduce tu clave de API de OpenAI o Anthropic si la tienes; si no, puedes configurarla más tarde.

Obtener una clave:

• OpenAI: platform.openai.com, página de claves API
• Anthropic: console.anthropic.com, configuración de API

3. Establecer el directorio de trabajo

El asistente pregunta dónde almacenar la configuración y los datos. Por defecto ~/.openclaw/; pulsa Enter para aceptar.

4. Conecta un canal de mensajería

Elige la plataforma para interactuar con la IA:

• Telegram: crea un bot a través de @BotFather y copia el token
• WhatsApp: se muestra un código QR; escanéalo con la app móvil
• Omitir: para usar solo la interfaz web por ahora

Yo elegí Telegram, la configuración es rápida:

1. Busca @BotFather en Telegram
2. Envía /newbot
3. Ponle nombre al bot
4. Copia el token generado
5. Pégalo en la configuración de OpenClaw

5. Instalar el demonio

Por último, ¿instalar el demonio en segundo plano? Si dices que sí, OpenClaw sigue ejecutándose incluso tras cerrar la terminal.

El proceso completo lleva de 5 a 10 minutos, sobre todo por obtener las claves API y configurar los canales.

Configuración manual (opcional)

Para ajustes finos, edita el archivo de configuración:

nano ~/.openclaw/openclaw.json

Es un archivo JSON con todas las opciones. Para la mayoría de los usuarios, el asistente es suficiente.

Primera ejecución: verifica que todo funciona

Configuración terminada, arranca OpenClaw.

Iniciar el Gateway

Si no instalaste el demonio, inicia manualmente:

openclaw gateway --port 18789

18789 es el puerto predeterminado; puedes elegir otro. Si tiene éxito verás algo como:

✓ OpenClaw Gateway started on http://localhost:18789

Acceder a la interfaz web

Abre el navegador en:

http://localhost:18789

Deberías ver el panel de control de OpenClaw:

• Chat: área de prueba de conversación
• Agents: gestión de tus agentes de IA
• Skills: configuración de habilidades (plugins)
• Settings: configuración del sistema

Probar una conversación

En la pestaña Chat, envía por ejemplo “Hola” o “Preséntate”.

Si todo está configurado correctamente, la IA te responde: es tu asistente de IA autoalojado.

Solución de problemas comunes

Instalar software puede traer pequeños tropiezos. Aquí están los casos más comunes.

Versión de Node.js incorrecta

Síntoma: error de compatibilidad de Node al ejecutar openclaw

Alibaba Cloud - Opción preferida para desarrolladores, 15 % de descuento exclusivo en Lighthouse

Obtener 15% dto. →Anuncio

Solución: comprueba la versión, mínimo v22.14 (recomendado v24)

node --version

Si es demasiado baja, reinstala o actualiza Node.js.

Problemas de WSL2 (usuarios de Windows)

Síntoma: errores diversos al instalar en Windows

Solución: confirma que WSL2 está instalado y actualizado

wsl --update

Clave API no válida

Síntoma: clave configurada pero la IA no responde o da error

Solución:

• Revisa la copia (sin espacios sobrantes)
• Confirma el saldo de la cuenta (OpenAI y Anthropic cobran por uso)
• Regenera la clave

Puerto ocupado

Síntoma: el puerto 18789 ya está en uso al iniciar el Gateway

Solución: cambia el puerto o libera el proceso

# Ver qué usa el puerto 18789
lsof -i :18789

# Iniciar en otro puerto
openclaw gateway --port 18790

Problemas de permisos

Síntoma: permisos insuficientes durante la instalación

Solución: en Linux/Mac, a veces hace falta sudo, o revisa los permisos del directorio

# Asegurar permisos de escritura
chmod -R 755 ~/.openclaw

Recordatorios de seguridad

Una vez instalado OpenClaw, ten en cuenta:

1. No expongas el puerto: 18789 escucha en localhost por defecto; no lo publiques en Internet, o cualquiera podría acceder a tu IA.
2. Protege las claves API: son confidenciales en la configuración; no las compartas ni las subas a Git.
3. Acceso remoto mediante túnel SSH: desde otro dispositivo, prefiere un túnel SSH en lugar de abrir el puerto.

# Acceder desde otra máquina mediante SSH
ssh -L 18789:localhost:18789 user@your-server

Lectura relacionada

• Configuración de OpenClaw: la guía completa de openclaw.json
• Arquitectura de OpenClaw en detalle: diseño en tres capas
• OpenClaw vs ChatGPT: arquitectura, costo y privacidad

Para concluir

Ahora deberías tener OpenClaw instalado. Recapitulemos el recorrido:

Entonces puedes:

• Explorar las Skills y añadir capacidades a la IA
• Conectar Telegram o WhatsApp para usarlo en tu mensajería
• Si te interesa, desarrollar habilidades personalizadas
• Consultar la documentación oficial para funciones avanzadas

OpenClaw es de código abierto, pero la experiencia ya es sólida. Si te atascas, la página de Issues de GitHub y la comunidad están bastante activas.

La primera vez que usas este tipo de herramienta puede parecer complicado; una vez que la has instalado, es casi rutina. Tómate tu tiempo, busca en línea: la mayoría de los problemas se resuelven.

¡Que te diviertas!