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

Что такое NanoClaw

NanoClaw это ИИ-ассистент с открытым исходным кодом, который вы запускаете на своём компьютере. Он написан на TypeScript под лицензией MIT. В README он назван лёгкой альтернативой OpenClaw (github.com/nanocoai/nanoclaw, прочитано 2 октября 2026 года). Последний релиз 2.4.0 вышел 23 сентября 2026 года.

Главное отличие в изоляции. Каждый агент работает в собственном Linux-контейнере. Он видит только те папки, которые вы в него монтируете. Агент построен на Claude Agent SDK от Anthropic. Вы общаетесь с ним из мессенджеров, например WhatsApp, Telegram, Discord, Slack, Teams или iMessage. Каждый канал добавляется своим навыком настройки.

Требования

Они взяты из документации NanoClaw по установке (docs.nanoclaw.dev).

• macOS или Linux, минимум 4 GB памяти. Установщик предупреждает, если памяти меньше 3 700 MB.
• Git, чтобы скачать код. Установщик сам его не добавляет.
• Docker Desktop на macOS. Агенты работают в контейнерах Docker. Если Docker Desktop нет, установщик добавляет его через Homebrew.
• Node 22 или новее и pnpm 10 или новее. Если их нет, установщик добавляет оба.
• Claude Code на Mac. NanoClaw использует его, чтобы исправлять неудачные шаги настройки и добавлять каналы.
• Учётные данные для модели. Настройка предлагает Claude или Codex. В этом руководстве используется API-ключ Anthropic, за который Anthropic берёт плату по факту использования.

Установка

Сначала проверьте, что Git есть. Если строка начинается с git version, он установлен.

git --version

Затем выполните эти четыре команды из официального быстрого старта, по одной строке.

cd ~
git clone https://github.com/nanocoai/nanoclaw.git
cd nanoclaw
bash nanoclaw.sh

Скрипт проверяет машину и ставит недостающее. Затем мастер настройки задаёт несколько вопросов. Документация советует выбрать Standard setup, затем Fresh agent. На всё закладывается от 30 до 60 минут.

• Образ песочницы. Вариант Fetch the hardened image требует бесплатного аккаунта NanoClaw. Вариант Build it here не требует аккаунта и занимает несколько минут.
• ИИ-сервис. Выберите Claude, затем Paste an Anthropic API key. Настройка хранит ключ в локальном хранилище OneCLI. В контейнер агента он никогда не попадает.
• Сервис. Настройка запускает NanoClaw в фоне и отправляет тестовое сообщение, чтобы проверить, что агент отвечает.

Настройка также предлагает вход через подписку. Если собираетесь его использовать, сначала проверьте, что условия вашего провайдера говорят о сторонних инструментах.

После настройки отправьте сообщение из папки nanoclaw. Текст в кавычках это ваше сообщение. Чтобы снова запустить полную проверку, используйте шаг verify.

cd ~/nanoclaw
pnpm run chat "Help me plan one of those weekend ideas."
pnpm run setup -- --step verify

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

Работа 24/7

Настройка устанавливает LaunchAgent в папку LaunchAgents внутри Library в домашней папке. Его имя выглядит как com.nanoclaw-v2 плюс короткий код вашей копии. В нём заданы RunAtLoad и KeepAlive. Поэтому он запускается при входе и перезапускается после сбоя. Вот документированные команды.

# Find your label
launchctl list | grep nanoclaw

# Restart
launchctl kickstart -k gui/$(id -u)/com.nanoclaw-v2-<slug>

# Stop / start
launchctl unload ~/Library/LaunchAgents/com.nanoclaw-v2-<slug>.plist
launchctl load   ~/Library/LaunchAgents/com.nanoclaw-v2-<slug>.plist

# Logs (stdout and stderr go to files, not the system log)
tail -f logs/nanoclaw.log logs/nanoclaw.error.log

Docker тоже должен работать. Если он не запущен, ни один агент не стартует. Документация по устранению неполадок советует запустить Docker Desktop, проверить, что работает docker info, и затем перезапустить NanoClaw. В настройках Docker Desktop включите запуск при входе в систему.

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

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

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

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

• Агенты видят только разрешённые вами папки. Файл allowlist называется mount-allowlist.json и лежит в ~/.config/nanoclaw, вне checkout. После свежей установки он пуст.
• У агентов никогда нет вашего API-ключа в открытом виде. Исходящие запросы идут через хранилище, которое подставляет ключ в момент запроса.
• Настройка отправляет анонимную диагностику. Чтобы её отключить, задайте NANOCLAW_NO_DIAGNOSTICS=1.
• В документации есть страница об усилении защиты для более строгих конфигураций. Там описаны ограничения сетевого доступа, кто может писать агенту и какие команды ему можно запускать.

Контейнеры помогают, но выделенная машина помогает сильнее. Запускайте NanoClaw на Mac, где нет больше ничего вашего. Если агент сделает что-то странное, ущерб не выйдет за пределы этой машины. Чтобы потом удалить NanoClaw, в документации есть флаг удаления. Добавьте --dry-run, чтобы заранее увидеть, что будет удалено.

bash nanoclaw.sh --uninstall

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

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

У базового M6 16 GB памяти, намного больше минимума в 4 GB. Тариф «Агент» стоит $169 в месяц. MacRun не продаёт API-ключи. Используйте API-ключ своего провайдера модели. Он берёт с вас плату за использование по своим условиям.

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

Если у вас уже есть Mac, который не выключается и остаётся в системе, используйте его. Шаги выше те же. NanoClaw работает и на Linux с Docker Engine. Если от macOS вам ничего не нужно, небольшой Linux-сервер обойдётся дешевле любого Mac.

К тому же MacRun предназначен для работы разработчика по нашей политике допустимого использования. NanoClaw, который проверяет код, следит за CI или пишет заметки к релизам, подходит. Тот, что ведёт ваш семейный чат, нет. Хотите попробовать на машине, которая не выключается? Загляните на страницу Mac для агентов.