Cómo instalar OpenClaw en Linux, Windows y Mac (guía 2026)

23 de julio del 20266 minOpenClaw, IA, Asistente AI, Tutorial, DevOps

Respuesta corta (60 segundos): OpenClaw se instala con un comando de una línea. En macOS / Linux / WSL2: curl -fsSL https://openclaw.ai/install.sh | bash. En Windows nativo (PowerShell): iwr -useb https://openclaw.ai/install.ps1 | iex. El script detecta tu SO, instala Node 24+ si falta, baja el CLI y lanza el wizard openclaw onboard. Requisitos: macOS 13+, cualquier Linux con curl + xz, Windows 10+. El CLI también está en npm (npm install -g openclaw@latest). Después de instalar, verificá con openclaw --version, openclaw doctor y openclaw gateway status. Todo el proceso tarda entre 60 segundos (laptop moderna) y 5 minutos (Raspberry Pi).

OpenClaw es un asistente AI personal de la OpenClaw Foundation. A diferencia de las versiones hosted de ChatGPT o Claude, corre en tus propios dispositivos — el Gateway queda como un daemon local que se conecta a los canales de mensajería que ya usás (WhatsApp, Telegram, Slack, Discord, iMessage, Signal, Microsoft Teams, Matrix y una lista larga más).

Este post es la guía de instalación que wish hubiera tenido la primera vez que lo probé. Hay tres caminos oficiales y dos o tres trampas conocidas que el script resuelve automáticamente pero que conviene entender. Voy por todas, con verificación posterior.

Antes de empezar: qué necesitás

Lo único que tenés que tener preinstalado en Linux: curl y xz-utils. En Debian/Ubuntu es sudo apt install curl xz-utils. En macOS y Windows ambos vienen por defecto.

Camino 1 · Instalador oficial (recomendado, 1 línea)

Es el método que la OpenClaw Foundation mantiene y es el único que te garantiza la versión correcta para tu plataforma. Detecta el SO, instala Node si falta, descarga el CLI y deja todo listo.

En macOS / Linux / WSL2

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

El script es interactivo: al final te pregunta si querés correr openclaw onboard (el wizard que configura el Gateway, los canales y las skills). Si estás en un servidor o querés control total, saltá el wizard:

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

Después corrés openclaw onboard cuando estés listo.

En Windows nativo (PowerShell)

Abrí PowerShell como usuario normal (no hace falta admin) y pegá:

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

Sin wizard inicial:

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard

Si PowerShell bloquea el script: puede pasar en máquinas con ExecutionPolicy restrictiva. Solución one-shot: Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned y reintentá.

Qué hace exactamente el instalador

1. Detecta arquitectura (x64 / arm64) y SO.
2. Si no hay Node 22.22.3+ / 24+ / 25.9+, lo baja a ~/.openclaw/node.
3. Instala el CLI OpenClaw via npm dentro de ese Node local.
4. Crea un symlink en ~/.local/bin/openclaw (o el equivalente Windows).
5. Lanza openclaw onboard salvo que pasaras --no-onboard.

Tarda entre 30 segundos (Mac M-series) y 4 minutos (servidor ARM barato).

Camino 2 · npm / pnpm / bun (si ya administrás Node)

Si ya tenés un entorno Node estable y querés meter OpenClaw en el mismo Node global que el resto de tus herramientas CLI, es la opción más limpia.

Con npm

npm install -g openclaw@latest
openclaw onboard --install-daemon

Con pnpm

pnpm add -g openclaw@latest
pnpm approve-builds -g
openclaw onboard --install-daemon

Con bun

bun add -g openclaw@latest
openclaw onboard --install-daemon

--install-daemon registra el Gateway como servicio (LaunchAgent en macOS, systemd user unit en Linux, Scheduled Task en Windows) para que quede corriendo entre reinicios.

Camino 3 · Desde fuente (solo contributors)

Si vas a contribuir al proyecto o necesitás correr una rama específica:

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install && pnpm build && pnpm ui:build
pnpm link --global
openclaw onboard --install-daemon

O para correr main directamente sin clonar:

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git --version main

Verificar que quedó bien instalado

Tres comandos, en orden. Si los tres pasan sin error, tu instalación está sana.

~

openclaw --version      # confirmá que el CLI está disponible
openclaw doctor         # chequeo de config y salud — reporta issues con fix sugerido
openclaw gateway status # verificá que el Gateway está corriendo

Si gateway status devuelve "stopped" y querés que quede managed:

# macOS / Linux
openclaw gateway install
# Windows nativo (PowerShell admin si la creación de la Scheduled Task lo requiere)
openclaw gateway install

Si doctor reporta "openclaw not found": casi siempre es un tema de PATH. El bin dir de npm globals no está en tu $PATH. Verificá con:

~

node -v          # ¿está Node?
npm prefix -g    # ¿dónde está el bin dir?
echo "$PATH"     # ¿está ese dir en el PATH?

En macOS suele ser ~/.npm-global/bin; en Linux con nvm es ~/.nvm/versions/node/<version>/bin. Agregalo a tu ~/.zshrc o ~/.bashrc y reabrí la terminal.

Troubleshooting rápido

Después de instalar: configuración inicial

Una vez que openclaw --version responde y el Gateway está corriendo, lo que sigue es configurar tu provider de LLM (OpenAI, Anthropic, etc.) y los canales. El wizard openclaw onboard lo hace paso a paso — te dejo abajo el atajo si querés saltearte el wizard y hacerlo a mano.

openclaw onboard               # wizard completo
# o directo:
openclaw config set OPENAI_API_KEY sk-...
openclaw model                 # elegir modelo por defecto
openclaw gateway setup         # conectar canales (Telegram, WhatsApp, etc.)

Si llegaste hasta acá con todo verde, ya tenés OpenClaw corriendo y conectado al menos al provider. Lo siguiente es sumar canales y skills — pero eso es tema para otro post.

¿Lo querés probar con tu caso puntual antes de invertir tiempo configurándolo? Hay un CTA al final con una llamada gratis de 30 minutos donde puedo ayudarte a decidir si OpenClaw tiene sentido para tu setup.