Si usas Linux Mint como sistema operativo principal, estás en una posición privilegiada para correr OpenClaw: Linux es la plataforma donde el agente se comporta de manera más estable, más eficiente y con menor consumo de recursos que en Windows. Y lo mejor: el proceso de instalación en Linux Mint es más rápido que en cualquier otro sistema — en menos de 10 minutos puedes tener el agente funcionando.
Esta guía está pensada para usuarios de Linux Mint con conocimiento básico de la terminal. No necesitas ser programador, pero sí sentirte cómodo ejecutando comandos. Si eres nuevo en Linux Mint, cada paso viene explicado con suficiente contexto para que no te pierdas.
¿Todavía no sabes qué es OpenClaw ni para qué sirve? Lee primero nuestra guía completa de OpenClaw antes de continuar con la instalación.
¿Por qué Linux Mint es una excelente plataforma para OpenClaw?
OpenClaw fue construido sobre Node.js, un entorno de ejecución que históricamente funciona mejor en sistemas basados en Unix. Linux Mint, al estar basado en Ubuntu LTS, hereda toda la compatibilidad y estabilidad de ese ecosistema. Algunas ventajas concretas frente a Windows:
- Mejor gestión de recursos: Node.js consume menos RAM y CPU en Linux que en Windows para la misma carga de trabajo.
- Sin WSL2: En Windows, muchos usuarios instalan OpenClaw a través del Subsistema de Windows para Linux, añadiendo una capa extra de complejidad. En Linux Mint ese paso no existe — instalas directo.
- Mayor estabilidad: El proceso del Gateway de OpenClaw rara vez se interrumpe en Linux. En Windows, actualizaciones automáticas o el antivirus pueden detenerlo sin avisar.
- Compatibilidad nativa con PM2: El gestor de procesos PM2, esencial para mantener OpenClaw siempre activo incluso después de reiniciar el equipo, funciona de forma nativa en Linux sin configuraciones adicionales.
- Seguridad por diseño: El modelo de permisos de Linux limita lo que OpenClaw puede acceder, protegiéndote de errores de configuración graves.
Requisitos antes de instalar
Verifica que tu equipo cumple con lo siguiente antes de continuar:
| Componente | Mínimo | Recomendado |
|---|---|---|
| Linux Mint versión | 21.x (base Ubuntu 22.04) | 22.x (base Ubuntu 24.04) |
| RAM | 4 GB | 8 GB o más |
| Almacenamiento libre | 2 GB | 5 GB o más |
| Node.js | v22.16+ LTS | v24.x (recomendado) |
| Conexión a internet | Requerida durante instalación | Estable y continua |
| API key de IA | OpenAI o Anthropic | Cualquiera soportada |
⚠️ El error más común: Instalar OpenClaw con una versión antigua de Node.js. Las versiones v20 y anteriores generan errores de dependencias generalizados. Si ya tienes Node instalado, verifica con
node -vantes de continuar. Si ves v20 o menos, actualiza primero — el Paso 1 te explica cómo.
Paso 1: Instalar Node.js correctamente con NVM
Este es el paso más importante de toda la guía. NVM (Node Version Manager) es la forma recomendada de instalar Node.js en Linux porque te permite tener múltiples versiones coexistiendo y cambiar entre ellas sin conflictos — fundamental si tu equipo ya tiene otros proyectos con Node instalado.
Abre la terminal de Linux Mint (Ctrl + Alt + T) y ejecuta este comando para instalar NVM:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
Una vez que termina, cierra la terminal completamente y ábrela de nuevo. Este paso es obligatorio para que NVM quede disponible en la sesión. Luego verifica que se instaló:
nvm --version
Si ves un número de versión, NVM está listo. Ahora instala Node.js 24, la versión recomendada para OpenClaw en 2026:
nvm install 24
nvm use 24
nvm alias default 24
El último comando establece Node 24 como versión predeterminada para cada terminal nueva que abras. Verifica que todo quedó correcto:
node -v→ debe mostrarv24.x.x
npm -v→ debe mostrar un número de versión
Si ambos comandos responden con versiones, puedes continuar al siguiente paso.
Paso 2: Instalar OpenClaw
Tienes dos métodos. El primero es el más rápido y el recomendado para la mayoría de usuarios:
Método A: Script oficial (recomendado)
El script oficial detecta automáticamente tu sistema operativo, instala dependencias y lanza el asistente de configuración al terminar:
curl -fsSL https://openclaw.ai/install.sh | bash
El proceso tarda entre 2 y 5 minutos según tu conexión. Al terminar, lanza automáticamente el asistente interactivo de configuración.
Método B: vía npm (más control)
Si prefieres instalar manualmente o el script tuvo algún problema:
npm install -g openclaw@latest
Tras la instalación por cualquiera de los dos métodos, verifica que el CLI quedó disponible:
openclaw --version→ debe mostrar algo como2026.x.x
Si el comando no se reconoce, el directorio bin de npm no está en tu PATH. Agrégalo con:
export PATH="$PATH:$(npm prefix -g)/bin"
Para que el cambio sea permanente, agrega esa misma línea al final de tu archivo ~/.bashrc y ejecuta source ~/.bashrc.
Paso 3: Configuración inicial con el asistente interactivo
Si el script no lanzó el asistente automáticamente, inícialo tú:
openclaw onboard
El asistente recorre cuatro configuraciones en orden:
- Gateway: El puerto local donde correrá OpenClaw. El predeterminado es el
18789. Acepta el valor por defecto a menos que ese puerto esté ocupado por otra aplicación. - Modelo de IA: Elige el proveedor (OpenAI, Anthropic, Ollama para uso local, etc.) e ingresa tu API key cuando se solicite. Si no tienes una todavía, puedes obtenerla gratis con créditos iniciales en platform.openai.com o console.anthropic.com.
- Canal de mensajería: Elige desde qué app quieres controlar el agente. Telegram es el más sencillo para empezar en Linux — el proceso de conexión lleva menos de 5 minutos.
- Instalación como daemon: El asistente pregunta si quieres instalar OpenClaw como servicio de systemd. Responde sí — esto hace que el agente arranque automáticamente cada vez que enciendes Linux Mint, sin necesidad de ejecutar ningún comando.
Paso 4: Verificar que todo funciona
Con el daemon activo, revisa el estado del Gateway:
openclaw gateway status
Ejecuta el diagnóstico completo para confirmar que Node, la API key y el canal de mensajería están correctamente configurados:
openclaw doctor
Si algo falla, intenta la corrección automática:
openclaw doctor --fix
Finalmente, abre el dashboard visual en el navegador:
openclaw dashboard
Si el panel carga en tu navegador y muestra el agente activo, la instalación en Linux Mint fue exitosa.
Paso 5 (recomendado): Configurar PM2 para máxima estabilidad
Si instalaste OpenClaw como daemon de systemd en el paso anterior, este paso es opcional. Pero si prefieres PM2 — el gestor de procesos de Node.js más usado en producción — aquí tienes la configuración:
npm install -g pm2
pm2 start "openclaw gateway" --name openclaw
pm2 startup(Ejecuta el comando adicional que PM2 te muestre como resultado)
pm2 save
PM2 reinicia OpenClaw automáticamente si falla, sobrevive reinicios del equipo y guarda logs con fecha y hora. Para monitorear en tiempo real:
pm2 status
pm2 logs openclaw
Errores comunes en Linux Mint y cómo resolverlos
❌ «openclaw: command not found» después de instalar
El directorio bin de npm no está en tu PATH. Ejecuta npm prefix -g para ver la ruta de instalación global, luego agrega esa ruta + /bin al final de tu ~/.bashrc. Si instalaste con NVM, asegúrate de haber abierto una terminal nueva después de cada paso.
❌ Errores de compilación de Sharp o libvips
Ocurre cuando la versión de libvips del sistema difiere de la esperada. Solución: instala con esta variable de entorno adicional:
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest
❌ «No auth configured for provider» al iniciar
La API key no se guardó durante el onboarding. Configúrala manualmente:
openclaw config set model.provider openai
openclaw config set model.name gpt-4o
Luego ejecuta de nuevo openclaw onboard para completar la configuración del canal de mensajería.
❌ El Gateway se detiene al cerrar la terminal
El proceso corre en primer plano y está atado a la sesión de terminal activa. Implementa PM2 como se explicó en el Paso 5, o como alternativa temporal usa:
nohup openclaw gateway &
❌ Error de conectividad con Telegram en Docker
Si corres OpenClaw dentro de un contenedor Docker, agrega esta variable de entorno en tu configuración:
OPENCLAW_TELEGRAM_DISABLE_AUTO_SELECT_FAMILY=true
Esto resuelve conflictos IPv4/IPv6 en entornos de contenedor en Linux.
Configurar zona horaria para automatizaciones
Si configuras tareas programadas — un resumen de correos cada mañana, respaldos nocturnos, alertas periódicas — asegúrate de que OpenClaw trabaje con tu zona horaria local, no con UTC:
openclaw config set TZ "America/Mexico_City"
Otras zonas frecuentes: America/Bogota · America/Lima · America/Argentina/Buenos_Aires · America/Santiago · Europe/Madrid
Comandos esenciales de referencia rápida
| Qué quieres hacer | Comando |
|---|---|
| Verificar versión de Node | node -v |
| Verificar versión de OpenClaw | openclaw --version |
| Diagnosticar problemas | openclaw doctor |
| Ver estado del Gateway | openclaw gateway status |
| Abrir dashboard en navegador | openclaw dashboard |
| Ver configuración actual | openclaw config show |
| Reiniciar con PM2 | pm2 restart openclaw |
| Ver logs en tiempo real | pm2 logs openclaw |
| Actualizar OpenClaw | npm update -g openclaw |
¿Qué laptop con Linux Mint funciona mejor para OpenClaw?
Linux Mint tiene soporte de drivers excelente en hardware Lenovo, especialmente en la línea ThinkPad. Para mantener OpenClaw activo todo el día sin depender de corriente, la batería y la gestión de energía importan tanto como el procesador. Nuestras dos recomendaciones:
- Lenovo ThinkPad E16 Gen 2 — 16 GB RAM, Intel Core Ultra, hasta 13 horas de batería, soporte Linux certificado. La opción más robusta para OpenClaw corriendo como daemon 24/7.
- Lenovo IdeaPad 5i Gen 9 — 16 GB RAM, precio más accesible, excelente compatibilidad con Linux Mint. La opción equilibrada para trabajo diario desde casa.
Consulta nuestra guía de laptops para OpenClaw con precios actualizados en Amazon.
Nota de seguridad para usuarios de Linux
El modelo de permisos de Linux te protege por diseño, pero hay dos medidas adicionales recomendadas. Primero, nunca ejecutes OpenClaw como usuario root — usa siempre tu usuario normal del sistema. Segundo, si accedes al agente desde redes externas (WiFi públicos, coworkings), protege tu tráfico con una VPN. Linux Mint soporta configurar VPN directamente desde el panel de red, y NordVPN ofrece cliente de línea de comandos para Linux con instalación en un solo comando. Más detalles en nuestra guía de seguridad y privacidad para OpenClaw.
Conclusión
Instalar OpenClaw en Linux Mint es, si cabe, más limpio y estable que en Windows. Sin capas intermedias como WSL2, sin antivirus que interfiera, sin reinicios forzados por actualizaciones automáticas del sistema. El resultado es un agente de IA más eficiente, más seguro y que consume menos recursos que en cualquier otra plataforma de escritorio.
Si seguiste todos los pasos y OpenClaw está corriendo como daemon o bajo PM2, tienes ahora un asistente que trabaja 24/7 en tu Linux Mint, al que puedes dar instrucciones desde WhatsApp o Telegram sin siquiera abrir la laptop.