Guía

Cómo instalar OpenClaw en un Mac mini

OpenClaw se instala en un Mac mini con un solo comando. Después, un paso de configuración inicial crea un servicio en segundo plano que arranca al iniciar sesión. Basta un Mac mini base con Apple silicon, porque el modelo se ejecuta en tu proveedor de IA, no en el Mac. Abajo tienes los comandos oficiales, la salida que obtuvimos en macOS 26 y los ajustes que lo mantienen en marcha.

Qué es OpenClaw

OpenClaw es un asistente de IA de código abierto que se ejecuta en tu propio ordenador. Le hablas desde las apps de chat que ya usas. Su README menciona Discord, iMessage, Slack, Teams, Telegram y WhatsApp, y más de 20 más (github.com/openclaw/openclaw, octubre de 2026).

La pieza central es el Gateway. Es un proceso de larga duración que mantiene tus conexiones de chat y ejecuta el agente. Si el Gateway se para, el asistente deja de responder. Por eso importa más la máquina donde vive que la instalación.

Requisitos

  • Node 24.16 o posterior, o Node 26.1 o posterior. En macOS, el instalador añade Node 26 si falta Node (docs.openclaw.ai/install, octubre de 2026).
  • Un proveedor de modelos. OpenClaw usa una clave de API del proveedor que elijas durante la configuración inicial.
  • Cualquier Mac con Apple silicon. La documentación no fija un mínimo de memoria. Con un modelo en la nube, 16 GB son de sobra. Un modelo local es otra historia, que se explica en nuestra guía de LLM en local.

Instálalo

Ejecuta el instalador oficial en Terminal.

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

Al terminar, te lleva a la configuración inicial. Si prefieres instalar primero y configurar después, la documentación da una opción que se salta la configuración inicial. Luego la ejecutas tú con la opción del servicio.

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

Ejecutamos el instalador en una máquina macOS 26 limpia alojada en GitHub el 2 de octubre de 2026. Node ya estaba instalado, así que tardó unos 25 segundos. Esto es lo que imprimió la comprobación de versión.

$ openclaw --version
OpenClaw 2026.9.7 (c074824)

Después comprueba la instalación y el servicio con los comandos documentados.

openclaw doctor
openclaw gateway status

En nuestra máquina de prueba, doctor señaló tres cosas antes de la configuración inicial. El modo del Gateway no estaba definido. La autenticación del Gateway no tenía token. Y no había ningún propietario de comandos. Ejecuta doctor otra vez tras la configuración inicial y resuelve lo que quede. Tómate en serio lo del propietario. Doctor lo describe como la cuenta que puede cambiar la configuración, reiniciar el Gateway y aprobar comandos.

Mantenlo en marcha 24/7

La opción del servicio instala un LaunchAgent. Según la documentación, su etiqueta es ai.openclaw.gateway y su archivo es ai.openclaw.gateway.plist, en la carpeta LaunchAgents de la Library de tu carpeta de inicio. launchd lo arranca al iniciar sesión y lo reinicia si se cae. Los logs van a un único archivo.

openclaw gateway status --deep
openclaw gateway restart
openclaw health
tail -f ~/Library/Logs/openclaw/gateway.log

También puedes instalar el servicio por separado, sin la configuración inicial. Lo hicimos en una segunda máquina de prueba. Pusimos el modo del Gateway en local, dejamos que doctor generara un token y ejecutamos el comando de instalación.

openclaw config set gateway.mode local
openclaw doctor --fix --generate-gateway-token
openclaw gateway install

Unos 15 segundos después, el comando de estado mostraba el servicio activo.

$ openclaw gateway status
Service file: ~/Library/LaunchAgents/ai.openclaw.gateway.plist
Gateway: bind=loopback (127.0.0.1), port=18789 (service args)
Dashboard: http://127.0.0.1:18789/
Gateway version: 2026.9.7
Runtime: running (pid 16165, state active)
Connectivity probe: ok
Listening: 127.0.0.1:18789

Un LaunchAgent solo se ejecuta mientras hay un usuario con la sesión iniciada. Tras un reinicio, no arranca nada hasta que alguien inicia sesión. En un Mac sin supervisión, activa el inicio de sesión automático de la cuenta que ejecuta OpenClaw. Después impide que la máquina entre en reposo, porque el reposo congela el Gateway y corta todas las conexiones de chat.

sudo pmset -a sleep 0
sudo pmset -a disksleep 0
sudo pmset -a displaysleep 10

Los motivos y las reglas de la tapa del portátil están en qué pasa cuando un Mac entra en reposo. La lista completa, incluidos los cortes de luz, está en la guía del Mac siempre encendido.

Notas de seguridad

  • En una instalación normal, el Gateway solo escucha en loopback. Déjalo así. Para abrir el panel desde tu portátil, la documentación usa un túnel SSH.
  • Los remitentes desconocidos en mensajes directos reciben un código de emparejamiento, no una respuesta. Los apruebas con el comando de emparejamiento de abajo.
  • Por defecto, las herramientas se ejecutan en el host, salvo que configures un sandbox. El agente puede tocar todo lo que puede tocar ese usuario de macOS.
  • Los secretos se guardan en disco en la carpeta de estado de OpenClaw, con la configuración en openclaw.json dentro de ella. Trata esa carpeta como un archivo de contraseñas.
  • Ejecuta la auditoría integrada tras cada cambio de configuración. En nuestra instalación de prueba limpia, informó de 0 críticos, 1 aviso y 1 elemento informativo.
ssh -N -L 18789:127.0.0.1:18789 user@gateway-host
openclaw pairing approve <channel> <code>
openclaw security audit

La protección más sencilla es física. Ejecuta OpenClaw en un Mac que no contenga nada más tuyo. Ni Apple ID personal, ni gestor de contraseñas, ni un navegador lleno de sesiones iniciadas. Si el agente hace algo raro, el daño se queda en esa máquina.

Ejecutarlo en un Mac de MacRun

Nuestro plan de agentes es un Mac mini dedicado que nunca entra en reposo. Su sesión vuelve sola tras un reinicio, así que los LaunchAgents arrancan otra vez. Viene con Claude Code y Codex instalados. OpenClaw no viene preinstalado. Lo instalas tú con los comandos de arriba, porque tienes acceso de administrador completo. OpenClaw necesita una clave de API del proveedor de modelos que elijas durante la configuración inicial.

Quién no debería usarnos para esto. MacRun es para trabajo de desarrollo, según nuestra política de uso aceptable. Encaja un OpenClaw que escribe código, vigila el CI o clasifica issues. No encaja uno que gestiona tu correo personal y el calendario familiar. Además, OpenClaw funciona en Linux. Si no necesitas nada de macOS, un servidor Linux pequeño cuesta menos que cualquier Mac.

¿Quieres probarlo en una máquina que no se apaga? Compara los planes en la página del Mac para agentes.

Preguntas frecuentes

¿Qué Mac mini necesito para OpenClaw?

+

Cualquier Mac mini con Apple silicon. La documentación de OpenClaw pide Node 24.16 o 26.1 y no fija un mínimo de memoria. Más memoria solo importa si además ejecutas un modelo local.

¿OpenClaw sigue funcionando tras un reinicio?

+

Sí, si instalaste el servicio con openclaw onboard --install-daemon y el usuario inicia sesión automáticamente. El servicio es un LaunchAgent, así que arranca al iniciar sesión, no al encender.

¿Qué necesito para conectar OpenClaw a un modelo?

+

Una clave de API del proveedor de modelos que elijas durante la configuración inicial. El uso lo factura ese proveedor según sus propias condiciones, no MacRun.

¿Cómo abro el panel de OpenClaw en un Mac remoto?

+

Deja el Gateway en loopback y reenvía su puerto 18789 por SSH, como muestra la documentación de acceso remoto de OpenClaw. Después ábrelo en tu propia máquina.

Guías relacionadas