nanoclaw — What is it?

NanoClaw is a lightweight, secure, and customizable AI assistant that runs in containers, connecting to various messaging platforms and providing scheduled tasks and memory management.

⭐ 29,456 Stars 🍴 12,874 Forks TypeScript Author: qwibitai
Source: README View on GitHub →

Why it matters

NanoClaw is gaining attention due to its focus on security through containerization, its ease of customization, and its integration with popular messaging platforms. The project stands out for its small, understandable codebase and its modular approach to adding new features and channels.

Source: README, Philosophy section

Core Features

Containerized Agents

NanoClaw runs agents in isolated containers, providing filesystem isolation and security beyond application-level controls.

Source: README, Why I Built NanoClaw section
Multi-channel Messaging

Supports various messaging platforms like WhatsApp, Telegram, Slack, and Discord, with the ability to add more channels via skills.

Source: README, What It Supports section
Scheduled Tasks

Enables the creation of recurring jobs that can perform actions and message the user, enhancing automation capabilities.

Source: README, What It Supports section
Customization

NanoClaw allows for customization through code changes, avoiding configuration sprawl and providing a bespoke experience.

Source: README, Customizing section

Architecture

NanoClaw follows a modular architecture with a Node.js host process orchestrating containerized agent containers. It uses SQLite databases for session data and supports skill-based installation of channel and provider modules. The project leverages Docker for containerization and utilizes Anthropic's Claude Agent SDK for AI capabilities.

Source: README, Architecture section, Code Tree

Project Knowledge Graph

Knowledge graph: project (center) + core features (inner hexagons) + key dependencies (outer chips) @clack/core @onecli-sh/sdk better-sqlite3 chat cron-parser Containerized Agents Multi-channel MessagingMulti-channel Messa… Scheduled Tasks Customization nanoclaw Project Core feature Key dependency

Center: project; inner ring: core feature modules; outer ring: key dependencies. Auto-generated from core_features and tech_stack.key_deps.

Tech Stack

LanguageTypeScriptFrameworkNode.js, Docker
@clack/core@onecli-sh/sdkbetter-sqlite3chatcron-parserkleur
Docker
Source: Dependency files, Code Tree

Quick Start

git clone https://github.com/qwibitai/nanoclaw.git nanoclaw-v2 cd nanoclaw-v2 bash nanoclaw.sh
Source: README Quick Start section

Use Cases

NanoClaw is suitable for individual users and small teams looking to create a customized AI assistant for managing tasks, automating communication, and integrating with various messaging platforms. It is useful for scenarios such as personal productivity, customer service automation, and information aggregation.

Source: README Usage section

Strengths & Limitations

Strengths

  • Strength 1: Strong focus on security and isolation through containerization
  • Strength 2: High degree of customization and flexibility
  • Strength 3: Easy to understand and modify codebase

Limitations

  • Limitation 1: Limited documentation and community support
  • Limitation 2: May require technical expertise to fully utilize
  • Limitation 3: Limited to platforms that can be containerized and integrated with existing messaging APIs
Source: README, Philosophy section, Code Tree

Latest Release

2.0.10 (no release date provided), Main changes not specified

Source: GitHub Releases

Verdict

NanoClaw is a promising project for users and teams seeking a secure, customizable AI assistant with a focus on containerization and integration with messaging platforms. Its small, manageable codebase and modular architecture make it suitable for those willing to engage with the codebase and customize it to their needs.

Transparency Notice
This page is auto-generated by AI (a large language model) from the following public materials: GitHub README, code tree, dependency files and release notes. Analyzed at: 2026-05-24 12:12. Quality score: 85/100.

Data sources: README, GitHub API, dependency files