NanoClaw

Ваш персональный ИИ-агент. Безопасный. Легковесный. Ваш.

NanoClaw безопасно работает в контейнерах, создан для понимания и настройки под ваши нужды.

звёзд на GitHub

Почему NanoClaw?

NanoClaw предоставляет тот же основной функционал в кодовой базе, которую вы действительно можете понять.

NanoClaw
OpenClaw
Исходных файлов 15 3 680
Строк кода ~3 900 434 453
Зависимостей <10 70
Файлов конфигурации 0 53
Время на изучение 8 минут 1–2 недели
Модель безопасности Изоляция на уровне ОС в контейнерах Проверки на уровне приложения
Архитектура Один процесс + изолированные контейнеры Один процесс, общая память

Что поддерживается

Всё, что NanoClaw поддерживает из коробки, и ничего лишнего.

💬

Мессенджеры

WhatsApp, Telegram и другие. Пишите вашему агенту NanoClaw с телефона через приложения, которыми вы уже пользуетесь.

🔒

Контейнерная изоляция

Агенты работают в Apple Container (macOS) или Docker. Они видят только то, что вы явно подключили.

🐝

Рои агентов НОВОЕ

NanoClaw может создавать команды специализированных агентов, совместно работающих над сложными задачами. Первый персональный ИИ с поддержкой этой функции.

🧠

Память для каждой группы

Каждая группа имеет собственную память CLAUDE.md, изолированную файловую систему и работает в своей контейнерной песочнице.

Запланированные задачи

Повторяющиеся задания, которые запускают Claude и отправляют вам ответ. Утренние сводки, еженедельные обзоры и многое другое.

🧩

Система навыков

Расширяйте функциональность без раздувания. Добавляйте Gmail, Telegram или пользовательские возможности через навыки.

ИИ-нативная настройка

Никаких мастеров установки. Claude Code проведёт через всё: зависимости, аутентификация, контейнеры, сервисы.

🌐

Доступ в интернет

NanoClaw может искать в интернете, получать контент и просматривать страницы для исследования чего угодно.

Архитектура

NanoClaw — это один процесс Node.js. Агенты в изолированных контейнерах. 15 исходных файлов.

Входящее сообщение
WhatsApp / Telegram
SQLite
хранение и дедупликация
Очередь группы
FIFO для каждой группы
Контейнер
Claude Agent SDK
Ответ
потоковая передача

Один процесс

Один процесс Node.js опрашивает сообщения, управляет очередями, запускает контейнеры и обрабатывает IPC. Без микросервисов, без брокеров сообщений.

Изоляция по группам

Каждая группа получает собственный контейнер, файловую систему, пространство имён IPC и сессию Claude. Группы не могут получить доступ к данным других групп.

Управление параллелизмом

GroupQueue ограничивает количество одновременных контейнеров (по умолчанию: 3). FIFO-порядок для каждой группы с повторами при сбоях с экспоненциальной задержкой.

IPC через файловую систему

Контейнеры взаимодействуют с хостом через JSON-файлы в каталогах для каждой группы. Хост опрашивает, проверяет авторизацию, выполняет и очищает.

Ключевые файлы

index.ts — Оркестратор — цикл опроса, обработка сообщений, вызов агентов
container-runner.ts — Запускает контейнеры с изолированными монтированиями, передаёт вывод потоком
group-queue.ts — FIFO-очередь для каждой группы с ограничением параллелизма и экспоненциальной задержкой повторов
ipc.ts — Обрабатывает IPC-запросы контейнеров с проверкой авторизации
db.ts — SQLite — сообщения, сессии, группы, задачи, состояние маршрутизатора
task-scheduler.ts — Выполнение запланированных задач по расписанию cron, через интервалы и одноразово

Философия

Принципы, определяющие каждое решение в NanoClaw.

🔍

Достаточно мал, чтобы понять

NanoClaw — это один процесс, несколько исходных файлов. Достаточно мал, чтобы вы могли прочитать и понять всю кодовую базу.

🛡️

Безопасность через изоляцию

Агенты работают в Linux-контейнерах. Они видят только то, что явно смонтировано. Bash безопасен, потому что выполняется внутри контейнера.

👤

Создан для одного пользователя

NanoClaw — не монолитный фреймворк. Это работающее ПО, подходящее именно вашим потребностям. Форкните и попросите Claude Code адаптировать его под вас.

🤖

ИИ-нативный

Никаких мастеров установки — Claude Code проведёт через настройку. Никаких панелей управления — спросите Claude. Никаких инструментов отладки — опишите проблему.

🧩

Навыки вместо функций

Участники добавляют навыки Claude Code, такие как /add-telegram, которые трансформируют вашу установку. В итоге вы получаете чистый код, делающий именно то, что вам нужно.

Лучшая обвязка, лучшая модель

Работает на Claude Agent SDK, что означает прямой запуск Claude Code. Обвязка важна. Хорошая обвязка даёт умным моделям сверхспособности.

Начните работу с NanoClaw за 3 строки

Клонируйте NanoClaw, перейдите в директорию, и пусть Claude сделает остальное.

Терминал
$ git clone https://github.com/qwibitai/nanoclaw.git
$ cd nanoclaw
$ claude

Затем выполните /setup Claude Code берёт на себя всё: зависимости, аутентификацию, настройку контейнеров, конфигурацию сервисов.

Требования

macOS или Linux Node.js 20+ Claude Code Apple Container (macOS) или Docker

В прессе

Вопросы и ответы

Чем NanoClaw отличается от OpenClaw?

NanoClaw (также известный как Nano Claw) использует принципиально иной подход. В то время как OpenClaw — это масштабный фреймворк с тысячами исходных файлов и десятками зависимостей, NanoClaw — это легковесный персональный ИИ-агент, построенный на основе 15 исходных файлов, которые можно прочитать и понять за один присест. NanoClaw использует контейнерную изоляцию на уровне ОС (Docker или Apple Container) для песочницы каждой сессии агента, вместо того чтобы полагаться на проверки разрешений на уровне приложения. Если вы ищете безопасную, минимальную альтернативу OpenClaw, которую можно полностью проверить и настроить, NanoClaw создан именно для этого.

Безопасен ли NanoClaw?

Безопасность — это основной принцип дизайна. Каждая сессия агента запускается внутри изолированного Linux-контейнера с собственной файловой системой, пространством имён IPC и пространством процессов. Агенты могут обращаться только к каталогам, которые явно смонтированы, и у них нет фонового доступа к вашей системе. Поскольку вся кодовая база составляет около 3 900 строк кода в 15 файлах, вы реально можете проверить всё, что делает программа. Это сочетание контейнерной изоляции и небольшой, проверяемой кодовой базы делает NanoClaw одним из наиболее прозрачных и безопасных способов запуска ИИ-агентов.

Какие мессенджеры поддерживает NanoClaw?

NanoClaw поставляется с поддержкой WhatsApp из коробки и может быть расширен для работы с Telegram, электронной почтой и другими каналами через систему навыков. Добавление Telegram так же просто, как запуск навыка /add-telegram, который проведёт вас через полную настройку. Архитектура спроектирована так, что каналы обмена сообщениями являются модульными, поэтому вы можете использовать один или несколько каналов параллельно, каждый со своей конфигурацией.

Какие среды выполнения контейнеров поддерживаются?

NanoClaw поддерживает как Apple Container, так и Docker. На macOS Apple Container обеспечивает быструю и легковесную песочницу, оптимизированную для Apple silicon, а Docker доступен как альтернатива. На Linux Docker используется автоматически. В процессе начальной настройки /setup вы выбираете среду выполнения на основе вашей платформы и предпочтений.

Можно ли запустить NanoClaw на Linux?

Да. NanoClaw работает как на macOS, так и на Linux. На Linux Docker используется в качестве среды выполнения контейнеров и настраивается автоматически при установке. Системные требования — Node.js 20 или новее, Claude Code и среда выполнения контейнеров (Docker на Linux). Навык /setup обрабатывает все проверки зависимостей и конфигурацию для вашей платформы.

Как настроить и сконфигурировать NanoClaw?

NanoClaw использует ИИ-нативный процесс настройки. После клонирования репозитория и запуска Claude Code вы запускаете навык /setup, который проведёт вас через установку зависимостей, аутентификацию каналов обмена сообщениями, настройку среды выполнения контейнеров и запуск фоновых сервисов. Никаких файлов конфигурации для ручного редактирования. Claude Code полностью управляет настройкой в интерактивном режиме. Для последующих изменений вы можете описать, что хотите, и Claude Code внесёт правки непосредственно в кодовую базу.

Как NanoClaw соотносится с другими фреймворками ИИ-агентов?

Большинство фреймворков ИИ-агентов рассчитаны на команды, создающие продукты. Они крупные, сложные и требуют значительных усилий для понимания. NanoClaw предназначен для людей, которым нужен персональный ИИ-ассистент, полностью принадлежащий им и контролируемый ими. Он работает как один процесс Node.js, использует реальную контейнерную изоляцию вместо песочницы на уровне приложения и достаточно мал, чтобы его можно было полностью понять. Он работает на Claude Agent SDK, давая вам прямой доступ к возможностям Claude без абстрактных прослоек.

Является ли NanoClaw проектом с открытым исходным кодом?

Да. Nano Claw — полностью открытый проект под лицензией MIT. Вся кодовая база доступна на GitHub, и вклады приветствуются. Проект поощряет форки и кастомизацию. Философия заключается в том, что ваш персональный ИИ-агент должен быть работающим ПО, настроенным под ваши точные нужды, а не универсальным фреймворком для конфигурирования.