Запуск AutoPilot на macOS

🍎 Запуск AutoPilot на macOS

Полная инструкция для первого запуска AutoPilot на Mac (Apple Silicon / Intel).

💡 Краткая версия есть в разделе FAQ → Запуск на macOS. Эта страница — полный гайд со всеми troubleshooting-кейсами.

📥 Где скачать сборку для macOS

Актуальные сборки выкладываются в AutoPilot Chat (Telegram) в отдельных ветках по биржам:

Ветка чата	Биржа
Updates Bybit	Bybit AutoPilot
Updates MEXC	MEXC AutoPilot
Updates Bitget	Bitget AutoPilot

Откройте нужную ветку → скачайте последнюю сборку с пометкой macOS → распакуйте архив в удобную папку (например, ~/Downloads/AutoPilot/) → переходите к шагам ниже.

💡 Apple Silicon vs Intel: обычно в чате выкладываются обе сборки — darwin-arm64 для M1/M2/M3/M4 и darwin-x64 для Intel. Как определить свой чип — см. раздел troubleshooting ниже.

📖 Про автообновление внутри софта — см. FAQ → Обновления.

Почему это сложнее, чем на Windows

macOS по умолчанию блокирует запуск неподписанных бинарных файлов, скачанных из интернета:

Файл AutoPilot в Finder выглядит как «документ», а не как программа
Система помещает его в карантин Gatekeeper — двойной клик не работает
Может появиться ошибка cannot be opened because the developer cannot be verified
Может появиться ошибка killed: 9 при попытке запуска

Это решается двумя командами в терминале. Один раз — и дальше запуск простой.

Пошаговая инструкция

Шаг 1 — открыть терминал

Запустите warp.dev (или Terminal.app через Spotlight ⌘ + Space).

Шаг 2 — перейти в папку с AutoPilot

cd ~/Downloads/AutoPilot

Лайфхак: наберите cd (с пробелом), перетащите папку с пилотом из Finder прямо в окно терминала — путь подставится сам. Затем нажмите Enter.

Проверьте, что вы в правильной папке:

ls

В выводе должен быть файл AutoPilot, рядом — AutoPilot.config, data/ и другие файлы пилота.

Шаг 3 — снять карантин (самое важное!)

Это главный шаг. Без него Mac видит файл как «документ» и не даёт запустить:

sudo xattr -r -c ./AutoPilot

Введите пароль от Mac (при вводе символы не отображаются — это нормально, так задумано системой).
xattr -c очищает расширенные атрибуты, включая com.apple.quarantine.
-r применяется рекурсивно (на случай, если AutoPilot внутри папки с другими файлами).

Если sudo не сработает — попробуйте без него: xattr -c ./AutoPilot

Шаг 4 — сделать файл исполняемым

chmod +x ./AutoPilot

Шаг 5 — запустить

./AutoPilot

Если всё сделано правильно — AutoPilot запустится в окне терминала, прочитает AutoPilot.config и начнёт работу.

Если что-то пошло не так

❌ `zsh: killed` или `Killed: 9` при запуске

Карантин не снялся. Снимите его со всей папки рекурсивно:

sudo xattr -rc .

Точка в конце = текущая папка со всем содержимым.

❌ `Operation not permitted` на `chmod`

Выполните с sudo:

sudo chmod +x ./AutoPilot

❌ `cannot be opened because the developer cannot be verified`

Откройте System Settings → Privacy & Security
Прокрутите вниз до раздела Security
Найдите сообщение про AutoPilot → нажмите кнопку «Open Anyway»
Вернитесь в терминал и снова: ./AutoPilot

❌ `No such file or directory`

Вы не в той папке. Проверьте:

pwd     # покажет текущий путь
ls      # покажет список файлов

Убедитесь, что в ls есть файл AutoPilot.

❌ `bad CPU type` или `Exec format error`

Скачана версия для другой архитектуры. Проверьте свой Mac: ⌘ + Space → System Information → раздел Hardware → Chip:

Что у вас	Нужна сборка
🟢 Apple M1 / M2 / M3 / M4	`darwin-arm64`
🔵 Intel Core i5 / i7 / i9	`darwin-x64`

Скачайте правильную версию у поставщика.

❌ Mac видит файл как «документ» в Finder

Это нормально — запуск только через терминал командой ./AutoPilot. Двойной клик по unsigned бинарнику в Finder на macOS принципиально не работает. Иконка файла в Finder не меняется даже после chmod +x.

Краткая шпаргалка

Скопируйте и выполните по очереди (не забудьте подставить свой путь):

cd ~/Downloads/AutoPilot            # ← подставьте ваш путь к папке
sudo xattr -r -c ./AutoPilot        # снять карантин macOS
chmod +x ./AutoPilot                # сделать исполняемым
./AutoPilot                         # запустить

После первого запуска

Шаги 3 и 4 больше не нужны — при последующих запусках достаточно:

cd ~/Downloads/AutoPilot
./AutoPilot

Атрибуты карантина и права на исполнение сохраняются до тех пор, пока файл не будет повторно скачан или перемещён в другую папку.

После обновления

Когда AutoPilot скачает новую версию (см. FAQ → Обновления) и вы распакуете архив с заменой файла:

Права на исполнение сбрасываются — снова нужен chmod +x ./AutoPilot
Карантин появляется заново (файл скачан заново) — снова нужен sudo xattr -r -c ./AutoPilot

То есть после каждого обновления повторите шаги 3 и 4 из инструкции выше.

FAQ

Q: Надо ли это делать каждый раз? A: Нет. Только при первом запуске или после обновления AutoPilot (когда новый бинарник заменяет старый).

Q: Безопасно ли sudo xattr -r -c? A: Да. Команда не меняет содержимое файла, только снимает метку «скачано из интернета», которую macOS ставит автоматически на все загруженные файлы.

Q: Можно ли запускать двойным кликом, как обычную программу? A: Нет. AutoPilot — это консольное приложение, а не .app-пакет. Запуск только через терминал командой ./AutoPilot.

Q: Что делать, если терминал закрылся, а AutoPilot ещё работает? A: Процесс продолжит работать в фоне. Чтобы посмотреть логи, откройте папку logs/ в папке пилота. Чтобы остановить — найдите процесс через Activity Monitor или выполните killall AutoPilot в новом терминале.

Q: Нужен ли warp.dev, или хватит обычного Terminal.app? A: Хватит обычного. warp.dev удобнее (копипаст, подсказки, история), но это не обязательно.

Q: Mac спрашивает пароль при sudo — какой вводить? A: Пароль от вашего пользователя Mac (тот же, которым вы входите в систему). При вводе символы не отображаются — это нормально, просто наберите пароль и нажмите Enter.

Q: Gatekeeper не даёт запустить даже после xattr -c? A: Перезагрузите Mac и повторите шаги. Если не помогло — используйте обходной путь через System Settings → Privacy & Security → Open Anyway (см. выше).

🔙 Назад: FAQ → Запуск на macOS