Cómo instalar NanoClaw en un Mac mini

Qué es NanoClaw

NanoClaw es un asistente de IA de código abierto que ejecutas en tu propio ordenador. Está escrito en TypeScript con licencia MIT. Su README lo presenta como una alternativa ligera a OpenClaw (github.com/nanocoai/nanoclaw, consultado el 2 de octubre de 2026). La última versión era la 2.4.0, del 23 de septiembre de 2026.

La gran diferencia es el aislamiento. Cada agente se ejecuta dentro de su propio contenedor Linux. Solo ve las carpetas que montas en él. El agente está construido sobre el Claude Agent SDK de Anthropic. Hablas con él desde apps de chat como WhatsApp, Telegram, Discord, Slack, Teams o iMessage. Cada canal se añade con su propia skill de configuración.

Requisitos

Vienen de la documentación de instalación de NanoClaw (docs.nanoclaw.dev).

• macOS o Linux, con al menos 4 GB de memoria. El instalador avisa por debajo de 3.700 MB.
• Git, para descargar el código. El instalador no lo añade por ti.
• Docker Desktop en macOS. Los agentes se ejecutan en contenedores Docker. El instalador añade Docker Desktop con Homebrew si falta.
• Node 22 o posterior y pnpm 10 o posterior. El instalador añade los dos si faltan.
• Claude Code en el Mac. NanoClaw lo usa para arreglar pasos de configuración que fallan y para añadir canales.
• Una credencial de modelo. La configuración ofrece Claude o Codex. Esta guía usa una clave de API de Anthropic, que Anthropic factura por uso.

Instálalo

Primero comprueba que tienes Git. Si sale una línea que empieza por git version, lo tienes.

git --version

Después ejecuta estos cuatro comandos de la guía rápida oficial, línea a línea.

cd ~
git clone https://github.com/nanocoai/nanoclaw.git
cd nanoclaw
bash nanoclaw.sh

El script revisa la máquina e instala lo que falta. Después, un asistente de configuración hace unas cuantas preguntas. La documentación sugiere Standard setup y luego Fresh agent. Calcula de 30 a 60 minutos para todo el proceso.

• Imagen del sandbox. Fetch the hardened image necesita una cuenta gratuita de NanoClaw. Build it here no necesita cuenta y tarda varios minutos.
• Servicio de IA. Elige Claude y luego Paste an Anthropic API key. La configuración guarda la clave en un almacén local llamado OneCLI. Nunca entra en el contenedor del agente.
• Servicio. La configuración arranca NanoClaw en segundo plano y envía un mensaje de prueba para comprobar que el agente responde.

La configuración también ofrece iniciar sesión con una suscripción. Si piensas usar una, revisa antes las condiciones de tu proveedor sobre herramientas de terceros.

Tras la configuración, envía un mensaje desde la carpeta nanoclaw. El texto entre comillas es tu mensaje. Para repetir la comprobación completa, usa el paso verify.

cd ~/nanoclaw
pnpm run chat "Help me plan one of those weekend ideas."
pnpm run setup -- --step verify

Todavía no hemos hecho esta instalación en nuestra propia máquina de prueba. Los comandos de arriba están copiados de la documentación de NanoClaw a 2 de octubre de 2026. Vuelve a comprobarlos antes de empezar.

Mantenlo en marcha 24/7

La configuración instala un LaunchAgent en la carpeta LaunchAgents de la Library de tu carpeta de inicio. Su nombre es parecido a com.nanoclaw-v2 más un código corto de tu copia. Tiene RunAtLoad y KeepAlive activados. Así que arranca al iniciar sesión y se reinicia si se cae. Estos son los comandos documentados.

# Find your label
launchctl list | grep nanoclaw

# Restart
launchctl kickstart -k gui/$(id -u)/com.nanoclaw-v2-<slug>

# Stop / start
launchctl unload ~/Library/LaunchAgents/com.nanoclaw-v2-<slug>.plist
launchctl load   ~/Library/LaunchAgents/com.nanoclaw-v2-<slug>.plist

# Logs (stdout and stderr go to files, not the system log)
tail -f logs/nanoclaw.log logs/nanoclaw.error.log

Docker también tiene que estar en marcha. Si no lo está, no puede arrancar ningún agente. La documentación de solución de problemas dice que arranques Docker Desktop, compruebes que docker info funciona y luego reinicies NanoClaw. En los ajustes de Docker Desktop, activa la opción de arrancarlo al iniciar sesión.

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 NanoClaw. Después impide que el Mac entre en reposo. El reposo pausa Docker y corta todas las conexiones de chat.

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

Los motivos 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

• Los agentes solo ven las carpetas que permites. El archivo de la lista es mount-allowlist.json en ~/.config/nanoclaw, fuera de la copia del repo. En una instalación nueva empieza vacío.
• Los agentes nunca tienen tu clave de API en claro. Las peticiones salientes pasan por el almacén, que añade la clave en el momento de la petición.
• La configuración envía diagnósticos anónimos. Define NANOCLAW_NO_DIAGNOSTICS=1 para desactivarlos.
• La documentación tiene una página de refuerzo para configuraciones más estrictas. Cubre límites al acceso a la red, quién puede escribir al agente y qué comandos puede ejecutar.

Los contenedores ayudan, pero una máquina dedicada ayuda más. Ejecuta NanoClaw en un Mac que no contenga nada más tuyo. Si el agente hace algo raro, el daño se queda en esa máquina. Para eliminarlo más adelante, la documentación da una opción de desinstalación. Añade --dry-run para ver antes qué eliminaría.

bash nanoclaw.sh --uninstall

Ejecutarlo en un Mac de MacRun

Nuestro plan de agentes es un Mac mini dedicado que nunca entra en reposo. Está en nuestras propias instalaciones privadas en Nueva Jersey. Su sesión vuelve sola tras un reinicio, así que los LaunchAgents arrancan otra vez. Claude Code y Codex vienen preinstalados, lo que cubre la necesidad de NanoClaw de tener Claude Code. NanoClaw y Docker Desktop no vienen preinstalados. Los instalas tú, porque tienes acceso de administrador completo.

El M6 base tiene 16 GB de memoria, muy por encima del mínimo de 4 GB. El plan de agentes cuesta $169 al mes. MacRun no vende claves de API. Usa una clave de API de tu proveedor de modelos, que te factura el uso según sus propias condiciones.

Cuándo no necesitas MacRun

Si ya tienes un Mac que sigue encendido y con la sesión iniciada, úsalo. Los pasos de arriba son los mismos. NanoClaw también funciona en Linux con Docker Engine. Si no necesitas nada de macOS, un servidor Linux pequeño cuesta menos que cualquier Mac.

Además, MacRun es para trabajo de desarrollo, según nuestra política de uso aceptable. Encaja un NanoClaw que revisa código, vigila el CI o escribe notas de versión. No encaja uno que gestiona el chat de tu familia. ¿Quieres probarlo en una máquina que no se apaga? Mira la página del Mac para agentes.