OpenClaw puede instalarse en Mac de varias formas, según cómo prefieras trabajar y administrar tu configuración. En esta guía encontrarás instrucciones paso a paso para distintos métodos de instalación, además de consejos para que OpenClaw funcione sin problemas.
Resumen rápido: tres formas de instalar OpenClaw en Mac
Aquí tienes una comparación lado a lado de los tres métodos. Cada uno requiere un nivel distinto de configuración manual.
| Instalador de una sola línea | Homebrew | Kimi Claw (en línea) | |
|---|---|---|---|
| Qué es | Script de instalación oficial que descarga y configura OpenClaw automáticamente | Configuración manual con Homebrew para instalar dependencias (como Node.js) y luego ejecutar OpenClaw mediante la CLI | Herramienta en línea que te permite ejecutar OpenClaw en la nube sin configuración manual |
| Pasos manuales requeridos | Pasos manuales mínimos | Requiere varios pasos manuales | No requiere configuración manual |
| Requiere código o terminal | Sí | Sí | No |
| Disponibilidad 24/7 | Solo se ejecuta mientras tu Mac está activa | Solo se ejecuta mientras tu Mac está activa | Se ejecuta 24/7 en la nube |
| Ideal para | Usuarios primerizos que quieren la configuración local más rápida | Desarrolladores que prefieren administrar paquetes con Homebrew | Usuarios que quieren ejecutar OpenClaw sin configuración local |
Kimi Claw te permite ejecutar OpenClaw en la nube sin configurar Node.js, Homebrew ni claves de API. En cuestión de minutos puedes empezar a usar un agent funcional desde tu navegador.
Si prefieres una configuración local, continúa con la siguiente sección. Si quieres una opción más sencilla, ve a la sección Ejecutar OpenClaw en Mac con Kimi Claw o haz clic en el botón de abajo para empezar al instante.
Antes de empezar: preparación esencial y seguridad
Antes de instalar OpenClaw localmente en Mac, debes completar algunos pasos de preparación y seguridad. Si planeas usar Kimi Claw, puedes omitir esta sección e ir directamente a las instrucciones de configuración más abajo.
Dependencias: El instalador de una sola línea instala Node.js automáticamente si hace falta. Si eliges Homebrew, debes instalar Node.js manualmente (se recomienda Node 24; Node 22 LTS 22.16+ también funciona).
Firewall y configuración de red: El firewall de macOS suele estar desactivado de forma predeterminada. Puedes activarlo en Configuración del Sistema > Red > Firewall. OpenClaw vincula el gateway a 127.0.0.1 (localhost), por lo que otros dispositivos de tu red no pueden conectarse directamente. Si necesitas acceso móvil o remoto, puedes usar herramientas como Tailscale o un túnel SSH. No redirijas el puerto
18789a través de tu router.
Instalar OpenClaw en Mac con el script de una sola línea
Esta es la forma más rápida de ejecutar OpenClaw localmente en Mac. OpenClaw se ejecuta desde la Terminal y ofrece una interfaz basada en navegador para administrar tu agent, en lugar de una app gráfica tradicional. Un solo comando instala la CLI, comprueba tu versión de Node.js e inicia el asistente de configuración inicial.
Paso 1. Ejecuta el script de instalación en la Terminal
Abre Terminal con Spotlight (⌘ + Space) y pega el siguiente comando:
El script detecta tu sistema, instala la CLI de OpenClaw y comprueba tu versión de Node.js. Si Node.js no está instalado o está desactualizado, instala Node 24 automáticamente (también se admite Node 22 LTS 22.16+).
Paso 2. Establece tu clave de API y configura el gateway
El asistente de configuración inicial se inicia automáticamente al terminar la instalación. Selecciona Moonshot AI (Kimi K2.5) como proveedor de LLM y pega tu clave de Kimi API cuando se te solicite. Acepta la configuración predeterminada del puerto del gateway y la autenticación. Si quieres que OpenClaw se inicie automáticamente al arrancar tu Mac, elige la opción de instalación del daemon durante la configuración inicial.
Paso 3. Verifica el gateway y abre el dashboard
Ejecuta el siguiente comando para comprobar que el gateway está en ejecución:
Luego abre el dashboard:
Este comando abre la interfaz de control en tu navegador en http://127.0.0.1:18789. Ingresa tu token del gateway para iniciar sesión. Una vez que hayas iniciado sesión, podrás empezar a interactuar con tu agent de OpenClaw.
Instalar OpenClaw en Mac con Homebrew
Si prefieres administrar paquetes con Homebrew, puedes instalar OpenClaw en Mac con una configuración más manual. Este método te da más control sobre las dependencias y se integra con tu flujo de trabajo actual en Homebrew.
Paso 1. Instala Homebrew
Abre Terminal con Spotlight (⌘ + Space). Si no tienes Homebrew instalado, ejecuta el siguiente comando. Homebrew es un gestor de paquetes para macOS que te permite instalar y administrar herramientas de desarrollo desde la Terminal, de forma similar a como una tienda de apps instala aplicaciones.
Durante la instalación, es posible que se te pida ingresar la contraseña de inicio de sesión de tu Mac. Ten en cuenta que, por seguridad, la Terminal no mostrará ningún carácter mientras escribes. También podrías ver solicitudes para confirmar la instalación y mensajes que muestran los archivos que se están instalando.
Cuando termine la instalación, verás un mensaje de éxito y los siguientes pasos en la Terminal.
Paso 2. Instala Node.js
Una vez instalado Homebrew, instala Node.js:
Después de la instalación, confirma que la versión sea v24 (recomendada) o v22.16+.
Paso 3. Instala la CLI de OpenClaw y ejecuta la configuración inicial
Instala la CLI globalmente con npm y luego ejecuta la configuración inicial:
Si aparece un error de permisos EACCES durante npm install -g, tu directorio global de npm necesita acceso elevado. Ejecuta sudo npm install -g openclaw@latest o cambia el directorio predeterminado de npm para evitar usar sudo en el futuro.
La marca --install-daemon registra OpenClaw como LaunchAgent, de modo que el gateway se inicia automáticamente cuando inicias sesión. Durante la configuración inicial, selecciona Moonshot AI (Kimi K2.5) como proveedor e ingresa tu clave de Kimi API.
Paso 4. Comprueba el gateway y abre el dashboard
Verifica que el gateway esté en ejecución y abre el dashboard:
La interfaz de control se abre en tu navegador. Ingresa tu token del gateway y listo.
Ejecutar OpenClaw en Mac con Kimi Claw
Kimi Claw es una herramienta en línea que te permite ejecutar OpenClaw en la nube sin configuración local. No tienes que instalar nada en tu Mac ni usar la Terminal ni administrar dependencias. Todo funciona en tu navegador. Puedes crear un agent de OpenClaw en minutos. Kimi Claw se encarga del gateway, el workspace, el almacenamiento y el acceso al modelo, para que tu agent permanezca en línea 24/7, incluso cuando tu MacBook esté cerrado.
¿Cómo usar Kimi Claw?
Paso 1. Abre Kimi Claw
Ve a la página de Kimi Claw y haz clic en Crear para comenzar a desplegar tu entorno de OpenClaw.
Paso 2. Despliega OpenClaw automáticamente
Confirma el despliegue en la ventana emergente. Luego Kimi Claw configura el entorno de OpenClaw, incluidos el gateway, el workspace y las herramientas. El proceso suele terminar en pocos minutos.
Paso 3. Empieza a usar OpenClaw
Cuando finalice el despliegue, tu workspace se abrirá en el dashboard. Empieza a chatear con tu agent, configura skills, programa tareas y administra archivos, todo desde el navegador.
En qué se diferencia Kimi Claw de ejecutar OpenClaw localmente
Kimi Claw ofrece una forma más sencilla de ejecutar OpenClaw sin configuración local. En lugar de instalar dependencias y administrar un entorno local, puedes ejecutar tu agent directamente en el navegador mientras Kimi Claw se encarga de la configuración y la infraestructura subyacentes.
No requiere configuración local: Ejecuta OpenClaw sin instalar Node.js ni usar la Terminal. Todo funciona directamente en tu navegador, así puedes empezar más rápido y evitar problemas de configuración del entorno.
Acceso instantáneo a más de 5,000 skills: En lugar de instalar herramientas manualmente, Kimi Claw puede usar automáticamente las skills necesarias para tu tarea desde una amplia biblioteca de herramientas disponibles, lo que reduce el tiempo de configuración y los problemas de compatibilidad.
Automatización y programación siempre activas: A diferencia de los agentes locales, que se detienen cuando tu Mac entra en reposo, Kimi Claw se ejecuta 24/7 en la nube, por lo que es adecuado para tareas programadas y flujos de trabajo de larga duración.
40GB de almacenamiento en la nube y memoria persistente: A diferencia de las configuraciones locales, donde los archivos suelen quedar vinculados a un solo dispositivo, Kimi Claw incluye 40GB de almacenamiento, lo que permite acceder a tus informes e investigaciones desde cualquier navegador. También recuerda tus preferencias y el contexto de trabajo entre sesiones, para que puedas continuar donde lo dejaste.
Modelo Kimi K2.5 integrado y búsqueda de nivel profesional: Kimi Claw incluye acceso integrado a Kimi K2.5 y capacidades de búsqueda avanzadas, por lo que no necesitas administrar claves de API ni configurar servicios externos. Puede incorporar automáticamente información actualizada de áreas como finanzas, tecnología y noticias, para que la investigación y la ejecución de tareas sean más fluidas.
Mantener OpenClaw en ejecución 24/7 en Mac
La mayoría de los usuarios trata la AI como una app de escritorio tradicional: la usan mientras están frente a la computadora y la cierran al terminar. Para automatizaciones valiosas, como monitorear mercados globales durante la noche o tener un informe de investigación listo en tu bandeja de entrada a las 8 AM, tu agent debe permanecer activo todo el tiempo. Como macOS pausa de forma natural los procesos locales cuando el sistema entra en reposo, lograrlo requiere una estrategia específica. En esta sección se explican dos formas de mantener una conexión persistente:
Opción A: hardware Mac dedicado
Una opción es mantener una Mac (por ejemplo, una Mac mini) en ejecución continua. Puedes desactivar el reposo con sudo pmset -a sleep 0 y activar “Activar para acceso a la red” en Configuración del Sistema. Para el acceso remoto, puedes usar herramientas como Tailscale o un túnel SSH.
Esta configuración mantiene OpenClaw ejecutándose en tu propio hardware, pero exige dejar la máquina encendida y encargarte del mantenimiento, las actualizaciones y los reinicios.
Opción B: Kimi Claw se encarga automáticamente
Si ejecutas tu agent con Kimi Claw, la disponibilidad 24/7 viene integrada. Tu agent se ejecuta de forma independiente de tu dispositivo local, por lo que sigue trabajando incluso cuando tu Mac está cerrada o sin conexión. No hace falta ajustar la configuración de reposo ni mantener una máquina encendida.
Solucionar errores comunes de instalación de OpenClaw en Mac
Incluso con una configuración sencilla, pueden surgir problemas durante la instalación. Estos son algunos problemas comunes y cómo solucionarlos.
Error de comando OpenClaw no encontrado
Causa: El directorio bin global de npm no está en el PATH de tu shell.
Solución: Ejecuta
source ~/.zshrcpara volver a cargar la configuración de tu shell. Si usas Bash en lugar de Zsh, reemplaza~/.zshrcpor~/.bash_profile. Si el error persiste, busca tu prefijo de npm y agrégalo al PATH:
OpenClaw no se inicia después de reiniciar
Causa: El LaunchAgent no se instaló durante la configuración inicial.
Solución: Ejecuta el comando de configuración inicial con la marca de daemon:
Esto registra un LaunchAgent que inicia automáticamente el gateway de OpenClaw cuando inicias sesión. Para verificar que esté activo:
El puerto 18789 ya está en uso
Causa: Otro proceso está ocupando el puerto del gateway.
Solución: Busca y detén el proceso en conflicto:
Error de Xcode Command Line Tools durante la instalación de skills
Causa: Algunos paquetes de npm requieren compilación nativa, y las Xcode Command Line Tools faltan o están desactualizadas.
Solución: Instala o actualiza las herramientas:
Cuando termine la instalación, intenta instalar la skill nuevamente.
Versión de Node.js demasiado antigua
Causa: Tu Mac tiene instalada una versión de Node.js anterior a la 22.16. OpenClaw requiere Node 24 (recomendado) o Node 22 LTS 22.16+.
Solución: Si usaste Homebrew:
Si usaste el instalador de una línea, ejecútalo de nuevo. El script detectará la versión desactualizada y la actualizará.
Conclusión
OpenClaw puede ejecutarse localmente en tu Mac con el instalador de una línea o con Homebrew, o en tu navegador con Kimi Claw sin configuración local. Cada método te permite tener un agent funcionando, pero exige un nivel distinto de esfuerzo manual. Si quieres una configuración más rápida con disponibilidad 24/7 integrada, puedes empezar con Kimi Claw y tener tu agent en ejecución en cuestión de minutos.
Preguntas frecuentes
openclaw onboard --install-daemon para registrar un LaunchAgent que inicie el gateway al iniciar sesión. Si el daemon ya está instalado pero no arranca, revisa su estado con launchctl list | grep openclaw y consulta los registros del sistema. Los usuarios de Kimi Claw no necesitan esta configuración, porque el servicio se ejecuta en servidores en la nube y permanece en línea de forma independiente.source ~/.zshrc para recargar la configuración. Si el comando sigue sin encontrarse, ejecuta npm config get prefix para ubicar el directorio bin y agrégalo a tu PATH en ~/.zshrc. Reinicia Terminal después de hacer el cambio.sudo pmset -a sleep 0) y acceso remoto mediante Tailscale, o usar Kimi Claw. Kimi Claw es una plataforma totalmente administrada que mantiene tu agent de OpenClaw en línea las 24 horas, sin hardware que mantener.curl -fsSL https://openclaw.ai/install.sh | bash. El script instala OpenClaw, comprueba tu versión de Node.js y te guía por la configuración. También puedes usar Homebrew: ejecuta brew install node y luego npm install -g openclaw@latest. Si prefieres una opción totalmente administrada que no requiere terminal, Kimi Claw ejecuta OpenClaw en tu navegador, sin configuración local.curl -fsSL https://openclaw.ai/install.sh | bash) o instala mediante Homebrew con npm install -g openclaw@latest. Si buscas una opción basada en navegador que no requiera descarga, Kimi Claw ejecuta OpenClaw por ti en servidores en la nube.