campaign Anuncios

info Introducción

NanoClaw es un asistente personal de IA ligero y completamente autónomo basado en Claude Agent SDK de Anthropic. Los agentes se ejecutan en contenedores Linux aislados (Apple Container en macOS, Docker en Linux/macOS). WhatsApp integrado, otros canales vía skills. Memoria persistente en SQLite, tareas programadas, acceso web y Agent Swarms.

download Instalación

NanoClaw es un proyecto en TypeScript. Clona el repo e instala con npm.

npm / Claude CLI

# macOS / Linux — clone and setup
git clone https://github.com/qwibitai/NanoClaw.git
cd NanoClaw
claude
# Then run /setup in the Claude session

# Or install Claude CLI first:
npm install -g @anthropic-ai/claude-code

Configuración rápida (Recomendada)

git clone https://github.com/qwibitai/NanoClaw.git
cd NanoClaw
claude
# Run /setup inside the Claude session

# With environment variables pre-configured:
ANTHROPIC_API_KEY="sk-..." claude

# Quick start after setup:
npm start

Compilación e instalación manual

git clone https://github.com/qwibitai/NanoClaw.git
cd NanoClaw
npm install
# Edit src/index.ts to configure your settings
npm start

Alternativa de desarrollo: ejecuta 'npm run dev' para modo de desarrollo con recarga en caliente.

rocket_launch Inicio rápido

Ejecuta la configuración inicial una vez, luego comienza a chatear.

# Clone and setup
git clone https://github.com/qwibitai/NanoClaw.git
cd NanoClaw && npm install

# Run setup wizard
npm run setup

# Start NanoClaw
npm start

# Development mode (hot reload)
npm run dev

# Run tests
npm test

La configuración se hace editando el código fuente directamente. Las claves de API van en .env, la configuración de canales en src/index.ts.

terminal Comandos

NanoClaw usa scripts de npm para cada flujo de trabajo.

forum Canales

WhatsApp es el canal integrado (vía la librería Baileys). Otros canales — Telegram, Discord, Slack — se pueden agregar vía skills de Claude Code (/add-telegram, /add-discord, /add-slack). Cada grupo tiene su propio contenedor aislado y memoria CLAUDE.md.

# WhatsApp (built-in via Baileys library)
# Run 'npm run auth' to pair via QR code
# Per-group containers with isolated CLAUDE.md memory

# Add more channels via Claude Code skills:
# /add-telegram — Telegram bot support
# /add-discord — Discord gateway support
# /add-slack — Slack Events API support

# Start the agent (connects WhatsApp)
npm start

Consejo: Ejecuta /add-telegram o /add-discord en Claude Code para agregar más canales. Los skills modifican el código fuente de tu fork directamente.

build Herramientas

Las herramientas son capacidades que el agente puede invocar durante una conversación. Todas las herramientas integradas están aisladas y limitadas al espacio de trabajo por defecto.

# Built-in tools (provided by Claude Code inside containers):
# shell commands, file read/write, web search,
# web browsing (Chromium + agent-browser),
# agent delegation (swarms)

# Host-provided capabilities:
# SQLite memory, scheduled tasks (cron),
# WhatsApp messaging, IPC between host and containers

# Container image includes Chromium and agent-browser
# Apple Container on macOS, Docker on Linux

database Sistema de memoria

NanoClaw usa SQLite (better-sqlite3) para almacenamiento persistente — mensajes, grupos, sesiones y tareas programadas. Cada grupo también tiene su propio archivo CLAUDE.md para memoria por grupo, montado en su contenedor.

# SQLite database (better-sqlite3)
# Messages, groups, sessions, scheduled tasks, router state

# Per-group CLAUDE.md memory files
# Mounted into each group's container

# IPC via filesystem between host and containers
# No external database — everything is local

settings Configuración

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. Las claves de API van en .env, todo lo demás está en el código fuente.

# NanoClaw doesn't use configuration files
# To make changes, tell Claude Code what you want

# Key files:
# src/index.ts — orchestrator, state, message loop
# src/config.ts — constants, trigger pattern, paths
# .env — API key and runtime settings

# Environment variables:
ANTHROPIC_API_KEY="sk-ant-..."
ASSISTANT_NAME="Andy"
CONTAINER_IMAGE="nanoclaw-agent:latest"

model_training Proveedores de IA

NanoClaw se ejecuta exclusivamente con Claude Agent SDK de Anthropic. Claude Code se ejecuta dentro de cada contenedor, proporcionando todas las capacidades de IA.

NanoClaw es de proveedor único por diseño. Claude Agent SDK maneja la selección de modelos internamente. Configura ANTHROPIC_API_KEY en .env o autentícate vía Claude Code OAuth.

key Variables de entorno

Variables de entorno configuradas en tu archivo .env local. Los secretos se leen bajo demanda y nunca se cargan en process.env.

# Required
ANTHROPIC_API_KEY=sk-ant-...

# Optional
ASSISTANT_NAME=Andy
ASSISTANT_HAS_OWN_NUMBER=false
CONTAINER_IMAGE=nanoclaw-agent:latest
CONTAINER_TIMEOUT=1800000
TZ=America/New_York

shield Seguridad

Los agentes se ejecutan en contenedores, no detrás de verificaciones de permisos a nivel de aplicación. Solo pueden acceder a directorios montados explícitamente.

# Container isolation (Apple Container / Docker)
# Each agent runs in its own Linux container

# Secrets passed via stdin JSON, never in process.env
# Mount allowlists with symlink escape detection
# Containers run as non-root with read-only project mounts

account_tree Arquitectura

Un solo proceso Node.js. Los agentes se ejecutan en contenedores Linux aislados con aislamiento de sistema de archivos. Cola de mensajes por grupo con control de concurrencia. IPC vía sistema de archivos.

code Desarrollo

Flujo de trabajo estándar de TypeScript/Node.js. Ejecuta 'npm run dev' para desarrollo con recarga en caliente.

# Clone the repo
git clone https://github.com/qwibitai/NanoClaw.git
cd NanoClaw

# Install dependencies
npm install

# Run in development mode
npm run dev

# Run tests
npm test

# Build for production
npm run build

menu_book Centro de Docs

Para documentación detallada, consulta el directorio docs en el repositorio oficial.

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