v0.4.2 Production Ready

NanoClaw

Your personal Claude assistant. One process, a handful of files, no complexity. Container-isolated security, WhatsApp integration, and AI-native setup through Claude Code.

Get Started View on GitHub

System Preview

6.7k

GitHub Stars

Process

Core Files

MIT

License

Simplicity Meets Security

One process. A handful of files. No microservices, no message queues. Just your personal Claude assistant, running safely in containers.

Container Isolation

Agents run in Linux containers with filesystem isolation. Only mounted directories are accessible - bash commands execute safely within containers, never on your host system.

WhatsApp Interface

Chat with Claude through WhatsApp groups. Each group maintains isolated context with individual CLAUDE.md memory files for personalized interactions.

Per-Group Memory

Isolated contexts for each WhatsApp group with dedicated memory files. SQLite-backed message storage with per-group queuing and concurrency control.

Scheduled Tasks

Run recurring jobs with built-in task scheduler. Automate daily reports, reminders, and background operations without external dependencies.

Claude Agent SDK

Streaming agent containers powered by Claude Agent SDK. Direct access to Claude's capabilities with built-in web search and content fetching.

Agent Swarms

Collaborative multi-agent workflows for complex tasks. Coordinate multiple Claude instances to tackle sophisticated problems efficiently.

Nanoclaw vs Cloud AI: Privacy & Cost Comparison

Why creators are migrating to local inference

Feature	Cloud AI (OpenAI/Claude)	Nanoclaw (Local)
Data Privacy	Stored on Servers	100% Local
Cost	$20+/month	Free after setup
Integrations	Limited API	100+ (Zapier-like)
Device Support	Web only	Mac/RPi/Docker
Customization	Prompt-only	Full Open Source
Internet Required	Always Connected	Fully Offline

Data Privacy

Cloud AI: Stored on Servers
Nanoclaw: 100% Local

Cost

Cloud AI: $20+/month
Nanoclaw: Free after setup

Device Support

Cloud AI: Web only
Nanoclaw: Mac/RPi/Docker

Built for Real-World Applications

From personal productivity to professional workflows, Nanoclaw adapts to your needs.

code

Code Assistant

Local code completion, debugging, and documentation generation. Keep your proprietary code private while getting AI assistance.

edit_note

Content Creation

Write blog posts, emails, and documents with AI assistance. All your drafts and ideas stay on your device.

analytics

Data Analysis

Analyze sensitive business data locally. No data leaves your infrastructure, ensuring complete confidentiality.

calendar_month

Personal Assistant

Manage your calendar, emails, and tasks with voice commands and automation. 100+ integrations available.

school

Research & Learning

Summarize papers, answer questions, and organize knowledge bases. Perfect for students and researchers.

api

API Integration

Build custom applications with Nanoclaw's REST API. Integrate AI capabilities into your existing workflows.

AI-Native Setup

Claude Code handles everything: dependencies, authentication, containers, and service configuration.

bash — install.sh

git clone https://github.com/gavrielc/nanoclaw && cd nanoclaw && claude

checklist

Requirements

• macOS or Linux
• Node.js 20+
• Claude Code CLI
• Apple Container (macOS) or Docker

settings_suggest

What You Get

• Automatic dependency installation
• Anthropic API authentication
• Container setup & configuration
• Service registration & startup

Three Simple Steps

Clone the repository

git clone https://github.com/gavrielc/nanoclaw.git

2
Navigate to directory
```
cd nanoclaw
```
3
Start Claude Code and run setup
```
claude
# Then in Claude Code:
/setup
```
Claude Code will automatically handle dependencies, authentication, container setup, and service configuration.

macOS

Linux

Windows (WSL2)

Raspberry Pi

Docker

Frequently Asked Questions

What is Nanoclaw?

Nanoclaw is a personal Claude assistant built for simplicity and security. It's a lightweight alternative to OpenClaw - one process, a handful of files, no microservices. Features include WhatsApp integration, per-group memory, scheduled tasks, and container isolation. Built on Claude Agent SDK with AI-native setup.

How much does Nanoclaw cost?

Nanoclaw is completely free and open source under MIT license. You only pay for Anthropic API usage (Claude calls). No subscription fees, no hidden costs - you own and control everything.

How does Nanoclaw compare to OpenClawd.ai?

Nanoclaw has a lighter footprint and more edge support compared to OpenClawd. While both are self-hosted AI solutions, Nanoclaw is specifically optimized for smaller devices like Raspberry Pi and Mac mini, making it more accessible for personal use.

What hardware is required?

Nanoclaw runs on Raspberry Pi 4 (4GB+), Mac mini with Apple Silicon (M1/M2/M3), or any modern PC with 16GB+ RAM. NVIDIA RTX 3060+ GPU is recommended for optimal performance, but CPU-only mode works well for most tasks.

Can I use this without internet?

Yes! Once you've downloaded your initial models, Nanoclaw functions entirely offline. There's no "phoning home" or cloud check-ins. All processing happens locally on your device.

Where can I find the GitHub repository?

You can find Nanoclaw on GitHub at github.com/gavrielc/nanoclaw. Star the repo to stay updated with new releases and features!

How do I update models?

Updates are simple through the built-in Model Manager. We support Ollama registries and direct GGUF imports from HuggingFace. You can also use the CLI to download and manage models.