OpenClaw es una herramienta local que permite que tu agent de AI se conecte a apps como Telegram o WhatsApp y realice acciones, como enviar mensajes o gestionar tareas. Configurarlo es sencillo una vez que entiendes el proceso. Esta guía cubre la instalación en macOS, Linux y Windows.
Resumen rápido de las opciones de configuración de OpenClaw
Elige la configuración que se ajuste a tus necesidades. Ejecutar OpenClaw localmente mantiene todo en tu propia máquina y requiere instalar dependencias como npm o usar un script automatizado. Si prefieres evitar la configuración, las plataformas completamente alojadas como Kimi Claw se encargan del entorno por ti para que puedas empezar directamente.
| macOS / Linux | Windows | |
|---|---|---|
| Ejecutar localmente | Comando de Terminal de una línea | Comando de PowerShell de una línea |
| Mediante npm | Mediante npm | |
| Mediante Homebrew | Mediante WSL2 | |
| Ejecutar en línea | Solución basada en la nube (p. ej., Kimi Claw) | Solución basada en la nube (p. ej., Kimi Claw) |
Cómo instalar OpenClaw en macOS y Linux
macOS y Linux comparten el mismo instalador y los mismos comandos. Estas instrucciones aplican a ambos sistemas salvo que se indique lo contrario.
A continuación encontrarás una guía rápida de configuración. Para ver un recorrido completo paso a paso con capturas de pantalla, consulta Cómo instalar OpenClaw en macOS.
Método 1: Usa el script instalador de una línea
Paso 1: Ejecuta el script de instalación en Terminal
Ejecuta el script instalador oficial para configurar OpenClaw. El script comprueba si Node.js 22 o una versión posterior está instalado. Si falta o está desactualizado, Node.js 24 se instalará automáticamente. Luego instala la CLI de OpenClaw e inicia el asistente de onboarding.
Paso 2: Completa el asistente de onboarding
Sigue el asistente de onboarding para configurar el entorno de tu agent, lo que incluye seleccionar un proveedor de modelos (p. ej., Kimi API), ingresar tu clave de API, elegir un canal y ajustar la configuración básica.
Paso 3: Comprueba tu instalación
Ejecuta el siguiente comando para confirmar tu versión de OpenClaw.
Paso 4: Verifica el gateway y completa la configuración
Ejecuta el siguiente comando para comprobar que el gateway de OpenClaw está activo.
El instalador también registra un LaunchAgent en macOS o un servicio systemd en Linux, de modo que OpenClaw sigue ejecutándose en segundo plano. Cuando todo esté configurado, tu agent estará listo para usarse. Puedes empezar a chatear, conectar herramientas o configurar workflows según tus necesidades.
Método 2: Instalar con Homebrew
Paso 1: Instala o actualiza Node.js
Usa Homebrew para instalar Node.js ejecutando el siguiente comando en Terminal. Si Node.js ya está instalado, ejecuta en su lugar el comando de actualización para asegurarte de usar la versión más reciente.
Paso 2: Instala la CLI de OpenClaw
Ejecuta el siguiente comando para instalar la CLI de OpenClaw de forma global.
Paso 3: Ejecuta el onboarding y configura el daemon
Ejecuta el siguiente comando para iniciar el asistente de onboarding y registrar el daemon en segundo plano. Sigue el asistente para configurar el entorno de tu agent, lo que incluye seleccionar un proveedor de modelos (p. ej., Kimi API), ingresar tu clave de API y conectar un canal de mensajería. Una vez completada la configuración, tu agent estará listo para usarse. Puedes empezar a chatear, conectar herramientas o configurar workflows según tus necesidades.
Método 3: Instalar con npm
Paso 1: Verifica la versión del runtime
Ejecuta el siguiente comando para asegurarte de que Node.js 22.14 o posterior esté instalado en tu sistema. Si tu versión está al día, puedes continuar con la instalación.
Paso 2: Instala la CLI de OpenClaw
Ejecuta el siguiente comando para instalar la CLI de OpenClaw de forma global.
Paso 3: Ejecuta el onboarding y habilita la persistencia
Ejecuta el siguiente comando para iniciar el asistente de onboarding y registrar el daemon en segundo plano. Sigue el asistente para configurar el entorno de tu agent, lo que incluye seleccionar un proveedor de modelos (p. ej., Kimi API), ingresar tu clave de API y elegir un canal de mensajería. Una vez completada la configuración, tu agent estará listo. Puedes empezar a interactuar con él, conectar herramientas o crear workflows según tus necesidades.
Notas de la plataforma: OpenClaw es compatible tanto con Macs Intel como Apple Silicon. Si Gatekeeper bloquea la instalación, puedes permitirla en Configuración del sistema, en Privacidad y seguridad.
Cómo instalar OpenClaw en Windows
Windows ofrece tres formas principales de instalar OpenClaw: el instalador de PowerShell para una configuración nativa rápida, WSL2 para un entorno Linux completo y npm para una instalación manual.
A continuación encontrarás una guía rápida de configuración. Para ver un recorrido completo paso a paso con capturas de pantalla, consulta Cómo instalar OpenClaw en Windows.
Método 1: Usa el instalador de PowerShell (Windows nativo)
Paso 1: Ejecuta el script instalador en PowerShell
Abre PowerShell como administrador y ejecuta el script oficial de una línea para instalar OpenClaw.
Paso 2: Completa el asistente de onboarding
Sigue los pasos de onboarding para configurar el entorno de tu agent, lo que incluye seleccionar un proveedor de modelos (p. ej., Kimi API), ingresar tu clave de API y elegir un canal de mensajería.
Paso 3: Verifica la instalación
Ejecuta el siguiente comando para confirmar que OpenClaw está instalado correctamente y que el gateway está activo.
Paso 4: Empieza a usar tu agent
Una vez completada la configuración, tu agent estará listo. Puedes empezar a interactuar con él, conectar herramientas o configurar workflows según tus necesidades.
Método 2: Instalar con WSL2
Paso 1: Configura el entorno Linux
Abre PowerShell como administrador y ejecuta el siguiente comando para habilitar e inicializar WSL2.
Paso 2: Ejecuta el instalador en Linux
Abre tu terminal de Linux y ejecuta el script de instalación estándar para instalar OpenClaw.
Paso 3: Completa el asistente de onboarding
Sigue los pasos de onboarding para configurar el entorno de tu agent, lo que incluye seleccionar un proveedor de modelos (p. ej., Kimi API), ingresar tu clave de API y elegir un canal de mensajería.
Una vez completada la configuración, tu agent estará listo. Puedes empezar a interactuar con él, conectar herramientas o configurar workflows según tus necesidades.
Método 3: Instalar con npm en Windows
Paso 1: Revisa tu versión de Node.js
Ejecuta el siguiente comando para verificar que Node.js esté instalado y actualizado.
Paso 2: Instala la CLI de OpenClaw
Ejecuta el siguiente comando para instalar la CLI de OpenClaw de forma global.
Paso 3: Ejecuta el onboarding y habilita la persistencia
Ejecuta el siguiente comando para iniciar el asistente de onboarding y registrar el daemon en segundo plano.
Sigue los pasos de onboarding para configurar el entorno de tu agent, lo que incluye seleccionar un proveedor de modelos (p. ej., Kimi API), ingresar tu clave de API y elegir un canal de mensajería.
Una vez completada la configuración, tu agent estará listo. Puedes empezar a interactuar con él, conectar herramientas o configurar workflows según tus necesidades.
Cómo ejecutar OpenClaw en línea con Kimi Claw
Los métodos anteriores requieren una terminal, una versión compatible de Node.js y una máquina que permanezca encendida. Kimi Claw ofrece una opción completamente alojada, para que puedas ejecutar OpenClaw sin instalar ni mantener un entorno local.
Paso 1: Abre Kimi Claw y crea una instancia
Ve a la página de Kimi Claw y haz clic en Crear para comenzar.
Paso 2: Confirma el despliegue
Confirma el despliegue en la ventana emergente. Kimi Claw configurará automáticamente tu entorno de OpenClaw, incluidos el gateway y el workspace, sin requerir ninguna configuración local.
Paso 3: Empieza a usar tu workspace
Cuando el despliegue termine, tu workspace se abrirá en el panel. Puedes empezar a interactuar con tu agent, configurar habilidades, programar tareas y administrar archivos directamente desde el navegador.
Funciones clave de Kimi Claw
Alojamiento en la nube: Kimi Claw ejecuta tu gateway en la nube, de modo que tu agent sigue disponible incluso cuando tu equipo local está sin conexión.
Mantenimiento automático: Las actualizaciones y los parches se aplican en segundo plano, sin configuración manual ni reinicios.
Capacidades integradas: Incluye programación de tareas, almacenamiento persistente y carga dinámica de habilidades según tus prompts, con acceso fluido entre dispositivos.
Solución de errores comunes de instalación de OpenClaw
La mayoría de los problemas de instalación de OpenClaw se agrupan en unas cuantas categorías comunes, como la configuración de PATH, dependencias faltantes o conflictos de puertos. Las secciones siguientes te ayudan a identificar y resolver rápidamente los problemas más frecuentes en macOS, Windows y Linux.
"openclaw: command not found" después de la instalación
OpenClaw no está en el PATH de tu sistema.
Solución: Agrega el directorio bin global de npm a tu PATH.
Luego vuelve a cargar tu shell (p. ej., source ~/.zshrc) o reinicia la terminal. En Windows, agrega la ruta a tus variables de entorno y reinicia PowerShell.
Errores de compilación de Sharp en macOS
Esto suele ocurrir cuando un libvips instalado globalmente entra en conflicto con la biblioteca Sharp.
Solución: Ejecuta el comando de instalación con esta variable de entorno.
Si ves errores de node-gyp, instala Xcode Command Line Tools:
OpenClaw no inicia después de reiniciar
El daemon en segundo plano no se instaló durante el onboarding.
Solución: Ejecuta de nuevo el onboarding con el flag del daemon.
Luego verifica el servicio:
El gateway no responde o muestra "0 tokens used"
Es posible que el proceso del gateway se haya detenido o que haya fallado la autenticación de la API.
Solución: Reinicia el gateway.
Ejecuta una comprobación de estado:
Para ver registros de depuración:
Además, verifica que tu clave de API sea válida.
El puerto 18789 ya está en uso
Otro proceso está usando el puerto del gateway de OpenClaw.
Solución: Busca y detén el proceso en conflicto
Luego reinicia el gateway:
Errores de permisos EACCES
Esto suele significar que el directorio global de npm no tiene los permisos correctos.
Solución: Actualiza la propiedad del directorio.
En Windows, ejecuta PowerShell como administrador o define un prefijo npm personalizado:
Para configuraciones con Docker, corrige los permisos del volumen:
Error "spawn git ENOENT"
Git no está instalado o no está disponible en el PATH.
Solución: Instala Git desde git-scm.com, reinicia la terminal e intenta de nuevo la instalación.
systemd no funciona en WSL2
systemd no está habilitado en tu configuración de WSL.
Solución: Edita
/etc/wsl.confy agrega lo siguiente.
Luego reinicia WSL:
Vuelve a abrir tu terminal de Linux y verifica:
Falta de memoria durante npm install en VPS
Las instancias VPS con poca memoria pueden fallar durante la instalación de paquetes.
Solución: Crea un archivo swap.
Luego vuelve a ejecutar la instalación.
"Access not configured" al conectarte a plataformas de mensajería
Tu cuenta no está autorizada por OpenClaw.
Solución: Aprueba tu cuenta con el código de emparejamiento.
Además, verifica que las credenciales de tu bot (token, webhook, permisos) estén configuradas correctamente.
Conclusión
Instalar OpenClaw es sencillo en macOS, Linux y Windows. Puedes usar un script de una sola línea, PowerShell, WSL2 o npm, según tu configuración. El asistente de onboarding te guía en la selección del modelo, la configuración de la API y los canales de mensajería. Si prefieres no administrar un entorno local, Kimi Claw ofrece una opción completamente alojada que te permite ejecutar OpenClaw directamente en la nube.
Preguntas frecuentes
node --version para confirmar que tu versión cumple el requisito mínimo.npm install -g openclaw@latest desde la terminal. Esto actualiza la CLI a la versión más reciente. También puedes volver a ejecutar el instalador de una línea, que actualiza automáticamente tu instalación existente. OpenClaw también admite actualizaciones dentro de la app mediante la Control UI en 127.0.0.1:18789. Después de actualizar, reinicia el gateway con openclaw gateway restart para cargar la nueva versión.openclaw gateway status para confirmar que el daemon está activo. En Windows, WSL2 con systemd habilitado ofrece la configuración siempre activa más confiable. Si prefieres no administrar servicios locales, las opciones completamente alojadas como Kimi Claw te permiten ejecutar OpenClaw de forma continua en la nube.