Как установить nanobot на Mac mini

Что такое nanobot

nanobot это личный ИИ-агент с открытым исходным кодом от группы HKUDS на GitHub. Он написан на Python под лицензией MIT. Как и OpenClaw, он хранит память, запускает инструменты и отвечает вам из мессенджеров. Его ядро сделано маленьким и читаемым (github.com/HKUDS/nanobot, прочитано 2 октября 2026 года). Последний релиз на PyPI 0.3.5 вышел 15 сентября 2026 года.

Пользоваться им можно в WebUI в браузере, в терминале или из Telegram, Discord, Slack, Email и других каналов. Он умеет работать с файлами, выполнять команды оболочки, искать в интернете, использовать MCP-серверы и запускать задачи по расписанию. Ещё одно замечание про имя. Это не obot-platform/nanobot, фреймворк на Go для создания MCP-агентов.

Требования

• Python 3.11 или новее. Проверьте командой python3 --version. Если установщик его не найдёт, он остановится, так что при необходимости сначала установите Python.
• macOS 13 или новее. Готовые пакеты для Mac на Apple silicon и Intel включают WebUI и интерфейс для терминала.
• Провайдер модели. Anthropic, OpenAI, OpenRouter и локальные серверы вроде Ollama описаны в документации по провайдерам. Используйте API-ключ выбранного провайдера.
• Git и Bun, но только если вы ставите из исходников. Обычной установке они не нужны.

Установка

Запустите официальный установщик в одну команду из README.

curl -fsSL https://raw.githubusercontent.com/HKUDS/nanobot/main/scripts/install.sh | sh

Он устанавливает пакет nanobot-ai из PyPI. Он избегает установки через pip на уровне всей системы. Он использует активное виртуальное окружение, uv, pipx или собственное окружение в папке .nanobot в домашней папке. Затем он выводит точную команду, которую использовал. Чтобы посмотреть план без изменений, добавьте флаг dry run.

curl -fsSL https://raw.githubusercontent.com/HKUDS/nanobot/main/scripts/install.sh | sh -s -- --dry-run

Если вы уже пользуетесь uv, то же самое делает эта команда. Затем проверьте версию.

uv tool install nanobot-ai
nanobot --version

Первый запуск и модель

Для первого запуска README рекомендует WebUI. Он открывается на 127.0.0.1, порт 8765, и слушает только этот Mac.

nanobot webui

Откройте Settings, затем Models. Выберите провайдера, вставьте его API-ключ и выберите модель. Затем начните новую тему и отправьте Hello. Любой нормальный ответ значит, что провайдер, модель и gateway работают вместе. Из терминала то же самое проверяет разовое сообщение.

nanobot -m "Hello!"

Настройки сохраняются в config.json в папке .nanobot в домашней папке. Мы ещё не запускали эту установку на своей тестовой машине. Команды здесь скопированы из README и документации nanobot по состоянию на 2 октября 2026 года.

Работа 24/7

Gateway это часть, которая остаётся в сети. Она поддерживает работу мессенджеров, задач по расписанию и памяти. Эта команда оставляет его работать после закрытия терминала.

nanobot gateway --background

Перезагрузку это не переживёт. Для этого документация по развёртыванию устанавливает LaunchAgent. Сначала закончите настройку модели в WebUI. Затем посмотрите файл сервиса заранее и установите его.

nanobot gateway install-service --manager launchd --dry-run
nanobot gateway install-service --manager launchd

Он записывает ai.nanobot.gateway.plist в папку LaunchAgents внутри Library в домашней папке. Gateway запускается тем же Python, которым был установлен nanobot. Журналы пишутся в папку logs внутри .nanobot. Если он падает с ошибкой address already in use, сначала остановите gateway, который вы запустили вручную.

launchctl list | grep ai.nanobot.gateway
launchctl kickstart -k gui/$(id -u)/ai.nanobot.gateway
nanobot gateway uninstall-service --manager launchd

Gateway читает config.json только при запуске. Перезапускайте его после каждого изменения конфигурации.

LaunchAgent работает, только пока пользователь вошёл в систему. На Mac без присмотра включите автоматический вход для аккаунта, под которым работает nanobot. Затем запретите Mac засыпать. Сон приостанавливает gateway и его задачи по расписанию.

sudo pmset -a sleep 0
sudo pmset -a disksleep 0
sudo pmset -a displaysleep 10

Подробнее в статье о том, что происходит, когда Mac засыпает и в руководстве по всегда включённому Mac.

Безопасность

• Для продакшена документация советует две настройки вместе. Установите restrictToWorkspace в true, а tools.exec.sandbox в seatbelt на macOS. Seatbelt ограничивает команды оболочки папкой рабочего пространства.
• Ни одна из этих настроек не ограничивает доступ к сети. Храните секреты вне рабочего пространства.
• WebUI и проверка состояния gateway по умолчанию слушают 127.0.0.1. Оставьте их доступными только с этого Mac.
• Незнакомые отправители в мессенджерах получают код привязки, а не ответ. Вы одобряете их командой /pairing approve с их кодом.
• Документация предлагает ссылаться на API-ключи через переменные окружения, а не хранить ключи в config.json. В любом случае обращайтесь с папкой .nanobot как с файлом паролей.

Самая простая защита это Mac, где нет больше ничего вашего. Если агент сделает что-то странное, ущерб не выйдет за пределы этой машины.

Запуск на Mac от MacRun

Наш тариф «Агент» это выделенный Mac mini, который никогда не засыпает. Он стоит на нашей собственной частной площадке в Нью-Джерси. После перезагрузки его сессия входа восстанавливается сама, поэтому LaunchAgent nanobot снова запускается. Claude Code и Codex предустановлены. nanobot нет. Вы ставите его сами, при необходимости вместе с Python, потому что у вас полные права администратора.

WebUI можно открыть в браузере самого Mac через наш рабочий стол в браузере. Тариф «Агент» стоит $169 в месяц. MacRun не продаёт API-ключи. Используйте API-ключ своего провайдера модели. Он берёт с вас плату за использование по своим условиям.

Когда MacRun вам не нужен

nanobot маленький и работает почти где угодно. В документации описаны сервисы Linux, Docker и развёртывание на Render в один клик. Если от macOS вам ничего не нужно, любой из этих вариантов обойдётся дешевле Mac. А если у вас уже есть Mac, который не выключается и остаётся в системе, используйте его.

MacRun предназначен для работы разработчика по нашей политике допустимого использования. nanobot, который разбирает issues или выполняет ночную рутину в репозитории, подходит. Тот, что ведёт вашу личную почту, нет. Чтобы сравнить тарифы, загляните на страницу Mac для агентов.