NanoClaw: Asistente de IA ligero para WhatsApp con Claude
NanoClaw: Un asistente de IA ligero y seguro para WhatsApp impulsado por Claude
NanoClaw es un proyecto de hobby abierto que te permite convertir tu teléfono en un asistente personal potenciado por Claude, todo mientras mantienes tus datos aislados en contenedores Docker o Apple Container. Se desarrolló como una alternativa más sencilla y comprensible a Clawdbot / OpenClaw, con un enfoque en el minimalismo, la seguridad y la personalización controlada por el usuario.
¿Por qué NanoClaw?
| Característica | Por qué importa |
|---|---|
| Aislamiento por contenedor | Cada agente corre en su propio contenedor Linux; sólo puede ver lo que montas explícitamente. Tu sistema anfitrión permanece intacto. |
| Sin proliferación de configuraciones | El código es lo suficientemente pequeño como para que cambies el comportamiento editando el código fuente en lugar de tocar cientos de archivos YAML o JSON. |
| Enjambres de agentes | El primer asistente personal que permite desplegar un equipo de agentes para resolver problemas complejos de forma automática. |
| Amigable con Whale | Se construye sobre el SDK de Agent de Anthropic, por lo que obtienes el mismo harness que usa Claude Code. |
| Sencillez de un único proceso | Toda la lógica vive en un único proceso Node.js. No hay colas de mensajes ni micro‑servicios. |
Todas estas características se combinan para crear un proyecto que puedes bifurcar, comprender en diez minutos y desplegar sin un “asistente de configuración”.
Guía rápida de inicio
- Clona el repositorio
git clone https://github.com/qwibitai/nanoclaw.git cd nanoclaw - Ejecuta el script de arranque
claude # la primera vez instalará dependencias, pedirá tu clave API de Anthropic, el código QR de WhatsApp, etc. /setup # configura automáticamente Docker/AppleContainer e instala los módulos necesarios - Inicia el bot
/run - Comienza a conversar – Escanea el QR en la terminal con tu teléfono, luego escribe
@Andy(o cambia la palabra detonante) para hablar.
Sigue las indicaciones en pantalla y tus mensajes de WhatsApp se convertirán en comandos para Claude. El asistente mantiene el contexto de la conversación en un archivo CLAUDE.md por grupo, de modo que los mensajes posteriores continúan donde los dejaste.
Extender NanoClaw con Habilidades
NanoClaw presenta un sistema de habilidades determinístico. En lugar de agregar nuevas funciones directamente, escribes una habilidad que transforma el código base actual en la versión deseada. Por ejemplo, añadir soporte para Telegram es tan sencillo como:
npm run skills:init -- --core-version 0.5.0 --base-source .
npm run skills:apply -- --skill telegram --version 1.2.0 --files-modified src/server.ts
Después ejecuta /add-telegram y obtendrás un canal de Telegram aislado y limpio, sin el desorden adicional.
Lista de habilidades de ejemplo
| Habilidad | Qué agrega |
|---|---|
/add-telegram |
Soporte para Telegram |
/add-slack |
Integración con Slack |
/add-discord |
Soporte para bot de Discord |
/add-clear |
Comando /clear para compactar la conversación |
/setup-windows |
Soporte para Windows vía WSL2 + Docker |
Solo las actualizaciones del núcleo, correcciones de bugs o mejoras de seguridad se incorporan al repositorio base; todo lo demás vive en habilidades. Esto mantiene el núcleo limpio mientras te brinda extensibilidad.
Modelo de seguridad
La seguridad de NanoClaw se sustenta en dos capas:
- Controles a nivel de aplicación – Códigos de emparejamiento y listas blancas protegen tu conexión de WhatsApp.
- Aislamiento por contenedor – Cada agente vive en un sandbox con sólo los directorios que montas. Bash se ejecuta dentro del contenedor, no en tu anfitrión.
El archivo SECURITY.md del repositorio describe el modelo en detalle y cómo auditar lo que se monta en cada contenedor.
Preguntas frecuentes
¿Por qué no simplemente ejecutarlo en el host? El entorno de ejecución puede ser potente, pero cualquier error podría comprometer tu información personal. Los contenedores brindan un límite sólido.
¿Puedo ejecutarlo en Linux? Sí—Docker es el predeterminado en Linux, y el script /setup configura todo automáticamente.
¿Qué pasa si el programador (scheduler) se detiene? Pregunta a Claude: Why isn't the scheduler running? Gracias al harness nativo de Claude, la depuración es solo una conversación.
Contribuye
NanoClaw está abierto a contribuciones. Si quieres añadir nuevos tipos de habilidades o mejorar lo base, abre un PR con documentación clara en los archivos de habilidad CLAUDE.md.
- Haz un fork del repositorio
- Crea una carpeta de habilidades bajo
.claude/skills/ - Escribe un
SKILL.mdque indique a Claude cómo transformar la fuente actual - Ejecuta la habilidad localmente con
npm run skills:apply - Prueba los cambios y envía tu PR
¡Feliz hacking—y que tus agentes se agrupen de manera amistosa!