Instalar OpenClaw paso a paso (Windows, Mac, Linux)

Para instalar OpenClaw, utilice el script oficial correspondiente a su sistema, complete el asistente de configuración y compruebe el funcionamiento del Gateway y la primera respuesta del modelo. En Windows puede optar por la instalación nativa con PowerShell o utilizar WSL2; en Mac y Linux, la instalación desde la terminal comienza con el mismo comando. Los comandos y requisitos que se indican a continuación se verificaron en la documentación oficial el 24 de octubre de 2026. Para saber si un agente que se instala uno mismo le conviene frente a una oferta alojada, lea agente de IA de código abierto o propietario.

1. Preparar el equipo y el acceso al modelo

Necesitará una terminal, conexión a Internet y acceso operativo al proveedor del modelo que haya elegido. Una clave API es una credencial secreta de autenticación: no la pegue en una conversación pública ni la incluya en una captura de pantalla que vaya a enviar al soporte técnico.

En cuanto a Node.js, la página específica exige Node 24.22.1 o una versión posterior de la rama 24, o Node 26.12.1 o una versión posterior de la rama 26; recomienda la rama 26. Estos requisitos, verificados el 24 de octubre de 2026, son más estrictos que los que todavía aparecen en algunas páginas generales. Tome como referencia la documentación específica de Node.js.

Si ya tiene Node instalado, compruebe la versión:

node -v

El script oficial puede instalar el entorno de ejecución si no está disponible. Si su equipo ya tiene varias instalaciones de Node, anote la versión que aparece antes de empezar: ese dato ayudará a entender cualquier diferencia entre la versión que utiliza la terminal y la que utiliza el servicio.

Elija también una carpeta de trabajo sin documentos sensibles para las primeras pruebas. El objetivo inicial es comprobar que todo el proceso funciona, antes de conectar sus cuentas. Nuestra guía de referencia de OpenClaw aborda después los modelos, las habilidades y los servicios de mensajería.

2. Elegir el procedimiento adecuado para su sistema

La tabla recoge las opciones de instalación desde la terminal que se explican aquí. Siga únicamente la que corresponda a su entorno.

Criterio	Windows nativo	Windows con WSL2	Mac	Linux
Terminal utilizada	PowerShell	PowerShell y después terminal Linux	Terminal	Terminal
Instalación de OpenClaw	Script de PowerShell	Script de Linux dentro de WSL2	Script de shell	Script de shell
Gestión del servicio	Tarea programada, con alternativa de respaldo	Servicio de usuario de systemd	LaunchAgent	Servicio de usuario de systemd
Aspecto que conviene revisar	Permisos para crear tareas	Entorno e inicio de WSL	Sesión de usuario	Disponibilidad de systemd para el usuario

La página oficial de instalación describe estos mecanismos y las aplicaciones de escritorio. Para Windows recomienda Windows Hub si prefiere una interfaz gráfica; este tutorial desarrolla los comandos para que pueda comprobar cada paso.

Empiece con un solo procedimiento. Instalar sucesivamente una aplicación, una CLI nativa y otra CLI dentro de WSL2 complica el diagnóstico: podría estar revisando un entorno mientras el Gateway funciona en otro distinto.

Anote el sistema, la terminal utilizada y el método de instalación elegido. Este pequeño registro le resultará útil cuando tenga que actualizar el programa o pedir ayuda. Para conocer el lugar que ocupa esta herramienta entre las distintas opciones disponibles, consulte nuestro directorio de agentes IA.

3. Instalar OpenClaw en Mac o Linux

Abra la terminal que utiliza habitualmente. Copie el comando oficial:

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

El comando descarga un script y lo ejecuta en su equipo. Por eso, compruebe el dominio antes de ejecutarlo y utilice su cuenta de usuario habitual. Lea cada solicitud adicional de permisos, en lugar de conceder privilegios de administrador de forma sistemática durante todo el proceso.

Espere a que el instalador termine. Si aparece un error, guarde el mensaje completo y anote en qué paso se produjo antes de volver a ejecutar cualquier comando. Una descarga interrumpida y un permiso denegado requieren soluciones distintas.

Normalmente, el instalador abre el asistente de configuración. Si ya está abierto, continúe directamente con el paso de conexión al modelo. Evite iniciar otro asistente en una ventana distinta mientras el primero espera su respuesta.

Después de la instalación, compruebe que el comando está disponible:

openclaw --version

Que aparezca una versión solo confirma este paso. No demuestra que el Gateway esté funcionando ni que el proveedor del modelo acepte sus credenciales.

Si utiliza un equipo de trabajo administrado por su organización, respete las normas de seguridad existentes. Si una política bloquea la descarga o la ejecución, identifique exactamente qué la impide antes de buscar otro método.

4. Instalar OpenClaw en Windows de forma nativa o con WSL2

Instalación nativa con PowerShell

Abra PowerShell y ejecute:

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

Este comando oficial descarga y ejecuta el instalador. Siga las instrucciones que aparecen en pantalla y continúe con el asistente. No reduzca las protecciones generales del sistema para intentar resolver un error cuya causa todavía no ha identificado.

Instalación con WSL2

La documentación oficial para Windows, verificada el 24 de octubre de 2026, presenta WSL2 como el entorno de ejecución del Gateway que ofrece mayor compatibilidad con Linux. Si elige esta opción, empiece en PowerShell:

wsl --install

Complete las operaciones que se le soliciten y abra después su distribución de Linux. La documentación proporciona este comando para activar systemd:

sudo tee /etc/wsl.conf >/dev/null <<'EOF'
[boot]
systemd=true
EOF

Atención: este comando sobrescribe el contenido del archivo indicado. Si ya ha personalizado ese archivo, haga una copia de seguridad e incorpore el ajuste a la configuración existente.

Vuelva a PowerShell para detener WSL, después de guardar su trabajo en las distribuciones que tenga abiertas:

wsl --shutdown

A continuación, abra de nuevo la terminal Linux e instale OpenClaw:

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

Durante el resto del procedimiento con WSL2, ejecute los comandos de OpenClaw en esa terminal Linux. Evite alternar entre este entorno y una instalación nativa de Windows.

5. Configurar y comprobar la conexión al modelo

Si el asistente no se ha iniciado, ejecútelo:

openclaw onboard

Según la documentación del asistente de la CLI, la opción Quick start detecta los accesos disponibles, le permite elegir una conexión y la comprueba mediante una generación real. Custom setup permite revisar más ajustes durante la configuración.

Antes de continuar, compruebe el proveedor y el acceso seleccionados. Que el asistente detecte una conexión no significa necesariamente que sea la que desea utilizar, sobre todo si el equipo es compartido o tiene varias cuentas configuradas.

La documentación distingue dos resultados: Local setup confirma que la preparación local se ha completado; Inference ready indica que la conexión elegida ha superado la comprobación. Por tanto, si omitió la conexión al modelo, no dé por hecho que la instalación ya está plenamente operativa.

Para empezar, elija una configuración sencilla y deje las integraciones opcionales para más adelante. Anote el proveedor y el modelo seleccionados, sin copiar sus credenciales secretas en el registro de configuración.

Prepare también una forma de controlar el gasto en el proveedor. Instalar el programa y pagar las generaciones son cuestiones distintas; la calculadora de precios de LLM ayuda a estimar un presupuesto a partir de las tarifas y del volumen previsto. Evite ejecutar automatizaciones prolongadas hasta haber observado el costo de una prueba limitada.

6. Instalar el servicio y obtener la primera respuesta

En el procedimiento Quick start que describe la documentación, el Gateway se ejecuta inicialmente en primer plano, dentro de la terminal. Para que funcione en segundo plano, detenga ese proceso con Ctrl+C y ejecute:

openclaw gateway install

Compruebe después el servicio:

openclaw gateway status

A continuación, abra el panel de control:

openclaw dashboard

Estos comandos siguen la guía oficial de inicio. Compruebe que el estado indica que el servicio está funcionando y que la conexión se ha establecido correctamente. Después, envíe una solicitud breve desde la interfaz.

Una primera prueba puede consistir en pedir que reformule un párrafo que no contenga información personal. Así podrá comprobar la respuesta del modelo sin depender de un servicio de mensajería, un navegador automatizado o el acceso a sus archivos.

Pruebe después a abrir de nuevo el panel de control desde otra terminal. El objetivo es verificar que está utilizando el servicio instalado y que no depende de un proceso que sigue vinculado a la primera ventana.

Si quiere probar una acción sobre archivos, prepare a continuación una carpeta de prueba con copias que pueda descartar y una tarea de alcance limitado. La diferencia entre responder y actuar se explica en Agente IA o chatbot: ¿en qué se diferencian?.

7. Revisar los permisos antes de añadir integraciones

Antes de conectar cuentas o instalar extensiones, ejecute:

openclaw security audit

La documentación oficial de seguridad presenta esta auditoría como una revisión de la configuración. También aclara que el Gateway constituye un límite de confianza: no está diseñado para aislar a usuarios mutuamente hostiles que comparten el mismo entorno.

Lea los resultados antes de cambiar los ajustes. Para cada función que quiera habilitar, identifique a qué recursos podrá acceder y qué acciones podrá realizar: leer una carpeta, modificar un archivo y enviar un mensaje tienen consecuencias distintas.

Aplique el principio de mínimo privilegio: conceda los permisos que correspondan a la tarea actual. Durante este primer procedimiento, mantenga el Gateway accesible de forma local, sin abrir un puerto en el router para intentar resolver un problema con la interfaz.

Añada después las integraciones una por una. Tras cada incorporación, repita una solicitud sencilla y revise los permisos concedidos. Así podrá relacionar un fallo con el último cambio, en lugar de tener que diagnosticar varias conexiones a la vez.

Una auditoría sin alertas no garantiza que una acción propuesta por el modelo sea correcta. La guía para proteger un agente IA complementa estas comprobaciones con la gestión de secretos, el aislamiento y la validación humana.

Problemas frecuentes

No se encuentra el comando de OpenClaw

Cierre la terminal, vuelva a abrirla y compruebe que está en el entorno donde realizó la instalación. Si utiliza WSL2, asegúrese de abrir la terminal Linux. Un problema con PATH puede impedir que la terminal encuentre un programa que sí está instalado; evite acumular instalaciones antes de revisar este punto.

El panel de control se abre, pero no llega ninguna respuesta

Revise por separado la interfaz, el Gateway y el acceso al modelo. Ejecute los diagnósticos indicados en la documentación:

openclaw status
openclaw gateway status
openclaw doctor
openclaw logs --follow

El procedimiento oficial para resolver problemas relaciona estas comprobaciones con errores de autenticación, servicios detenidos y problemas de conexión. Lea el error concreto antes de sustituir una clave o cambiar la configuración de red.

El servicio no se inicia

Un mensaje que indique que una dirección ya está en uso puede significar que otro Gateway está ocupando el puerto. Compruebe si el proceso que inició en primer plano sigue funcionando. Cambiar el puerto sin investigar la causa puede ocultar que hay dos procesos en ejecución.

El comportamiento cambia después de una actualización

Guarde una copia de seguridad y compruebe que es válida antes de realizar un cambio importante. La documentación de actualización distingue entre las instalaciones de la CLI y los paquetes gestionados por una aplicación: utilice el mecanismo que corresponda a su instalación.

Para pedir ayuda, indique el sistema, el método elegido y el mensaje de error, después de eliminar las credenciales secretas y los datos privados. Nuestro artículo sobre los riesgos de seguridad de los agentes IA explica qué precauciones conviene tomar con los registros y los accesos.

Lista de comprobación final

La instalación queda validada cuando el programa, el servicio y la conexión al modelo funcionan juntos. Antes de confiarle datos de trabajo, compruebe los siguientes puntos:

• Tiene identificados el procedimiento elegido y el entorno de instalación.
• El entorno de ejecución cumple los requisitos actuales de la documentación específica.
• El comando de OpenClaw está disponible en la terminal correcta.
• La conexión al modelo ha superado una comprobación real.
• El Gateway funciona y el panel de control recibe una respuesta.
• Ha revisado los permisos y los resultados de la auditoría.
• Puede consultar y controlar el gasto en el proveedor.
• Las primeras pruebas utilizan datos que no son sensibles.

Si ahora sus dudas se centran en qué programa elegir, consulte la comparativa entre OpenClaw y Hermes Agent. Mantenga una configuración sencilla hasta haber comprobado que funciona para su primer uso concreto.

Preguntas frecuentes

¿Se puede instalar OpenClaw sin saber programar?

Puede completar la instalación sin escribir ningún programa. Aun así, necesita saber abrir una terminal, reconocer un error y entender los permisos solicitados antes de conectar archivos o cuentas.

¿Hay que dejar la computadora encendida para usar OpenClaw?

El Gateway debe estar en funcionamiento para procesar sus solicitudes. Si lo aloja en su computadora, apagarla o suspenderla puede interrumpir el servicio. Alojarlo en un servidor remoto requiere otra configuración.

¿Tener una ventana de OpenClaw abierta demuestra que la instalación funciona?

No. La interfaz puede estar disponible aunque falle la conexión con el proveedor del modelo. Compruebe también que una solicitud sencilla recibe respuesta y que el diagnóstico no detecta errores que impidan el funcionamiento.

¿Instalar OpenClaw en mi PC mantiene todos mis datos en local?

La ubicación del programa no determina dónde se procesan los datos. Si elige un proveedor remoto, revise qué información se le envía y cuáles son sus condiciones antes de introducir documentos confidenciales.