Cómo instalar OpenClaw en Windows, macOS y Linux (2026)

Respuesta rápida: OpenClaw se instala con el script oficial. En macOS, Linux o WSL2: curl -fsSL https://openclaw.ai/install.sh | bash. En Windows con PowerShell: iwr -useb https://openclaw.ai/install.ps1 | iex. El script lanza el asistente de configuración. Luego verificas con openclaw --version, openclaw doctor y openclaw gateway status. Necesitas Node 24.16+ o 26.1+ (se recomienda Node 26).

Sistema	Comando oficial	Verificación
macOS, Linux o WSL2	curl -fsSL https://openclaw.ai/install.sh | bash	openclaw --version
Windows (PowerShell)	iwr -useb https://openclaw.ai/install.ps1 | iex	openclaw --version
Con pnpm (cualquier sistema)	pnpm add -g --allow-build=openclaw openclaw@latest	openclaw --version

Los comandos vienen de la documentación oficial de instalación de OpenClaw, consultada el 26 de octubre de 2026.

OpenClaw es distinto de Codex o Claude Code: no es solo un agente de código en una carpeta. Es un asistente personal que corre como servicio en tu máquina (el Gateway) y se conecta a canales de mensajería y a modelos de IA. Por eso esta guía dedica una sección entera a la seguridad. Si lo que buscas es un agente para programar, compara antes con Cómo instalar Codex, Cómo instalar Claude Code en Windows o la guía práctica de Goose. Si quieres modelos locales, instala primero Ollama. El curso gratuito Instala tu primer agente es el siguiente paso.

Qué instalas exactamente

Al instalar OpenClaw obtienes tres cosas:

Pieza	Qué hace
CLI openclaw	El comando para configurar, diagnosticar, actualizar y desinstalar
Gateway	Un servicio en segundo plano que recibe mensajes y ejecuta al agente
Estado local	Configuración y credenciales en ~/.openclaw (o en OPENCLAW_STATE_DIR si la defines)

El Gateway se instala como servicio del sistema: launchd en macOS, un servicio de usuario de systemd en Linux y una tarea programada en Windows. Eso significa que sigue corriendo aunque cierres la terminal. Tenlo en cuenta en una laptop de trabajo.

Requisitos

Según la documentación oficial:

• Sistema: macOS, Linux o Windows.
• Node: 24.16 o posterior, o 26.1 o posterior. Se recomienda Node 26.
• Windows: puedes empezar con la app nativa Windows Hub, con el instalador de PowerShell o con un Gateway en WSL2.
• pnpm: solo si compilas desde el código fuente.

Comprueba tu versión de Node con:

node --version

Si es menor que 24.16, actualízala desde nodejs.org antes de seguir.

También necesitas acceso a un modelo de IA: una API key de un proveedor (con su propio costo) o un modelo local. OpenClaw es software libre con licencia MIT, pero el uso de modelos de pago se factura aparte, según el proveedor que elijas.

Paso 1: ejecuta el instalador

macOS y Linux

Abre la terminal y ejecuta:

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

Windows

Abre PowerShell y ejecuta:

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

Si prefieres Linux dentro de Windows, abre tu distribución de WSL2 y usa el comando de macOS y Linux.

Alternativa con un gestor de paquetes

Si ya administras herramientas globales con pnpm:

pnpm add -g --allow-build=openclaw openclaw@latest

Con este método el asistente de configuración no se abre solo; lo lanzas en el paso 2.

Paso 2: configura con el asistente (onboarding)

El script oficial abre el asistente al terminar, salvo que pases --no-onboard. Si instalaste con pnpm, o quieres repetirlo, ejecuta:

openclaw onboard --install-daemon

El parámetro --install-daemon instala el Gateway como servicio. El asistente te pide el proveedor de modelo y los canales que quieres conectar. Recomendación: en la primera sesión conecta un solo canal y un solo modelo. Agrega más cuando todo funcione.

No pegues API keys en chats, capturas ni archivos del proyecto. Introdúcelas solo en el asistente o en la configuración local.

Paso 3: verifica la instalación

La documentación indica tres comprobaciones:

openclaw --version
openclaw doctor
openclaw gateway status

• openclaw --version confirma que el comando existe.
• openclaw doctor busca problemas de configuración.
• openclaw gateway status confirma que el Gateway está corriendo.

Si las tres responden sin errores, la instalación quedó lista.

Paso 4: revisa la seguridad antes de usarlo

OpenClaw recibe mensajes y puede ejecutar herramientas en tu nombre. La guía oficial de seguridad del Gateway recomienda:

1. Correr la auditoría: openclaw security audit revisa si tu instalación se alejó de los valores seguros. openclaw security aplica las correcciones automáticas compatibles.
2. Mantener el Gateway en loopback: en una instalación normal escucha solo en 127.0.0.1. Las imágenes de contenedor exponen el puerto por defecto; en ese caso, actívales autenticación.
3. Conservar el emparejamiento de mensajes directos: por defecto, un remitente desconocido recibe un código de emparejamiento y su mensaje no se procesa.
4. Limitar grupos con allowlist: los grupos se permiten por lista y suelen exigir una mención.
5. Revisar la política de herramientas: openclaw policy muestra y prueba qué herramientas puede usar el agente.
6. Un límite de confianza por Gateway: un Gateway es para una persona o un equipo de confianza. Si hay usuarios que no conoces, usa Gateways separados con credenciales separadas.

No expongas el Gateway a internet el primer día. Si algún día lo necesitas, sigue el procedimiento de exposición de la documentación oficial.

Actualizar

La documentación tiene una página de actualización. Para cambiar entre el canal estable y el de desarrollo usa:

openclaw update --channel stable

Quédate en stable salvo que necesites una función nueva y aceptes más riesgo de errores.

Desinstalar

Primero mira qué se borraría, sin borrar nada:

openclaw uninstall --dry-run --all

Luego desinstala de forma interactiva:

openclaw uninstall

Después quita el comando según cómo lo instalaste. Con pnpm: pnpm remove -g openclaw. Confirma que ya no existe con command -v openclaw (macOS/Linux) o Get-Command openclaw -ErrorAction SilentlyContinue (PowerShell).

Si ya borraste el comando pero el servicio sigue activo, la documentación da comandos por sistema. En Windows, por ejemplo: schtasks /Delete /F /TN "OpenClaw Gateway".

Errores comunes y cómo resolverlos

Síntoma	Causa probable	Qué hacer
El instalador falla por la versión de Node	Node anterior a 24.16	Actualiza a Node 26 y repite
openclaw no se reconoce	Terminal abierta antes de instalar	Abre una terminal nueva
openclaw gateway status dice que no corre	El daemon no se instaló	Ejecuta openclaw onboard --install-daemon
openclaw doctor reporta errores de configuración	Valores incompletos del asistente	Corrige lo que indica y repite el diagnóstico
Mensajes de desconocidos no se procesan	Emparejamiento de mensajes directos activo	Es el comportamiento seguro; aprueba solo a quien conoces
Con pnpm la instalación omite pasos de compilación	pnpm bloquea scripts sin aprobar	Usa --allow-build=openclaw, como en el comando oficial
'iwr' is not recognized	Estás en CMD	Abre PowerShell

Preguntas frecuentes

¿OpenClaw es gratis? El software es libre, con licencia MIT. Los modelos de IA que conectes pueden costar según el proveedor; un modelo local con Ollama evita ese costo a cambio de usar tu hardware.

¿Funciona en Windows? Sí: con la app Windows Hub, el instalador de PowerShell o un Gateway en WSL2.

¿Necesito saber programar? No para instalarlo. Sí ayuda saber usar la terminal y entender qué permisos das al agente.

¿En qué se diferencia de Codex o Claude Code? Codex y Claude Code trabajan sobre una carpeta de código cuando tú los abres. OpenClaw corre como servicio y responde por canales de mensajería. Para programar, revisa Claude Code vs Codex.

¿Puedo dejarlo encendido siempre? Sí, para eso existe el daemon. Hazlo solo después de correr openclaw security audit y limitar quién puede escribirle.

¿Qué hago después? Define una sola tarea útil y pruébala. El curso gratuito Instala tu primer agente te guía, y el hub Construir agentes reúne el resto de guías.