Cómo instalar nanobot en un Mac mini

Qué es nanobot

nanobot es un agente de IA personal de código abierto del grupo HKUDS en GitHub. Está escrito en Python con licencia MIT. Igual que OpenClaw, guarda memoria, ejecuta herramientas y te responde desde apps de chat. Su núcleo se mantiene pequeño y legible (github.com/HKUDS/nanobot, consultado el 2 de octubre de 2026). La última versión en PyPI era la 0.3.5, del 15 de septiembre de 2026.

Puedes usarlo en una WebUI en el navegador, en la terminal o desde Telegram, Discord, Slack, email y otros canales. Puede trabajar con archivos, ejecutar comandos de shell, buscar en la web, usar servidores MCP y ejecutar tareas programadas. Una nota más sobre el nombre. No es obot-platform/nanobot, que es un framework en Go para crear agentes MCP.

Requisitos

• Python 3.11 o posterior. Compruébalo con python3 --version. El instalador se detiene si no lo encuentra, así que instala Python antes si hace falta.
• macOS 13 o posterior. Los paquetes precompilados para Mac con Apple silicon y con Intel incluyen la WebUI y la interfaz de terminal.
• Un proveedor de modelos. Anthropic, OpenAI, OpenRouter y servidores locales como Ollama aparecen todos en la documentación de proveedores. Usa una clave de API del proveedor que elijas.
• Git y Bun, pero solo si instalas desde el código fuente. La instalación normal no los necesita.

Instálalo

Ejecuta el instalador oficial de un solo comando del README.

curl -fsSL https://raw.githubusercontent.com/HKUDS/nanobot/main/scripts/install.sh | sh

Instala el paquete nanobot-ai desde PyPI. Evita las instalaciones de pip a nivel de sistema. Usa un entorno virtual activo, uv, pipx o su propio entorno en la carpeta .nanobot de tu carpeta de inicio. Después imprime el comando exacto que usó. Para ver el plan sin cambiar nada, añade la opción de prueba en seco.

curl -fsSL https://raw.githubusercontent.com/HKUDS/nanobot/main/scripts/install.sh | sh -s -- --dry-run

Si ya usas uv, esto hace lo mismo. Después comprueba la versión.

uv tool install nanobot-ai
nanobot --version

Primera ejecución y un modelo

El README recomienda la WebUI para la primera ejecución. Se abre en 127.0.0.1, puerto 8765, y solo escucha en este Mac.

nanobot webui

Abre Settings y luego Models. Elige un proveedor, pega su clave de API y escoge un modelo. Después abre un tema nuevo y envía Hello. Cualquier respuesta normal significa que el proveedor, el modelo y el gateway funcionan juntos. Desde la terminal, un mensaje único hace la misma comprobación.

nanobot -m "Hello!"

Los ajustes se guardan en config.json, en la carpeta .nanobot de tu carpeta de inicio. Todavía no hemos hecho esta instalación en nuestra propia máquina de prueba. Los comandos de aquí están copiados del README y la documentación de nanobot a 2 de octubre de 2026.

Mantenlo en marcha 24/7

El gateway es la parte que sigue en línea. Mantiene activas las apps de chat, las tareas programadas y el trabajo de memoria. Este comando lo mantiene en marcha después de cerrar la terminal.

nanobot gateway --background

Eso no sobrevive a un reinicio. Para eso, la documentación de despliegue instala un LaunchAgent. Termina primero la configuración del modelo en la WebUI. Después revisa el archivo del servicio e instálalo.

nanobot gateway install-service --manager launchd --dry-run
nanobot gateway install-service --manager launchd

Escribe ai.nanobot.gateway.plist en la carpeta LaunchAgents de la Library de tu carpeta de inicio. Arranca el gateway con el mismo Python que instaló nanobot. Los logs van a la carpeta logs dentro de .nanobot. Si falla con address already in use, para primero el gateway que arrancaste a mano.

launchctl list | grep ai.nanobot.gateway
launchctl kickstart -k gui/$(id -u)/ai.nanobot.gateway
nanobot gateway uninstall-service --manager launchd

El gateway solo lee config.json al arrancar. Reinícialo después de cada cambio de configuración.

Un LaunchAgent solo se ejecuta mientras hay un usuario con la sesión iniciada. En un Mac sin supervisión, activa el inicio de sesión automático de la cuenta que ejecuta nanobot. Después impide que el Mac entre en reposo, porque el reposo pausa el gateway y sus tareas programadas.

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

Hay más detalles en qué pasa cuando un Mac entra en reposo y en la guía del Mac siempre encendido.

Notas de seguridad

• Para producción, la documentación aconseja dos ajustes a la vez. Pon restrictToWorkspace a true y tools.exec.sandbox a seatbelt en macOS. Seatbelt limita los comandos de shell a la carpeta del espacio de trabajo.
• Ninguno de los dos ajustes limita el acceso a la red. Guarda los secretos fuera del espacio de trabajo.
• La WebUI y la comprobación de estado del gateway escuchan en 127.0.0.1 por defecto. Déjalas solo en este Mac.
• Los remitentes desconocidos en las apps de chat reciben un código de emparejamiento, no una respuesta. Los apruebas con /pairing approve y su código.
• La documentación sugiere referencias a variables de entorno para las claves de API, en lugar de claves en claro en config.json. En cualquier caso, trata la carpeta .nanobot como un archivo de contraseñas.

La protección más sencilla es un Mac que no contenga nada más tuyo. 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. Está en nuestras propias instalaciones privadas en Nueva Jersey. Su sesión vuelve sola tras un reinicio, así que el LaunchAgent de nanobot arranca otra vez. Claude Code y Codex vienen preinstalados. nanobot no. Lo instalas tú, junto con Python si hace falta, porque tienes acceso de administrador completo.

Puedes abrir la WebUI en el navegador del propio Mac desde nuestro escritorio en el navegador. 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

nanobot es pequeño y funciona casi en cualquier sitio. La documentación cubre servicios en Linux, Docker y un despliegue en Render con un clic. Si no necesitas nada de macOS, cualquiera de esas opciones cuesta menos que un Mac. Y si ya tienes un Mac que sigue encendido y con la sesión iniciada, usa ese.

MacRun es para trabajo de desarrollo, según nuestra política de uso aceptable. Encaja un nanobot que clasifica issues o hace tareas nocturnas en el repo. No encaja uno que gestiona tu bandeja de entrada personal. Para comparar planes, mira la página del Mac para agentes.