Часто задаваемые вопросы
Частые вопросы о NanoClaw и принципах его работы.
NanoClaw — это лёгкий open-source персональный ИИ-ассистент, построенный на Anthropic Claude Agent SDK. Агенты работают в изолированных Linux-контейнерах (Apple Container на macOS, Docker на macOS/Linux). WhatsApp встроен, другие каналы через навыки. Постоянная память SQLite, запланированные задачи, веб-доступ, автоматизация браузера и Agent Swarms.
Выполните 'git clone https://github.com/qwibitai/NanoClaw.git && cd NanoClaw && claude' и используйте /setup в сессии Claude. Claude Code установит зависимости, настроит аутентификацию, контейнеры и сервис. Требуется Node.js 20+ и Claude Code.
NanoClaw достаточно мал, чтобы разобраться — один процесс, несколько исходных файлов, никаких микросервисов. В отличие от раздутых фреймворков, вы можете прочитать всю кодовую базу. Агенты работают в настоящих Linux-контейнерах с изоляцией файловой системы, а не за проверками разрешений на уровне приложения.
NanoClaw работает исключительно на Anthropic Claude Agent SDK. Claude Code установлен глобально внутри каждого контейнера и обрабатывает все ИИ-взаимодействия. SDK управляет выбором модели самостоятельно — NanoClaw использует одного провайдера по замыслу.
WhatsApp — встроенный канал (через библиотеку Baileys, привязка по QR-коду). Telegram, Discord и Slack можно добавить через навыки Claude Code — запустите /add-telegram, /add-discord или /add-slack. Навыки модифицируют исходный код вашего форка, добавляя чистую поддержку канала.
Безопасность — ключевой принцип проектирования. Агенты работают в Linux-контейнерах (Apple Container на macOS, Docker на macOS/Linux) с изоляцией файловой системы — не за проверками разрешений на уровне приложения. Секреты передаются через stdin JSON и никогда не загружаются в process.env. Списки разрешённых монтирований с обнаружением обхода через симлинки. Контейнеры работают без root с монтированием проекта только для чтения.
NanoClaw использует SQLite (better-sqlite3) для постоянного хранения — сообщения, группы, сессии, запланированные задачи и состояние маршрутизатора. У каждой группы также есть собственный файл CLAUDE.md для памяти группы, монтируемый в контейнер. Внешняя база данных не нужна.
Да. NanoClaw работает на macOS и Linux — везде, где работают Node.js 20+ и Docker. Лёгкое ядро на TypeScript подходит для устройств с ограниченными ресурсами, включая Raspberry Pi. Требуется среда выполнения контейнеров (Apple Container или Docker) и ключ Anthropic API.
Agent Swarms позволяет NanoClaw запускать команды специализированных агентов, которые совместно работают над сложными задачами. NanoClaw — первый персональный ИИ-ассистент с поддержкой роёв агентов, построенный на возможности agent-teams Claude Code.
Проект распространяется под лицензией MIT с открытым исходным кодом на github.com/qwibitai/nanoclaw. Ознакомьтесь с README для руководства по участию. Любой вклад приветствуется.
Встроенные инструменты предоставляются Claude Code, работающим внутри контейнеров: команды оболочки, чтение/запись файлов, веб-поиск, работа с браузером (Chromium) и делегирование агентам (рои). Хост-процесс обеспечивает запланированные задачи (cron), постоянную память SQLite и обмен сообщениями WhatsApp. Расширяйте функциональность, добавляя навыки.
Да. В каждом контейнере агента установлены Chromium и agent-browser для автоматизации браузера. Claude Code может искать в интернете и просматривать страницы для получения актуальной информации внутри изолированного контейнера.
Официальный и единственный доверенный репозиторий — github.com/qwibitai/nanoclaw. Discord сообщества — discord.gg/VDdww8qS42.
macOS и Linux. Требуется Node.js 20+ и среда выполнения контейнеров — Apple Container на macOS или Docker на macOS/Linux. Windows официально не поддерживается, но может работать через WSL2 с Docker.
NanoClaw использует исключительно Anthropic Claude через Claude Agent SDK. Укажите ANTHROPIC_API_KEY в файле .env или пройдите аутентификацию через Claude Code OAuth. Поддержка нескольких провайдеров отсутствует — SDK управляет выбором модели самостоятельно.
README в репозитории GitHub (github.com/qwibitai/nanoclaw) — основной источник документации. Директория docs/ содержит спецификации архитектуры, модель безопасности и чек-лист отладки. Кодовая база достаточно мала, чтобы попросить Claude Code провести вас по ней.
Официальные каналы: Discord (discord.gg/VDdww8qS42) и GitHub (github.com/qwibitai/nanoclaw). Все ссылки на сообщество — в README.