FAQ de NanoClaw Agente de IA
Preguntas comunes sobre NanoClaw y cómo funciona.
NanoClaw es un asistente personal de IA ligero y open-source basado en Claude Agent SDK de Anthropic. Los agentes se ejecutan en contenedores Linux aislados (Apple Container en macOS, Docker en macOS/Linux). WhatsApp integrado, otros canales vía skills. Incluye memoria persistente en SQLite, tareas programadas, acceso web, automatización del navegador y Agent Swarms.
Ejecuta 'git clone https://github.com/qwibitai/NanoClaw.git && cd NanoClaw && claude' y usa /setup en la sesión de Claude. Claude Code maneja dependencias, autenticación, configuración de contenedores y configuración del servicio. Requiere Node.js 20+ y Claude Code.
NanoClaw es lo suficientemente pequeño para entenderlo — un proceso, unos pocos archivos fuente, sin microservicios. A diferencia de frameworks inflados, puedes leer todo el código. Los agentes se ejecutan en contenedores Linux reales con aislamiento de sistema de archivos, no detrás de verificaciones de permisos a nivel de aplicación.
NanoClaw se ejecuta exclusivamente con Claude Agent SDK de Anthropic. Claude Code está instalado globalmente dentro de cada contenedor y maneja todas las interacciones de IA. El SDK gestiona la selección de modelos internamente — NanoClaw es de proveedor único por diseño.
WhatsApp es el canal integrado (vía la librería Baileys, vinculación por código QR). Telegram, Discord y Slack se pueden agregar vía skills de Claude Code — ejecuta /add-telegram, /add-discord o /add-slack. Los skills modifican el código fuente de tu fork para agregar soporte de canal dedicado y limpio.
La seguridad es un principio de diseño fundamental. Los agentes se ejecutan en contenedores Linux (Apple Container en macOS, Docker en macOS/Linux) con aislamiento de sistema de archivos — no detrás de verificaciones de permisos a nivel de aplicación. Los secretos se pasan vía stdin JSON y nunca se cargan en process.env. Listas de montaje permitidas con detección de escape de symlinks. Los contenedores se ejecutan sin root con montajes de proyecto de solo lectura.
NanoClaw usa SQLite (better-sqlite3) para almacenamiento persistente — mensajes, grupos, sesiones, tareas programadas y estado del router. Cada grupo también tiene su propio archivo CLAUDE.md para memoria por grupo, montado en su contenedor. No se necesita base de datos externa.
Sí. NanoClaw se ejecuta en macOS y Linux — en cualquier lugar donde funcionen Node.js 20+ y Docker. El núcleo ligero en TypeScript funciona en dispositivos de bajos recursos incluyendo Raspberry Pi. Requiere un entorno de contenedores (Apple Container o Docker) y una clave de API de Anthropic.
Agent Swarms permite a NanoClaw crear equipos de agentes especializados que colaboran en tareas complejas. NanoClaw es el primer asistente personal de IA con soporte para agent swarms, basado en la capacidad agent-teams de Claude Code.
El proyecto es open-source bajo licencia MIT en github.com/qwibitai/nanoclaw. Consulta el README para las guías de contribución. Todas las contribuciones son bienvenidas.
Las herramientas integradas son proporcionadas por Claude Code ejecutándose dentro de contenedores: comandos de shell, lectura/escritura de archivos, búsqueda web, navegación web (Chromium) y delegación de agentes (swarms). El proceso host proporciona tareas programadas (cron), memoria persistente en SQLite y mensajería de WhatsApp. Extiende la funcionalidad agregando skills.
Sí. Cada contenedor de agente tiene Chromium instalado y agent-browser para automatización del navegador. Claude Code puede buscar en la web y navegar páginas para obtener información en tiempo real dentro del contenedor aislado.
El repositorio oficial y único de confianza es github.com/qwibitai/nanoclaw. El Discord de la comunidad es discord.gg/VDdww8qS42.
macOS y Linux. Requiere Node.js 20+ y un entorno de contenedores — Apple Container en macOS o Docker en macOS/Linux. Windows no tiene soporte oficial pero puede funcionar vía WSL2 con Docker.
NanoClaw usa Anthropic Claude exclusivamente vía Claude Agent SDK. Configura ANTHROPIC_API_KEY en tu archivo .env, o autentícate vía Claude Code OAuth. No hay soporte multi-proveedor — el SDK maneja la selección de modelos internamente.
El README en el repositorio de GitHub (github.com/qwibitai/nanoclaw) es la fuente principal de documentación. El directorio docs/ contiene especificaciones de arquitectura, modelo de seguridad y lista de verificación de depuración. El código es lo suficientemente pequeño para que puedas pedirle a Claude Code que te lo explique.
Canales oficiales: Discord (discord.gg/VDdww8qS42) y GitHub (github.com/qwibitai/nanoclaw). Consulta el README para todos los enlaces de la comunidad.