NanoClaw: un agente personal pequeño, aislado y adaptable

Todo lo que hay que saber sobre nanocoai/nanoclaw: un asistente de IA para mensajería que ejecuta cada agente en un contenedor y privilegia una base de código que el usuario pueda inspeccionar y modificar.

---

Qué es NanoClaw

NanoClaw es un agente personal de IA para aplicaciones de mensajería. Su propuesta actual combina canales como WhatsApp, Telegram, Discord, Slack, Gmail, Microsoft Teams, iMessage, Matrix, Google Chat, Webex, Linear, GitHub y WeChat con memoria, tareas programadas y agentes aislados en contenedores. El repositorio declara que usa el SDK de agentes de Anthropic; el sitio oficial documenta proveedores adicionales instalables, incluidos Codex, OpenCode y Ollama.

No se presenta como una plataforma general de agentes ni como un servicio alojado. Es software libre bajo MIT pensado para que cada persona haga su propia bifurcación y la adapte a lo que necesita. El sitio oficial describe un proceso anfitrión de Node que enruta mensajes y despierta contenedores por grupo de agentes; dentro de cada sesión hay bases SQLite de entrada y salida, y cada grupo mantiene su propio CLAUDE.md, memoria, habilidades y montajes permitidos.

El origen: una reacción a la complejidad y al acceso privilegiado

El repositorio se creó el 31 de enero de 2026. El primer mensaje de confirmación visible en la raíz lo describe como un asistente personal de Claude por WhatsApp, y el lanzamiento de Hacker News del 1 de febrero fue publicado por jimminyx, quien se identificó allí como el desarrollador único de un proyecto de fin de semana.

La motivación declarada fue una tensión con OpenClaw: su autor decía no sentirse cómodo entregando acceso a su vida a software complejo que no podía comprender. El README contrapone ese riesgo percibido con una arquitectura pequeña y con aislamiento del sistema operativo. En el hilo de lanzamiento explicó que lo usaba para conversar con Claude Code sobre una bóveda de Obsidian montada y programar tareas mediante WhatsApp.

El proyecto no nació con la organización actual: el hilo enlazaba el repositorio histórico gavrielc/nanoclaw; la ubicación canónica consultada hoy es nanocoai/nanoclaw. El sitio oficial enlaza además a NanoCo como mantenedor y anuncia una ronda de 12 millones de dólares, pero ese anuncio es material de primera parte y no permite inferir por sí solo el grado de madurez técnica del software.

Filosofía y principios

NanoClaw formula una filosofía explícita:

• Pequeño para poder entenderlo: un proceso, pocos archivos y sin microservicios; el sitio compara 132 archivos fuente y unas 17.500 líneas para NanoClaw con cifras mayores atribuidas a OpenClaw.

• Seguridad por aislamiento: el agente ve solo los directorios montados de forma explícita y las órdenes de terminal se ejecutan dentro del contenedor, no directamente en el anfitrión.
• Personal, no monolítico: se anima a bifurcar el repositorio y a ajustarlo con un agente de programación, en vez de crecer hasta incluir todas las funciones posibles.
• Habilidades antes que funciones integradas: el tronco contiene el registro e infraestructura; los adaptadores de canales y proveedores se incorporan bajo demanda mediante habilidades.
• Instalación híbrida: hay un instalador para el camino normal y Claude Code interviene cuando se requiere diagnóstico o una decisión contextual.

Esta es una postura de diseño, no una certificación de seguridad. El propio proyecto debe revisarse y operarse con los privilegios adecuados para cada instalación.

Cómo funciona

El flujo operativo documentado es el siguiente:

1. Un canal recibe un mensaje y el proceso anfitrión lo asocia mediante el modelo entidad usuario → grupo de mensajería → grupo de agentes → sesión.
2. El enrutador registra la entrada en inbound.db y despierta el contenedor correspondiente.
3. El contenedor ejecuta el agente con su memoria, instrucciones y habilidades aisladas.
4. La salida se escribe en outbound.db; el componente de entrega la consulta y responde por el adaptador del canal.

El aislamiento es configurable por canal: se puede separar cada canal en un agente distinto, compartir un agente y su memoria entre varios canales, o agrupar canales en una sesión compartida. Las credenciales de salida se enrutan por Agent Vault de OneCLI; según el sitio, este inyecta la clave al solicitarla y aplica políticas y límites por agente, de modo que el agente no reciba la clave sin procesar.

Los adaptadores y proveedores se incorporan como habilidades. Por ejemplo, el proceso descrito para /add-telegram recupera archivos de la rama de registro channels, los copia sin fusionar esa rama y ejecuta una prueba de registro; el README de contribución cita también /add-slack, /add-discord y /add-opencode.

Estado oficial y semioficial

No se recuperó evidencia de que NanoClaw haya sido aceptado en un mercado oficial de Anthropic, OpenAI, Apple, Telegram o cualquier otro proveedor. Su estado verificable es el de proyecto público MIT con organización y sitio propios, integración documentada con Claude Code, el SDK de agentes de Anthropic, Docker y OneCLI.

Las páginas oficiales afirman que el agente usa el SDK oficial de Anthropic y que puede añadir proveedores alternativos. Eso acredita integración técnica documentada, no patrocinio, auditoría ni aprobación de Anthropic, OpenAI o los servicios de mensajería. La presencia de más de 30.000 estrellas y una comunidad de discusiones activa pueden indicar atención de facto, pero no una designación formal de estándar.

El ecosistema

Repositorios de NanoCo

La consulta a los repositorios públicos de nanocoai identificó componentes y extensiones con relación explícita:

• nanocoai/nanoclaw-templates (4 estrellas): plantillas instalables de agentes.
• nanocoai/nanoclaw-telegram (10), nanocoai/nanoclaw-whatsapp (10), nanocoai/nanoclaw-discord (1), nanocoai/nanoclaw-slack (1), nanocoai/nanoclaw-gmail (2) y nanocoai/nanoclaw-matrix (1): integraciones de canales.
• nanocoai/nanoclaw-opencode (0): trabajo empaquetado para que OpenCode sea proveedor de primera clase.
• nanocoai/nanoclaw-skills (16) y nanocoai/nanoclaw-community-skills (1): repositorios de habilidades.
• nanocoai/nanoclaw-dashboard (3): interfaz de monitorización que recibe instantáneas JSON.
• nanocoai/nanoclaw-docker-sandbox (8), nanoclaw-docker-sandboxes (0) y nanoclaw-docker-sandbox-windows (0): variantes de entorno aislado.

Son repositorios relacionados por la misma organización, no dependencias obligatorias de toda instalación. La documentación de contribución confirma especialmente que las plantillas se mantienen en nanocoai/nanoclaw-templates.

Bifurcaciones, puertos y proyectos derivados

Entre las bifurcaciones con descripción propia recuperadas aparecen taylorwalton/talon (89 estrellas), agente autónomo de analista SOC; MedClaw-Org/MedClaw (32), asistente médico; tobalo/bunclaw (29), variante centrada en Bun; Rlin1027/NanoGemClaw (19), variante con Gemini y Telegram; anagrambuild/solclaw (15), orientada a operaciones de Solana; y GaussianGuaicai/nanoclaw-codex (12), que declara usar el SDK Codex.

La búsqueda de repositorios recuperó además puertos no marcados como bifurcación: ApeCodeAI/nanoclaw-py (187 estrellas) en Python, microclaw/microclaw (730) en Rust, agoodway/goodwizard (40) en Elixir, lorenzovenice/nanoclaw-venice (19) con Venice API y lmxxf/nanoclaw-on-openharmony (14), cuyo nombre indica una adaptación para OpenHarmony. No se recuperó un puerto o traducción comunitaria no inglesa cuya documentación pudiera verificarse más allá de ese indicio de nombre.

En la propia raíz se enlazan README en chino, japonés y coreano; la publicación v2.1.54 acredita una contribución de arkjun para el README coreano. Son localizaciones incluidas en el proyecto, no repositorios de traducción independientes.

Números del repo

Medición: 12 de agosto de 2026; API y página de GitHub.

Métrica	Valor
Estrellas	30.492
Bifurcaciones	12.864
Suscriptores reales	129
Confirmaciones visibles en GitHub	2.314
Ramas	151
Etiquetas	8
Lenguaje principal	TypeScript
Licencia	MIT
Creación	31 de enero de 2026
Última publicación	v2.1.54, 1 de agosto de 2026

La API enumera como principales contribuidores a gavrielc (1.190 contribuciones), github-actions[bot] (348), Koshkoshinsk (157), glifocat (130) y gabi-simons (97). La página del repositorio muestra 2.314 confirmaciones, mientras que la API general no ofrece un total directo de confirmaciones en su respuesta; por ello se conserva la cifra visible de la página.

El valor open_issues_count de la API era 882, pero no se presenta como incidencias exclusivas: GitHub advierte que ese campo puede incluir solicitudes de cambios abiertas. En la página se mostraban por separado 313 incidencias y 569 solicitudes de cambios. La API también duplica las estrellas en watchers_count; por eso la tabla usa subscribers_count para los suscriptores reales.

La publicación v2.1.54 es una recopilación de v2.1.18 a v2.1.54; menciona migración de proveedor, memoria, tareas programadas, imágenes reforzadas y cambios de habilidades. También indicaba 41 confirmaciones posteriores a esa publicación al visitarla.

Cómo contribuir

NanoClaw tiene una política de contribución detallada. Antes de empezar propone consultar solicitudes de cambios e incidencias con gh pr list --repo nanocoai/nanoclaw --search "<función>" y gh issue list --repo nanocoai/nanoclaw --search "<función>", comprobar que el cambio encaje con la filosofía y limitar cada solicitud a una sola cosa.

El criterio es deliberadamente restrictivo: aceptan correcciones de errores o seguridad, simplificaciones y reducciones de código; las nuevas capacidades, compatibilidad o mejoras deben convertirse en habilidades. Para una habilidad de canal o proveedor, se debe bifurcar desde main, crear un módulo que se registre solo, añadir su prueba de registro, preparar SKILL.md y REMOVE.md cuando deje cambios, y abrir una solicitud de cambios. Las habilidades han de probarse en una clonación limpia.

Los cambios incompatibles están permitidos, pero no silenciosamente: toda entrada [BREAKING] del registro debe enlazar una ruta de migración mediante habilidad o documentación con detección, causa, corrección, verificación y reversión. versions.json es la señal verificable para cambios de versiones externas y /update-nanoclaw los presenta tras actualizar.

Guía rápida de uso

Instalación y primer arranque

Requisitos documentados: macOS, Linux o Windows mediante WSL2; Node.js 20 o superior, pnpm 10 o superior, Claude Code y Docker Desktop o Docker Engine.

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

El guion instala Node, pnpm y Docker si faltan, registra la credencial de Anthropic con OneCLI, construye el contenedor y empareja el primer canal. Si falla un paso, la documentación oficial dice que Claude Code se invoca para diagnosticar y continuar.

Flujos de trabajo habituales

1. Añadir Telegram: ejecutar /add-telegram desde la sesión de agente de programación. La habilidad recupera los archivos del adaptador de la rama channels, los copia al clon y verifica el registro; después guía la configuración interactiva de tokens y bot.
2. Añadir otro canal o proveedor: el mismo patrón se documenta para /add-slack, /add-discord y /add-opencode. Los canales y proveedores se instalan bajo demanda, por lo que el clon no incorpora todos los adaptadores por defecto.
3. Separar conversaciones sensibles: elegir una relación de aislamiento por canal: un agente por canal para privacidad, uno compartido para memoria común o una sesión compartida para varios canales. Cada grupo tiene contenedor, memoria e instrucciones propios.
4. Programar acciones recurrentes: usar las tareas programadas del proyecto para lanzar Claude y recibir el resultado por mensajería; el sitio ofrece como ejemplos resúmenes matutinos y revisiones semanales.

Configuración esencial

• CLAUDE.md de cada grupo de agentes: instrucciones del agente aislado; cada grupo mantiene el suyo.
• Montajes permitidos: delimitan qué directorios puede ver el contenedor; constituyen el control práctico más importante de acceso al anfitrión.
• Habilidades /add-<canal> y /add-<proveedor>: mecanismo documentado para incorporar adaptadores de forma selectiva.
• versions.json: señal mecánica de versiones externas que usa la ruta de actualización para detectar migraciones.
• docs/ y el registro de cambios: fuente de rutas de migración para cambios incompatibles.

Trampas frecuentes y soluciones

• Un clon local no se migra solo. La política del proyecto exige una ruta de migración para cada cambio incompatible; usar /update-nanoclaw y seguir la habilidad o documento asociado, en vez de reconstruir manualmente el cambio desde el diff.
• Un adaptador no debe mezclarse con main. La documentación de habilidades indica obtener los archivos desde la rama de registro y copiarlos, no fusionar esa rama; también exige ejecutar la prueba de registro del adaptador.
• No asumir que el aislamiento sustituye el diseño de permisos. El hilo de HN debatió acciones externas y consecuencias dañinas: thepoet preguntó cómo se limitaban esas acciones; el debate posterior distinguió aislamiento de contenedores, microVM y superficie de ataque. Revisar montajes, credenciales y políticas antes de otorgar acceso es necesario.
• Documentación y código generados con IA requieren revisión. En el lanzamiento, avaer encontró una ruta errónea en el inicio rápido; jimminyx confirmó que Claude Code la había introducido y la corrigió. redfloatplane y MrJohz cuestionaron la confianza que inspira documentación aparentemente no revisada. Es una crítica histórica concreta, no una afirmación sobre la calidad de la versión actual.

Integraciones y migración

NanoClaw integra Docker en macOS, Linux y WSL2; en macOS, Apple Container aparece como opción nativa. OneCLI aporta el intermediario de credenciales; Claude Code es el recorrido nativo, y la documentación enumera habilidades para Codex, OpenCode y Ollama como alternativas configurables por grupo.

La migración desde un asistente tipo OpenClaw no está documentada como importación automática de datos o configuración. La ruta práctica verificable es crear un clon de NanoClaw, añadir solo los canales y proveedores requeridos mediante habilidades, y configurar los montajes y grupos de agentes. Esa diferencia responde precisamente al principio de personalización por bifurcación.

Cómo lo recibió la comunidad

El lanzamiento directo en Hacker News fue el hilo 46850205: 533 puntos y 224 comentarios al recuperarlo. El texto inicial era del autor, por tanto acredita lanzamiento y no una reseña independiente. La conversación sí ofrece reacciones concretas:

• mark_l_watson dijo que le gustaba la idea de una versión menor de OpenClaw y señaló interés por Apple Container, aunque objetó que el tamaño anunciado no coincidía con su estimación móvil de líneas TypeScript.
• thepoet valoró la capacidad de Clawdbot para permisos amplios, preguntó cómo NanoClaw aislaba acciones externas potencialmente dañinas y consideró interesantes los contenedores de Apple; por tanto, su comentario es a la vez interés técnico y reserva de seguridad.
• avaer cuestionó una instrucción de clonación inexistente y preguntó si se trataba de un proyecto oficial de Anthropic. jimminyx respondió que Claude Code había introducido esa referencia errónea, la corrigió y describió el proyecto como áspero pero adecuado a sus necesidades.
• redfloatplane criticó que la documentación con señales de generación por IA reducía su confianza, aun cuando le gustaba la idea. MrJohz añadió que un README aparentemente autogenerado y no revisado puede hacer dudar de la revisión del código. Son opiniones de usuarios, no auditorías independientes.

En GitHub hay discusiones abiertas de categorías de anuncios, general, ideas, encuestas, preguntas y respuestas, y muestras de extensiones comunitarias: la discusión «The evolution of this codebase» tenía 7 votos y 6 comentarios, y «Support for other LLM or openrouter» 5 votos y 8 comentarios cuando se consultó. La discusión «How nanoclaw is different from Claude Channels?» registraba 3 votos y 1 comentario. Estas cifras muestran actividad, pero no equivalen a una encuesta de satisfacción.

No se obtuvo evidencia recuperable y verificable de hilos específicos en Reddit, publicaciones de X, Product Hunt, Dev.to, Hashnode, podcasts, registros de paquetes o videos independientes durante esta ejecución. Las protecciones de acceso y resultados no verificables no se interpretan como ausencia de cobertura.

NanoClaw frente a otras propuestas

Propuesta	Coincidencia verificable	Diferencia verificable
OpenClaw	Ambos son asistentes de IA conectados a mensajería; NanoClaw se posiciona explícitamente como alternativa.	NanoClaw declara una arquitectura de proceso anfitrión con contenedores por grupo y adopción selectiva de adaptadores; su comparación oficial sostiene que busca menor tamaño y menos dependencias. Esta es la caracterización del propio proyecto, no un benchmark independiente.
ApeCodeAI/nanoclaw-py	Se describe como una alternativa pequeña a OpenClaw y comparte tareas, acceso a archivos, órdenes y programación.	Declara implementarse en unas 500 líneas de Python; NanoClaw principal usa TypeScript según la API. No se recuperó documentación suficiente para comparar seguridad o compatibilidad.
microclaw/microclaw	Es un asistente agente que vive en chats e indica estar inspirado por NanoClaw.	Su descripción declara Rust y que incorpora algunas ideas de NanoClaw; la fuente no sustenta más equivalencia funcional.
goodwizard	Su descripción lo presenta como clon de NanoClaw.	Declara Elixir; no se recuperó su README, por lo que no se atribuyen capacidades adicionales.

Casos de uso

• Una persona que quiere conversar con un agente desde su canal habitual puede conectar WhatsApp, Telegram, Slack u otro adaptador bajo demanda y mantener la memoria y las instrucciones del agente dentro de un grupo aislado.
• Quien necesita un asistente con acceso limitado a archivos concretos puede crear un grupo de agente con montajes explícitos y revisar qué datos entran al contenedor, en vez de dar acceso general al anfitrión.
• Equipos pequeños o usuarios avanzados que quieren automatizaciones recurrentes pueden usar tareas programadas para resúmenes y revisiones entregadas por mensajería, siempre que ajusten credenciales y políticas de OneCLI a la sensibilidad de cada acción.
• Desarrolladores que desean una base modificable para un dominio concreto pueden bifurcar el proyecto y materializar cambios como habilidades, canales, proveedores o plantillas; los derivados Talon, MedClaw y SolClaw muestran que la comunidad ya ha explorado especializaciones de seguridad, salud y operaciones de Solana.

Recursos

• Repositorio: https://github.com/nanocoai/nanoclaw
• Documentación e instalación: https://docs.nanoclaw.dev
• Sitio oficial: https://nanoclaw.dev
• Guía de contribución: https://github.com/nanocoai/nanoclaw/blob/main/CONTRIBUTING.md
• Plantillas oficiales: https://github.com/nanocoai/nanoclaw-templates
• Comunidad Discord: https://discord.gg/VDdww8qS42
• Conversación en Hacker News: https://news.ycombinator.com/item?id=46850205
• Publicación y registro de cambios: https://github.com/nanocoai/nanoclaw/releases/tag/v2.1.54

---

Nota: este artículo combina documentación oficial, la API de GitHub, la publicación de lanzamiento y un hilo de Hacker News consultados el 12 de agosto de 2026. Las cifras cambian con el tiempo.