Guía de instalación

Pon NanoClaw en marcha

Núcleo ligero en TypeScript, una sola ruta de instalación. Clona, ejecuta claude, usa /setup.

checklist Requisitos del sistema

javascript Node.js

Node.js 20+ (LTS recomendado)

computer OS

macOS o Linux. Windows vía WSL2 puede funcionar pero no tiene soporte oficial.

memory RAM

512MB+ de RAM. Entorno ligero, sin compilación pesada.

hard_drive Disk

~50MB instalado (node_modules). La imagen del contenedor agrega ~500MB.

extension Optional

Requerido: Apple Container (macOS) o Docker (macOS/Linux). Requerido: Claude Code CLI.

wifi Network

Se requiere internet para llamadas a la API de Anthropic. Sin modo offline.

Clona el repo y comienza con Claude CLI. En funcionamiento en minutos.

bolt

One-Liner

Requires Claude CLI. All platforms.

$ git clone https://github.com/qwibitai/NanoClaw.git && cd NanoClaw && claude

list_alt

Step-by-Step

Clone first, then configure. More control.

$ git clone https://github.com/qwibitai/NanoClaw.git

$ cd NanoClaw && npm install

$ # Run claude and use /setup for guided configuration

$ # Or edit .env and src/index.ts directly

verified Verifica tu instalación

Ejecuta estos comandos para confirmar que NanoClaw está instalado correctamente.

$ node -e "console.log(require('./package.json').version)"

Debería mostrar el número de versión instalada.

$ npm test

Ejecuta la suite de pruebas (vitest) para verificar dependencias y funcionalidad principal.

$ claude

Abre Claude Code. Ejecuta /setup dentro de la sesión para configuración guiada.

settings Configuración inicial

Claude Code maneja la configuración vía /setup. Esto es lo que configura.

Instalar dependencias

Claude Code ejecuta npm install y construye la imagen del contenedor (nanoclaw-agent:latest) con Chromium, agent-browser y Claude Code preinstalados.

Autenticar

Configura ANTHROPIC_API_KEY en .env, o autentícate vía Claude Code OAuth. Los secretos se pasan a los contenedores en tiempo de ejecución, nunca se cargan en process.env.

Conectar WhatsApp

Ejecuta 'npm run auth' para vincular vía código QR. WhatsApp es el canal integrado. Agrega Telegram, Discord o Slack después vía skills (/add-telegram, /add-discord, /add-slack).

Iniciar el agente

Ejecuta 'npm start' para lanzar NanoClaw. Se conecta a WhatsApp, inicia el bucle de sondeo de mensajes y comienza a procesar mensajes en contenedores aislados.

.env — NanoClaw no usa archivos de configuración. Para hacer cambios, dile a Claude Code lo que quieres. El código es lo suficientemente pequeño para que Claude pueda modificarlo de forma segura.

system_update_alt Actualizar NanoClaw

Mantén NanoClaw actualizado para obtener las últimas funcionalidades, integraciones y parches de seguridad.

Git + npm

$ cd NanoClaw && git pull && npm install

Docker

$ cd NanoClaw && git pull && docker compose up --build

Consulta el changelog en github.com/qwibitai/nanoclaw/releases para ver las novedades de cada versión.

build Solución de problemas

Problemas comunes y cómo resolverlos.

¿Necesitas ayuda?

Únete a nuestra comunidad para soporte de instalación y solución de problemas.

forum Unirse a Discord menu_book Leer Docs

hub Integraciones • article Blog • menu_book Docs