Что такое NanoClaw и зачем он нужен на Raspberry Pi?

В эпоху тотальной цифровизации потребность в личном, приватном и управляемом ИИ-ассистенте становится всё более острой. Облачные решения удобны, но несут риски утечки данных и зависят от сторонней инфраструктуры. NanoClaw — это ответ на этот вызов: сверхлегковесный, самонастраиваемый AI-агент, способный работать на миниатюрном одноплатном компьютере Raspberry Pi и интегрироваться с вашими любимыми мессенджерами.

На момент проект активно развивается, имеет несколько форков и доказанную практику развертывания (в т.ч. министром Сингапура Вивианом Балакришнаном). В этой статье мы подробно разберем архитектуру, возможности, процесс установки и нюансы запуска NanoClaw на «малинке».

🎯 Что такое NanoClaw и зачем он нужен на Raspberry Pi?

NanoClaw — это легковесная альтернатива проекту OpenClaw, написанная на Python (основной линейки) и Go (форк PicoClaw). Ключевая философия: безопасность через изоляцию. Каждая сессия агента запускается в собственном контейнере (Docker или Apple Container), что предотвращает утечки данных и несанкционированный доступ к хостовой системе.

Главные преимущества для Raspberry Pi:

• Минимальные ресурсы: Основной процесс-шлюз (gateway) потребляет крайне мало RAM и CPU. Тяжелые вычисления (LLM) уходят в облако (Anthropic, OpenAI, OpenRouter, DeepSeek) или на локальный сервер (Ollama, llama.cpp).
• Автономность: Работает 24/7 без шума и перегрева, идеально для домашнего сервера.
• Приватность: Ваши сообщения, память и инструменты не покидают вашу локальную сеть (если используете локальные LLM).
• Кроссплатформенность: Один бот — доступ в WhatsApp, Telegram, Slack, Discord, Signal, Gmail и др.

Факт: По данным RaspberryTips (май 2026), даже слабые модели Raspberry Pi (например, Pi 3B/4 с 2-4 ГБ RAM) отлично справляются с ролью шлюза NanoClaw при использовании облачных LLM.

🏗 Архитектура и ключевые компоненты

Система построена по модульному принципу. Репозиторий grishahq/nanoClaw наглядно демонстрирует стек:

You (Telegram / Discord) --> nanoClaw Server --> LLM API (Anthropic / OpenRouter / OpenAI / DeepSeek / Local)
 | | | Agent Memory (SQLite)
 | |
 | Tools & MCP Clients
 | |
 | Security (6 layers)
 | |
 | Skills (/.nanoclaw/skills)
 | | | Loop
 v v
Dashboard (localhost:18790)

Основные блоки:

1. Шлюз (Gateway): Принимает вебхуки от мессенджеров, управляет очередями сообщений, авторизацией и маршрутизацией.
2. Агентный цикл (Agent Loop): Реализован на Anthropic Agents SDK. Обрабатывает контекст, вызывает инструменты, принимает решения.
3. Память (Memory): Персистентное хранение в SQLite. Позволяет ассистенту помнить контекст диалогов между перезагрузками, факты о пользователе, предпочтения.
4. Навыки (Skills): Модульная система расширения функционала (файлы в /.nanoclaw/skills). Можно писать свои на Python.
5. MCP Clients: Поддержка Model Context Protocol для подключения внешних источников данных и инструментов.
6. Безопасность (6 слоев): Изоляция контейнеров, песочница для выполнения кода, контроль прав доступа, шифрование секретов, аудит действий, rate-limiting.
7. Дашборд: Веб-интерфейс на localhost:18790 для мониторинга логов, управления памятью, настройки навыков и просмотра метрик.

📦 Поддерживаемые мессенджеры и каналы связи

NanoClaw выходит за рамки простого чат-бота. Это универсальный коммуникационный хаб.

🛠 Железо: Какая Raspberry Pi подойдет?

Требования зависят от стратегии запуска LLM:

Вариант А: Облачные LLM (Anthropic Claude, OpenAI GPT-4o, DeepSeek, OpenRouter)

• Модель: Raspberry Pi 3B+, 4 (2/4/8 ГБ), 5 (4/8/16 ГБ), Zero 2 W.
• RAM: 1-2 ГБ достаточно для шлюза + контейнеров.
• Диск: 8-16 ГБ microSD (лучше SSD через USB 3.0 для надежности).
• Сеть: Стабильный Ethernet или Wi-Fi 5/6.

Вариант Б: Локальные LLM (Ollama, llama.cpp, vLLM)

• Модель: Только Raspberry Pi 5 (8/16 ГБ RAM) или Compute Module 4/5 с 8+ ГБ.
• Модели: Квантованные 1.5B ⸺ 7B параметров (q4_k_m, q8_0).
• Производительность: ~2-5 токенов/сек на Pi 5 для 7B моделей. Для комфортной работы лучше вынести LLM на отдельный сервер с GPU.

Рекомендация 2026: Оптимальный баланс цены/качества — Raspberry Pi 5 8GB с NVMe SSD (через HAT+ или M.2 HAT). Это дает скорость диска > 800 МБ/с и достаточно памяти для параллельной работы контейнеров Docker.

🚀 Установка и развертывание (Пошаговое руководство)

Рассмотрим установку основного Python-форка (grishahq/nanoClaw или nanocoai/nanoclaw) через Docker Compose — самый надежный способ для продакшена.

Подготовка ОС

# Установка Raspberry Pi OS Lite (64-bit) через Raspberry Pi Imager

sudo apt update && sudo apt full-upgrade -y

curl -fsSL https://get.docker.com | sudo sh
sudo usermod -aG docker $USER
newgrp docker

Клонирование и конфигурация

git clone https://github.com/grishahq/nanoClaw.git
cd nanoClaw

cp .env.example .env

Настройка .env (Ключевой этап)

Откройте nano .env и заполните обязательные переменные:

• LLM_PROVIDER: anthropic, openrouter, openai, deepseek, ollama.
• API_KEY: Ваш ключ от провайдера (для OpenRouter — один ключ на сотни моделей).
• MODEL_NAME: Например, claude-3-5-sonnet-20241022, deepseek-chat, llama3.1:8b.
• MESSENGERS: Список включенных: telegram,whatsapp,discord.
• TELEGRAM_BOT_TOKEN: От @BotFather.
• WHATSAPP_SESSION_PATH: Путь к папке сессии (например, ./data/whatsapp).
• DASHBOARD_PORT: 18790 (по умолчанию).
• TZ: Europe/Moscow.

Запуск

# Сборка и запуск в фоне
docker compose up -d --build

docker compose logs -f nanoclaw

Авторизация мессенджеров

• Telegram: Работает сразу после ввода токена.
• WhatsApp: Откройте дашборд http://<IP_PI>:18790 -> раздел «Connections» -> нажмите «Connect WhatsApp» -> отсканируйте QR-код телефоном.
• Discord/Slack: Настройте Event Subscriptions / Interactions URL в Developer Portal на https://<ВАШ_ДОМЕН>/webhook/discord (требуется публичный IP или туннель Cloudflare Tunnel / Tailscale Funnel).

🧠 Продвинутые возможности: Память, Навыки и Запланированные задачи

Персистентная память (Long-term Memory)

В отличие от обычных чат-ботов, NanoClaw хранит факты в SQLite (/.nanoclaw/memory.db). Ассистент может: