# NanoClaw — Lightweight Personal AI Assistant

> A minimal alternative to OpenClaw that runs Claude agents in isolated containers. Connects to WhatsApp, Telegram, Slack, Discord, and Gmail with just 500 lines of TypeScript.

## Install

Save as a script file and run:

## Quick Use

1. Fork and clone the repository:
   ```bash
   git clone https://github.com/qwibitai/nanoclaw.git
   cd nanoclaw
   ```
2. Run Claude Code in the project directory:
   ```bash
   claude
   ```
3. Inside the Claude session, run the setup skill:
   ```
   /setup
   ```
   Claude Code handles all dependencies, authentication, container setup, and service configuration automatically.

4. Add messaging channels:
   ```
   /add-whatsapp
   /add-telegram
   /add-discord
   ```

---

## Intro

NanoClaw is a lightweight, open-source personal AI assistant built on the Anthropic Claude Agent SDK. With 26,400+ GitHub stars and just ~500 lines of TypeScript, it provides the same core functionality as OpenClaw (335K+ stars) — multi-channel messaging, memory, scheduled tasks, and web access — but in a codebase small enough to read and understand in one sitting. Each agent runs in its own isolated Linux container with a separate filesystem, providing true OS-level security isolation.

Best for: developers who want a personal AI assistant across messaging apps without OpenClaw's complexity.
Works with: Claude Agent SDK, WhatsApp, Telegram, Slack, Discord, Gmail.
Setup time: under 5 minutes with Claude Code.

---

## NanoClaw — Architecture & Features

### Why NanoClaw Over OpenClaw?

| Feature | OpenClaw | NanoClaw |
|---------|----------|----------|
| Codebase | 500K+ lines, 53 config files, 70+ deps | ~500 lines TypeScript |
| Security | Application-level permission checks | OS-level container isolation |
| Process model | One Node process, shared memory | One container per agent group |
| Customizability | Complex plugin system | Read & modify the entire codebase |

### Core Features

**Multi-Channel Messaging**
Connect to WhatsApp, Telegram, Discord, Slack, or Gmail. Each channel is added with a simple `/add-<channel>` command inside Claude Code. Users message your NanoClaw instance from their favorite app, and Claude responds.

**Container Isolation**
Every agent group runs in its own Linux container (Docker or Apple Container) with:
- Isolated filesystem — no cross-group data leakage
- Dedicated CLAUDE.md memory file per group
- Separate SQLite database for persistent context

**Scheduled Tasks**
Set up automated tasks that run on a schedule — daily summaries, periodic checks, recurring workflows.

**Web Access & Browser Automation**
Agents can browse the web, scrape data, and interact with web services.

**Agent Swarms**
Launch multiple specialized agents that collaborate on complex tasks within isolated environments.

**Agent Vault (Credential Management)**
Securely store and manage API keys and credentials via OneCLI's Agent Vault.

### Tech Stack
- **Runtime**: Claude Agent SDK (Anthropic)
- **Language**: TypeScript (93.7%), Python, Swift
- **Database**: SQLite for persistent memory
- **Containers**: Docker or Apple Container
- **Requirements**: Node.js 20+, Claude Code

### FAQ

**Q: What is NanoClaw?**
A: A lightweight personal AI assistant that runs Claude agents in isolated containers, connecting to WhatsApp, Telegram, Slack, Discord, and Gmail. Built on the Anthropic Claude Agent SDK with ~500 lines of TypeScript.

**Q: Is NanoClaw free?**
A: Yes, NanoClaw is open-source under the MIT license. You need your own Anthropic API key for Claude usage.

**Q: How does NanoClaw compare to OpenClaw?**
A: NanoClaw provides the same core features (messaging, memory, tasks) in ~500 lines vs OpenClaw's 500K+ lines, with true OS-level container isolation instead of application-level permission checks.

---

## Source & Thanks

> Created by [qwibitai](https://github.com/qwibitai). Licensed under MIT.
>
> [nanoclaw](https://github.com/qwibitai/nanoclaw) — ⭐ 26,400+

Thank you to the Qwibit team for building a clean, minimal alternative to OpenClaw.

---

<!-- ZH -->

## 快速使用

1. Fork 并克隆仓库：
   ```bash
   git clone https://github.com/qwibitai/nanoclaw.git
   cd nanoclaw
   ```
2. 在项目目录运行 Claude Code：
   ```bash
   claude
   ```
3. 在 Claude 会话中运行 setup：
   ```
   /setup
   ```
   Claude Code 会自动处理所有依赖安装、认证配置和容器设置。

4. 添加消息通道：
   ```
   /add-whatsapp
   /add-telegram
   /add-discord
   ```

---

## 简介

NanoClaw 是一个轻量级开源个人 AI 助手，基于 Anthropic Claude Agent SDK 构建。拥有 26,400+ GitHub Star，仅约 500 行 TypeScript 代码，却提供了与 OpenClaw（335K+ Star）相同的核心功能——多通道消息、记忆、定时任务和网页访问——代码量小到可以一次性读完。每个 Agent 运行在独立的 Linux 容器中，提供真正的操作系统级别安全隔离。

适合人群：想要一个跨消息平台的个人 AI 助手，但不想处理 OpenClaw 复杂度的开发者。
兼容平台：WhatsApp、Telegram、Slack、Discord、Gmail。
安装时间：使用 Claude Code 不到 5 分钟。

---

## NanoClaw — 架构与功能

### 与 OpenClaw 对比

| 特性 | OpenClaw | NanoClaw |
|------|----------|----------|
| 代码量 | 50 万+ 行，53 个配置文件 | ~500 行 TypeScript |
| 安全性 | 应用级权限检查 | 操作系统级容器隔离 |
| 进程模型 | 单 Node 进程，共享内存 | 每组独立容器 |

### 核心功能
- **多通道消息**：WhatsApp、Telegram、Discord、Slack、Gmail
- **容器隔离**：每个 Agent 组独立容器，独立文件系统和 SQLite 数据库
- **定时任务**：设置自动化定期任务
- **网页访问**：Agent 可浏览网页、抓取数据
- **Agent 集群**：多个专业 Agent 协作完成复杂任务

### FAQ

**Q: NanoClaw 是什么？**
A: 一个轻量级个人 AI 助手，在隔离容器中运行 Claude Agent，可连接 WhatsApp、Telegram 等消息平台，仅 500 行 TypeScript。

**Q: 免费吗？**
A: 开源免费（MIT），需自备 Anthropic API Key。

---

## 来源与感谢

> Created by [qwibitai](https://github.com/qwibitai). Licensed under MIT.
>
> [nanoclaw](https://github.com/qwibitai/nanoclaw) — ⭐ 26,400+

---
Source: https://tokrepo.com/en/workflows/b399753b-8f80-4a07-81ac-e985d166d5dd
Author: TokRepo精选