Guía de instalación

Instala OpenClaw

Elige tu método preferido. Todos llevan al mismo CLI.

checklist Requisitos del sistema

javascript Node.js

Node.js 22 o superior (LTS recomendado)

computer OS

Windows 10+, macOS 12+, o Linux (Ubuntu 20.04+, Debian 11+)

memory RAM

2 GB de RAM mínimo, 4 GB recomendado

hard_drive Disk

~500 MB de espacio en disco para instalación y dependencias

extension Optional

Opcional: Python 3.10+ (para algunos skills), Git (para compilar desde fuente)

wifi Network

Se requiere conexión a internet para llamadas a APIs de IA. Los modelos locales vía Ollama funcionan offline.

Scripts de una línea que hacen todo. Recomendado para la mayoría. Todo en la documentación arrow_forward

Windows (PowerShell)

Ejecuta PowerShell como administrador para mejores resultados.

PS> curl -fsSL https://openclaw.ai/install.cmd -o install.cmd && install.cmd --tag beta && del install.cmd

macOS / Linux

Funciona en macOS y la mayoría de distribuciones Linux.

$ curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git

verified Verifica tu instalación

Ejecuta estos comandos para confirmar que OpenClaw está instalado correctamente.

1
$ openclaw --version

Debería mostrar el número de versión instalada (ej. v2026.3.12).

2
$ openclaw doctor

Ejecuta un diagnóstico de tu entorno: versión de Node.js, dependencias, archivos de configuración y conectividad.

3
$ openclaw onboard

Asistente interactivo que te guía a través de API keys, conexión de plataformas de chat y configuración inicial.

settings Configuración inicial

Después de instalar, el asistente de onboard te guía en la configuración. Esto es lo que hace cada paso.

1

Elige tu proveedor de IA

Selecciona Anthropic (Claude), OpenAI (GPT), Google (Gemini) o un modelo local vía Ollama. Puedes cambiar de proveedor en cualquier momento desde tu config.

2

Agrega tu API key

Pega tu API key desde el dashboard del proveedor. Las keys se guardan localmente en tu archivo .env — nunca se envían a ningún lado excepto al proveedor de IA.

3

Conecta una plataforma de chat

Vincula WhatsApp (escanea código QR), Telegram (pega el token del bot de @BotFather), Discord (pega el token del bot) o cualquier otra plataforma soportada.

4

Envía un mensaje de prueba

Envía un mensaje a OpenClaw a través de tu app de chat conectada. Si responde, todo está listo. Prueba: '¿Qué puedes hacer?'

.env — Toda la configuración se guarda en ~/.openclaw/.env. Puedes editar este archivo directamente para cambiar proveedores, agregar API keys o ajustar configuraciones. Consulta docs.openclaw.ai/configuration para la referencia completa.

system_update_alt Actualizar OpenClaw

Mantén OpenClaw al día para obtener las últimas funciones, integraciones y parches de seguridad. Cómo actualizar y migrar arrow_forward

npm
$ npm update -g openclaw@latest
pnpm
$ pnpm update -g openclaw@latest
Git
$ cd openclaw && git pull && pnpm install && pnpm run build
Docker
$ docker pull openclaw/openclaw:latest && docker restart openclaw

Revisa el changelog en github.com/openclaw/openclaw/releases para ver las novedades de cada versión.

delete_forever Desinstalar OpenClaw

Si necesitas eliminar OpenClaw de tu sistema, sigue los pasos correspondientes a tu método de instalación. Cómo desinstalar paso a paso arrow_forward

npm
$ npm uninstall -g openclaw
pnpm
$ pnpm remove -g openclaw
Git (Source)
$ rm -rf ~/openclaw
Docker
$ docker stop openclaw && docker rm openclaw && docker rmi openclaw/openclaw:latest

Eliminar datos de usuario (opcional)

Esto borrará todas tus conversaciones, habilidades, configuración y claves API. Haz una copia de seguridad de lo que necesites antes de continuar.

macOS/Linux $ rm -rf ~/.openclaw
Windows PS> rmdir /s /q %USERPROFILE%\.openclaw

build Solución de problemas

Problemas comunes y cómo resolverlos. Más tips para resolver problemas arrow_forward

¿Necesitas ayuda?

Únete a nuestro Discord para soporte de instalación.

Mantente al día

Recibe novedades sobre nuevas funciones e integraciones. Sin spam, cancela cuando quieras.