NanoClaw

Tu agente de IA personal. Seguro. Ligero. Tuyo.

NanoClaw se ejecuta de forma segura en contenedores, diseñado para ser comprendido y personalizado según tus necesidades.

estrellas en GitHub

¿Por qué NanoClaw?

NanoClaw ofrece la misma funcionalidad principal en un código que realmente puedes entender.

NanoClaw
OpenClaw
Archivos fuente 15 3.680
Líneas de código ~3.900 434.453
Dependencias <10 70
Archivos de configuración 0 53
Tiempo para entenderlo 8 minutos 1–2 semanas
Modelo de seguridad Aislamiento por contenedores del SO Verificaciones a nivel de aplicación
Arquitectura Un solo proceso + contenedores aislados Un solo proceso, memoria compartida

Qué incluye

Todo lo que NanoClaw incluye de serie, y nada que no necesites.

💬

Apps de mensajería

WhatsApp, Telegram y más. Envía mensajes a tu agente NanoClaw desde tu teléfono a través de las apps que ya usas.

🔒

Aislamiento en contenedores

Los agentes se ejecutan en Apple Container (macOS) o Docker. Solo pueden ver lo que montes explícitamente.

🐝

Enjambres de agentes NUEVO

NanoClaw puede crear equipos de agentes especializados que colaboran en tareas complejas. La primera IA personal que lo soporta.

🧠

Memoria por grupo

Cada grupo tiene su propia memoria CLAUDE.md, sistema de archivos aislado y se ejecuta en su propio contenedor.

Tareas programadas

Trabajos recurrentes que ejecutan Claude y te envían la respuesta. Resúmenes matutinos, revisiones semanales y más.

🧩

Sistema de skills

Amplía la funcionalidad sin complejidad innecesaria. Añade Gmail, Telegram u otras capacidades mediante skills.

Configuración nativa de IA

Sin asistentes de instalación. Claude Code guía todo: dependencias, autenticación, contenedores, servicios.

🌐

Acceso web

NanoClaw puede buscar en la web, obtener contenido y navegar páginas para investigar cualquier tema.

Arquitectura

NanoClaw es un solo proceso Node.js. Agentes en contenedores aislados. 15 archivos fuente.

Mensaje entrante
WhatsApp / Telegram
SQLite
almacenar y deduplicar
Cola de grupo
FIFO por grupo
Contenedor
Claude Agent SDK
Respuesta
transmitida en streaming

Un solo proceso

Un único proceso Node.js consulta mensajes, gestiona colas, inicia contenedores y maneja IPC. Sin microservicios, sin brokers de mensajes.

Aislamiento por grupo

Cada grupo obtiene su propio contenedor, sistema de archivos, espacio de nombres IPC y sesión de Claude. Los grupos no pueden acceder a los datos de otros grupos.

Control de concurrencia

GroupQueue limita los contenedores simultáneos (por defecto: 3). Orden FIFO por grupo con reintentos en caso de fallo usando retroceso exponencial.

IPC mediante sistema de archivos

Los contenedores se comunican con el host a través de archivos JSON en directorios por grupo. El host consulta, valida la autorización, ejecuta y limpia.

Archivos clave

index.ts — Orquestador — bucle de consulta, procesamiento de mensajes, invocación de agentes
container-runner.ts — Inicia contenedores con montajes aislados, transmite la salida en streaming
group-queue.ts — Cola FIFO por grupo con límites de concurrencia y retroceso en reintentos
ipc.ts — Procesa solicitudes IPC de contenedores con verificaciones de autorización
db.ts — SQLite — mensajes, sesiones, grupos, tareas, estado del router
task-scheduler.ts — Ejecución de tareas programadas con cron, intervalos y ejecución única

Filosofía

Los principios que guían cada decisión en NanoClaw.

🔍

Lo bastante pequeño para entenderlo

NanoClaw es un solo proceso y un puñado de archivos fuente. Lo suficientemente pequeño como para que puedas leer y entender todo el código.

🛡️

Seguro por aislamiento

Los agentes se ejecutan en contenedores Linux. Solo pueden ver lo que se monta explícitamente. Bash es seguro porque se ejecuta dentro del contenedor.

👤

Diseñado para un solo usuario

NanoClaw no es un framework monolítico. Es software funcional que se adapta a tus necesidades exactas. Haz un fork, deja que Claude Code lo adapte a ti.

🤖

Nativo de IA

Sin asistentes de instalación; Claude Code guía la configuración. Sin panel de control; pregúntale a Claude. Sin herramientas de depuración; describe el problema.

🧩

Skills en vez de funciones

Los colaboradores añaden skills de Claude Code como /add-telegram que transforman tu instalación. Terminas con código limpio que hace exactamente lo que necesitas.

El mejor entorno, el mejor modelo

Se ejecuta sobre Claude Agent SDK, lo que significa que ejecutas Claude Code directamente. El entorno importa. Uno bueno le da superpoderes a los modelos inteligentes.

Comienza con NanoClaw en 3 líneas

Clona NanoClaw, entra en el directorio y deja que Claude se encargue del resto.

Terminal
$ git clone https://github.com/qwibitai/nanoclaw.git
$ cd nanoclaw
$ claude

Luego ejecuta /setup Claude Code se encarga de todo: dependencias, autenticación, configuración de contenedores, configuración de servicios.

Requisitos

macOS o Linux Node.js 20+ Claude Code Apple Container (macOS) o Docker

En las noticias

Preguntas frecuentes

¿En qué se diferencia NanoClaw de OpenClaw?

NanoClaw (también conocido como Nano Claw) adopta un enfoque fundamentalmente diferente. Mientras que OpenClaw es un framework a gran escala con miles de archivos fuente y docenas de dependencias, NanoClaw es un agente de IA personal ligero construido con unos 15 archivos fuente que puedes leer y entender en una sola sesión. NanoClaw utiliza aislamiento en contenedores a nivel de sistema operativo (Docker o Apple Container) para aislar cada sesión de agente, en lugar de depender de verificaciones de permisos a nivel de aplicación. Si buscas una alternativa segura y mínima a OpenClaw que puedas auditar y personalizar completamente, NanoClaw está diseñado exactamente para eso.

¿Es seguro NanoClaw?

La seguridad es un principio de diseño fundamental. Cada sesión de agente se ejecuta dentro de un contenedor Linux aislado con su propio sistema de archivos, espacio de nombres IPC y espacio de procesos. Los agentes solo pueden acceder a los directorios que se montan explícitamente, y no hay acceso implícito a tu sistema. Como todo el código son aproximadamente 3.900 líneas en 15 archivos, puedes auditar de forma realista todo lo que hace el software. Esta combinación de aislamiento a nivel de contenedor y un código pequeño y auditable hace de NanoClaw una de las formas más transparentes y seguras de ejecutar agentes de IA.

¿Qué apps de mensajería soporta NanoClaw?

NanoClaw incluye soporte para WhatsApp de serie y puede extenderse para funcionar con Telegram, correo electrónico y otros canales a través del sistema de skills. Añadir Telegram es tan sencillo como ejecutar el skill /add-telegram, que te guía a través de toda la configuración. La arquitectura está diseñada para que los canales de mensajería sean modulares, de modo que puedes ejecutar uno o varios canales en paralelo, cada uno con su propia configuración.

¿Qué entornos de ejecución de contenedores se soportan?

NanoClaw soporta tanto Apple Container como Docker. En macOS, Apple Container proporciona un aislamiento rápido y ligero optimizado para Apple silicon, mientras que Docker está disponible como alternativa. En Linux, se utiliza Docker automáticamente. Durante el proceso inicial de /setup, eliges qué entorno utilizar según tu plataforma y preferencias.

¿Puedo ejecutar NanoClaw en Linux?

Sí. NanoClaw funciona tanto en macOS como en Linux. En Linux, se utiliza Docker como entorno de ejecución de contenedores y se configura automáticamente durante la instalación. Los requisitos del sistema son Node.js 20 o posterior, Claude Code y un entorno de contenedores (Docker en Linux). El skill /setup gestiona todas las comprobaciones de dependencias y la configuración para tu plataforma.

¿Cómo instalo y configuro NanoClaw?

NanoClaw utiliza un proceso de configuración nativo de IA. Después de clonar el repositorio y ejecutar Claude Code, ejecutas el skill /setup, que te guía para instalar dependencias, autenticar tus canales de mensajería, configurar tu entorno de contenedores e iniciar los servicios en segundo plano. No hay archivos de configuración que editar manualmente. Claude Code gestiona toda la configuración de forma interactiva. Para cambios posteriores, describe lo que quieres y Claude Code hará las modificaciones directamente en el código.

¿Cómo se compara NanoClaw con otros frameworks de agentes de IA?

La mayoría de los frameworks de agentes de IA están diseñados para equipos que construyen productos. Son grandes, complejos y requieren una inversión significativa para comprenderlos. NanoClaw está diseñado para personas que quieren un asistente de IA personal que posean y controlen completamente. Se ejecuta como un solo proceso Node.js, utiliza aislamiento real en contenedores en lugar de sandboxing a nivel de aplicación, y es lo bastante pequeño como para entenderlo por completo. Se ejecuta sobre Claude Agent SDK, dándote acceso directo a las capacidades de Claude sin capas de abstracción.

¿Es NanoClaw de código abierto?

Sí. Nano Claw es totalmente de código abierto bajo la licencia MIT. Todo el código está disponible en GitHub y las contribuciones son bienvenidas. El proyecto fomenta el fork y la personalización. La filosofía es que tu agente de IA personal debe ser software funcional adaptado a tus necesidades exactas, no un framework genérico que configuras.