Руководство по установке

Запуск NanoClaw

Лёгкое ядро на TypeScript, один путь установки. Клонируй, запусти claude, используй /setup.

checklist Системные требования

javascript Node.js

Node.js 20+ (рекомендуется LTS)

computer OS

macOS или Linux. Windows через WSL2 может работать, но официально не поддерживается.

memory RAM

512 МБ+ ОЗУ. Лёгкая среда выполнения, без тяжёлой компиляции.

hard_drive Disk

~50 МБ после установки (node_modules). Образ контейнера добавляет ~500 МБ.

extension Optional

Требуется: Apple Container (macOS) или Docker (macOS/Linux). Требуется: Claude Code CLI.

wifi Network

Интернет необходим для вызовов Anthropic API. Офлайн-режим отсутствует.

Клонируйте репозиторий и запустите через Claude CLI. Готово за считанные минуты.

bolt

One-Liner

Requires Claude CLI. All platforms.

$ git clone https://github.com/qwibitai/NanoClaw.git && cd NanoClaw && claude

list_alt

Step-by-Step

Clone first, then configure. More control.

$ git clone https://github.com/qwibitai/NanoClaw.git

$ cd NanoClaw && npm install

$ # Run claude and use /setup for guided configuration

$ # Or edit .env and src/index.ts directly

verified Проверка установки

Выполните эти команды, чтобы убедиться, что NanoClaw установлен правильно.

$ node -e "console.log(require('./package.json').version)"

Должен вывести номер установленной версии.

$ npm test

Запускает набор тестов (vitest) для проверки зависимостей и основной функциональности.

$ claude

Открывает Claude Code. Запустите /setup внутри сессии для пошаговой настройки.

settings Начальная настройка

Claude Code выполняет настройку через /setup. Вот что он конфигурирует.

Установка зависимостей

Claude Code запускает npm install и собирает образ контейнера (nanoclaw-agent:latest) с предустановленными Chromium, agent-browser и Claude Code.

Аутентификация

Укажите ANTHROPIC_API_KEY в .env или пройдите аутентификацию через Claude Code OAuth. Секреты передаются контейнерам во время выполнения и никогда не загружаются в process.env.

Подключение WhatsApp

Запустите 'npm run auth' для привязки по QR-коду. WhatsApp — встроенный канал. Добавьте Telegram, Discord или Slack позже через навыки (/add-telegram, /add-discord, /add-slack).

Запуск агента

Запустите 'npm start' для запуска NanoClaw. Он подключится к WhatsApp, запустит цикл опроса сообщений и начнёт обработку сообщений в изолированных контейнерах.

.env — NanoClaw не использует файлы конфигурации. Чтобы внести изменения, скажите Claude Code, что вам нужно. Кодовая база достаточно мала, чтобы Claude мог безопасно её модифицировать.

system_update_alt Обновление NanoClaw

Обновляйте NanoClaw, чтобы получать новые функции, интеграции и исправления безопасности.

Git + npm

$ cd NanoClaw && git pull && npm install

Docker

$ cd NanoClaw && git pull && docker compose up --build

Смотрите список изменений на github.com/qwibitai/nanoclaw/releases, чтобы узнать, что нового в каждой версии.

build Устранение неполадок

Частые проблемы и способы их решения.

Нужна помощь?

Присоединяйтесь к нашему сообществу для помощи с установкой и устранением неполадок.

forum Присоединиться к Discord menu_book Читать документацию

hub Интеграции • article Блог • menu_book Документация