Cómo instalar OpenClaw: Guía de instalación completa paso a paso 2026

Introducción

La instalación de OpenClaw es sencilla, con múltiples métodos que se adaptan a diferentes preferencias y niveles de comodidad técnica. Ya sea que desee una instalación rápida de una sola línea, prefiera npm o desee compilar desde el código fuente, esta guía cubre todas las opciones.

Esta guía cubre la instalación en macOS, Windows y Linux. Para obtener detalles específicos de la plataforma, consulte nuestras guías dedicadas:

• Guía de configuración de macOS
• Guía de configuración de Windows
• Guía de configuración de Linux

Requisitos previos

Antes de instalar OpenClaw, asegúrese de tener:

• Node.js 18+: necesario para ejecutar OpenClaw (el instalador de una sola línea maneja esto automáticamente)
• Terminal Access — Interfaz de línea de comandos en su sistema
• Conexión a Internet: para descargar paquetes y dependencias
• 2 GB+ RAM: recomendado para un funcionamiento fluido

El instalador de una sola línea instalará automáticamente Node.js si aún no está presente, por lo que puede continuar incluso si no tiene Node.js instalado.

Métodos de instalación

Método 1: Instalación de una sola línea (recomendado)

La forma más rápida de ejecutar OpenClaw es el instalador de una sola línea. Maneja la instalación de Node.js y todas las dependencias automáticamente.

MacOS/Linux

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

Este script:

1. Verifique Node.js (instale si falta)
2. Instale OpenClaw globalmente a través de npm
3. Configure los permisos necesarios
4. Verificar la instalación

Una vez completada la instalación, verá:

✓ OpenClaw installed successfully!
  Run 'openclaw onboard' to get started.

Windows (PowerShell)

irm https://openclaw.ai/install.ps1 | iex

O usando el método npm (ver más abajo) que funciona de manera idéntica en Windows.

Método 2: instalación de npm

Si ya tienes Node.js instalado, puedes instalar OpenClaw directamente a través de npm:

npm i -g openclaw

Esto instala OpenClaw globalmente, haciendo que el comando openclaw esté disponible en todo el sistema.

Usando pnpm:

pnpm add -g openclaw

Usando hilo:

yarn global add openclaw

Método 3: Instalación pirateable (desde la fuente)

Para los desarrolladores que quieran modificar el código fuente o contribuir, pueden crear OpenClaw desde el código fuente:

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm run build

Luego ejecuta OpenClaw usando:

pnpm run openclaw onboard

O vincularlo globalmente:

pnpm link --global

Este método le brinda control total sobre el código base y facilita la personalización de OpenClaw según sus necesidades.

Método 4: Aplicación complementaria de macOS (Beta)

Para los usuarios de macOS, existe una aplicación de barra de menú complementaria que proporciona una interfaz GUI junto con la CLI:

1. Descargar desde Versiones de GitHub
2. Abra el archivo .dmg
3. Arrastre OpenClaw a Aplicaciones
4. Inicie desde Aplicaciones o Spotlight

La aplicación complementaria funciona junto con la instalación CLI y proporciona:

• Acceso a la barra de menú
• Indicadores visuales de estado
• Acceso rápido a la configuración
• Visor de registros

Requisitos:

• macOS 14+ (Sonoma o posterior)
• Universal Binary (funciona en Apple Silicon e Intel)

Requisitos del sistema

MacOS

• macOS 13 Ventura o posterior
• Node.js 18+ (instalado automáticamente por una sola línea)
• Se recomiendan más de 2 GB de RAM
• Procesador Apple Silicon (M1/M2/M3) o Intel

ventanas

• Windows 10 o Windows 11
• Nodo.js 18+
• PowerShell 5.1+ o Terminal de Windows
• Se recomienda WSL2 para una mejor experiencia.

Linux

• Ubuntu 20.04+, Debian 11+, Fedora 34+ o similar
• Nodo.js 18+
• 2 GB+ de RAM
• Arquitectura ARM64 o x86_64
• Compatible con Raspberry Pi 4+

Configuración posterior a la instalación

Después de la instalación, debes configurar OpenClaw antes de usarlo. Ejecute el comando de incorporación:

openclaw onboard

Esta configuración interactiva lo guiará a través de:

1. Selección del modelo de IAElija su proveedor de IA:

• Claude Anthropic — Claude 3.5 Soneto, Claude 3 Opus, Claude 4
• OpenAI GPT — GPT-4o, GPT-4 Turbo, GPT-4.1
• Modelos locales — Ollama, LM Studio, MiniMax

Necesitará claves API para los modelos en la nube. Para Claude, obtenga su clave en console.anthropic.com. Para OpenAI, obtenga su clave en platform.openai.com.

2. Configuración de persona

Configura la personalidad de tu IA:

• Nombre (predeterminado: “Langosta”)
• Tono y estilo
• Capacidades y limitaciones
• Preferencias de respuesta

3. Configuración de la memoria

Configurar la memoria persistente:

• Ubicación de almacenamiento
• Políticas de retención de memoria.
• Tamaño de la ventana de contexto

4. Habilidades iniciales

Seleccione habilidades predeterminadas para habilitar:

• Gestión de correo electrónico
• Integración de calendario
• Control del navegador
• Acceso al sistema de archivos

Verificando la instalación

Después de la instalación, verifique que todo funcione:

openclaw --version

Debería ver el número de versión (por ejemplo, v1.0.0).

Pruebe la instalación:

openclaw test

Esto ejecuta un diagnóstico rápido para garantizar que todos los componentes funcionen correctamente.

Conexión de aplicaciones de chat

Una vez que OpenClaw esté instalado y configurado, conecte sus aplicaciones de chat:

openclaw integrations

Esto abre un menú interactivo para configurar:

• WhatsApp
• Telegram
• Discord
• flojo
• iMessage
• Otras plataformas

Para obtener guías de configuración detalladas, consulte:

• Configuración de WhatsApp
• Configuración de Telegram
• Configuración de Discord
• Configuración de Slack
• Configuración de iMessage

Iniciando OpenClaw

Para iniciar el servidor OpenClaw:

openclaw

Esto inicia el servidor local y conecta todas las integraciones configuradas. Verás mensajes de estado que indican qué aplicaciones de chat están conectadas.

Para ejecutar en segundo plano:

openclaw start --daemon

O utilice un administrador de procesos como pm2:

npm i -g pm2
pm2 start openclaw
pm2 save
pm2 startup

Solución de problemas

La instalación falla

Si el instalador de una sola línea falla:

1. Verifique la versión de Node.js:

   node --version

   Debe ser v18 o superior.

2. Pruebe npm install directamente:

   npm i -g openclaw

3. Verificar permisos:

   sudo npm i -g openclaw

   (solo macOS/Linux)

Comando no encontrado

Si no se encuentra el comando openclaw:

1. Verifique la ruta global de npm:

   npm config get prefix

2. Agregar a RUTA (si es necesario):

   export PATH="$PATH:$(npm config get prefix)/bin"

3. Reiniciar terminal después de la instalación

Puerto ya en uso

Si ve errores de “puerto ya en uso”:

openclaw --port 3001

O busque y finalice el proceso usando el puerto:

lsof -ti:3000 | xargs kill

Errores de permiso

En macOS/Linux, es posible que tengas que otorgar permisos:

• Acceso a la terminal
• Acceso al sistema de archivos
• Acceso a la red

Verifique Preferencias del sistema → Seguridad y privacidad.

Actualizando OpenClaw

Para actualizar a la última versión:

npm update -g openclaw

O vuelva a ejecutar el instalador de una sola línea (se actualizará si ya está instalado).

Busque actualizaciones:

npm outdated -g openclaw

Desinstalación de OpenClaw

Para eliminar OpenClaw:

npm uninstall -g openclaw

Esto elimina la instalación global pero mantiene su configuración y datos. Para eliminar todo:

rm -rf ~/.openclaw

Próximos pasos

Ahora que OpenClaw está instalado:

1. Explore habilidades: consulte las habilidades disponibles en /skills
2. Configurar integraciones: conecta tus aplicaciones de chat (consulta página de integraciones)
3. Lea las preguntas frecuentes: preguntas comunes respondidas en /faq
4. Únase a la comunidad: Discord, debates de GitHub y más

ConclusiónInstalar OpenClaw es rápido y sencillo. El instalador de una sola línea maneja la mayor parte de la complejidad, haciéndolo accesible a usuarios de todos los niveles técnicos. Una vez instalado, el comando openclaw onboard lo guía a través de la configuración.

Para obtener consejos específicos de la plataforma y opciones de configuración avanzadas, consulte nuestras guías detalladas:

• Configuración de macOS
• Configuración de Windows
• Configuración de Linux

¿Listo para comenzar a usar tu asistente personal de IA? Ejecute openclaw onboard y comience el proceso de configuración.