Начало работы с Nanobot: создайте первого ИИ-агента

Введение

Nanobot выступает удобной альтернативой OpenClaw для повседневных задач. Фреймворк отличается легкостью установки, простотой настройки и легким подключением к WhatsApp без лишних сложностей. Репозиторий HKUDS/nanobot на GitHub уже привлекает внимание пользователей, о чем свидетельствуют обсуждения на YouTube.

В этом руководстве разберут архитектуру Nanobot и принцип его работы. Далее следуют шесть шагов по установке, настройке и интеграции с WhatsApp. Это позволит запустить круглосуточного ИИ-агента для решения разнообразных задач.

Nanobot идеален для первого опыта с ИИ-агентами: простая структура сочетается с ключевыми возможностями для реального применения. Поддерживаются мессенджеры вроде WhatsApp, Telegram, Slack, Discord, Feishu, QQ и email, а также множество провайдеров моделей и серверов с протоколом MCP. Новичкам проще разобраться в устройстве агента без избыточной сложности.

По сравнению с OpenClaw, Nanobot предлагает готовые интеграции и удобство с самого начала. Помимо каналов связи, доступны вызов инструментов, поиск в сети, планировщик задач, транскрипция голоса, потоковая передача прогресса в реальном времени и выбор провайдеров. Это превращает проект в практического помощника, а не просто демонстрацию.

Шаг 1: Установка uv

Сначала установите uv — менеджер окружений Python и зависимостей для Nanobot. Проверьте успешность установки версией.

curl -LsSf https://astral.sh/uv/install.sh | sh

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

uv --version

Результат:

uv 0.10.9 (f675560f3 2026-03-06)

Шаг 2: Установка Nanobot

После установки uv добавьте пакет Nanobot. Это установит CLI-интерфейс для запуска из терминала.

uv tool install nanobot-ai

Шаг 3: Инициализация проекта Nanobot

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

nanobot onboard

Команда создаст локальную среду: директорию конфигурации ~/.nanobot и рабочее пространство для файлов. Теперь можно настраивать провайдера, модель и каналы.

Шаг 4: Настройка конфигурации Nanobot

Откройте файл ~/.nanobot/config.json и вставьте приведенную конфигурацию. Замените заглушки на свой API-ключ OpenAI, модель и номер WhatsApp.

{ 
  "providers": { 
    "openai": { 
      "apiKey": "sk-REPLACE_ME" 
    } 
  }, 
  "agents": { 
    "defaults": { 
      "model": "openai/gpt-5.3-codex", 
      "provider": "openai" 
    } 
  }, 
  "channels": { 
    "whatsapp": { 
      "enabled": true, 
      "allowFrom": ["1234567890"] 
    } 
  } 
}

Перед сохранением отредактируйте:

• apiKey — на реальный API-ключ OpenAI
• model — при выборе другой модели
• allowFrom — на свой номер WhatsApp

Важный нюанс: формат allowFrom для WhatsApp иногда работает нестабильно. Пользователи отмечают, что без знака "+" подключение проходит надежнее в зависимости от окружения.

Шаг 5: Подключение Nanobot к WhatsApp

Убедитесь, что на машине установлены Node.js и npm: мост WhatsApp использует Node-процесс.

В первом терминале запустите авторизацию:

nanobot channels login whatsapp

Отсканируйте QR-код из WhatsApp на телефоне: Настройки → Связанные устройства. После линковки в втором терминале запустите шлюз Nanobot:

nanobot gateway

Шлюз обеспечивает прием и отправку сообщений в WhatsApp.

Шаг 6: Тестирование ИИ-агента в WhatsApp

Для проверки нужен второй телефон с номером из allowFrom. Отправьте сообщение на номер, подключенный к Nanobot — агент ответит.

Например, запрос о мировых событиях: Nanobot обработает его, при необходимости выполнит поиск в сети и выдаст актуальную сводку.

В терминале шлюза видно весь процесс: прием сообщения, вызов инструментов, генерацию ответа и отправку. Это помогает убедиться в корректной работе.

Заключение

Настройка Nanobot демонстрирует: создание личного ИИ-агента не требует сложностей. Быстрый переход от терминала к работающему боту в WhatsApp дает полезные ответы на практике.

Возможны мелкие проблемы. На Windows скрипт иногда не находит npm из-за конфигурации Node.js, что усложняет старт. Документация по WhatsApp скудна: не сразу ясно, что взаимодействие идет напрямую через связанное устройство, без отдельного чата бота.

Несмотря на это, Nanobot — отличная база для первого агента. Минималистичный подход без лишнего груза. После запуска ценность очевидна: от команд в терминале к полноценному помощнику.