Кратко

При первой установке OpenClaw чаще мешает не «не умею копировать команды», а непонимание, что именно проверяет каждый шаг. Терминал без ошибок, открытый Dashboard, ответ модели и запись файла — четыре разные контрольные точки. Ниже одна линия: подготовка → установка → настройка → права → Dashboard → первый тест. При сбое вы будете знать, куда смотреть логи.

0 Что даст это руководство

После прохождения вы подтвердите четыре вещи: ① CLI и Gateway установлены; ② provider модели и API Key работают; ③ в браузере открывается локальный Control UI; ④ в тестовой папке выполнено одно низкорисковое чтение/запись. Цель не «поставил программу», а «агент работает в контролируемых границах, а при ошибке я сам разберусь».

4 шага
Контроль: CLI / модель / UI / файлы
5 мин
Минимальное время по официальной документации
1 папка
Изолированный тестовый каталог

1 Подготовка: Mac, сеть и тестовая папка

Действие: собрать окружение до установки. Зачем: без одного пункта вы застрянете на полпути. Успех: открывается Terminal, доступна официальная инструкция, создана тестовая папка.

  • Система — macOS (Apple Silicon или Intel). Нужен Node 24 (рекомендуется) или Node 22.19+; официальный скрипт установит Node сам — Homebrew не обязателен.
  • Сеть и права — доступ к openclaw.ai и к провайдеру модели; для установки и LaunchAgent нужен пароль администратора Mac.
  • Аккаунт модели — регистрация у Anthropic, OpenAI, OpenRouter и т.д.; получите API Key (ключ доступа к облачной модели — как пароль: не публикуйте и не коммитьте в Git).
  • Тестовая папка — например ~/openclaw-test с файлом notes.txt. Рабочий каталог — зона, где агенту разрешено читать и писать; сначала только она.
Если не получается: сайт не открывается → сеть/DNS; нет прав администратора → другой пользователь macOS. Новичкам нельзя: отключать Gatekeeper/SIP/файрвол, запускать неизвестные «скрипты в один клик», класть API Key в публичный репозиторий.

2 Установка: только официальный источник

Действие: поставить OpenClaw CLI и Gateway. Зачем: сторонние сборки могут быть подменены. Успех: openclaw --version показывает номер версии.

На Mac (скрипт сам определит ОС, поставит Node и запустит мастер):

curl -fsSL https://openclaw.ai/install.sh | bash

Если Node уже настроен вручную: npm install -g openclaw@latest, затем openclaw onboard --install-daemon (фоновый сервис macOS через LaunchAgent).

Сохраните версию и полный вывод терминала (скрин или заметка) — при ошибке сверяйтесь с официальным Troubleshooting. Проверка:

openclaw --version · openclaw doctor · openclaw gateway status

Если openclaw: command not found, добавьте $(npm prefix -g)/bin в PATH в ~/.zshrc, перезапустите Terminal (документация).

3 Настройка: provider, API Key и конфиг

Коротко по терминам: provider модели — облачный сервис (Anthropic, OpenAI…); API Key — ключ доступа; переменные окружения — временные значения в терминале (export ANTHROPIC_API_KEY=...); конфиг — постоянные настройки в ~/.openclaw/openclaw.json (JSON5); локальная модель — Ollama на Mac. В первый раз достаточно облачного Key.

Мастер onboard (выбор provider, вставка Key, модель по умолчанию):

openclaw onboard --install-daemon

Успех: openclaw doctor без блокирующих ошибок; в Dashboard или CLI фраза «Привет» получает ответ модели. Если нет: Key скопирован целиком, баланс/лимиты аккаунта, прокси не режет HTTPS.

4 Права: сначала только тестовая папка

Действие: ограничить пути чтения/записи и внимательно отвечать на запросы macOS. Зачем: доступ ко всему диску = весь Mac у автоматизации. Успех: тест создаёт файлы только в ~/openclaw-test.

Названия в «Системных настройках» (файлы, автоматизация, специальные возможности) меняются с версией macOS — сверяйтесь с экраном. Рекомендации:

  • Разрешите только тестовую папку — не «весь диск» и не корень iCloud с первого раза.
  • Календарь, контакты, запись экрана — отклоните, пока не нужны для вашего сценария.
  • Не выставляйте порт Gateway в интернет; дома достаточно localhost или VPN.

5 Dashboard: локальный адрес и удалённый Mac

Действие: открыть Control UI в браузере. Зачем: визуально убедиться, что Gateway работает. Успех: страница грузится, сообщения уходят.

В Terminal: openclaw dashboard или в браузере http://127.0.0.1:18789/ (только с этого Mac).

СимптомВероятная причинаСначала сделайте
Нет соединенияGateway не запущенopenclaw gateway status, при необходимости openclaw onboard --install-daemon
На Mac открывается, с другого ПК — нетСлушает только 127.0.0.1SSH-туннель: ssh -L 18789:127.0.0.1:18789 user@mac, затем тот же URL локально
Адрес верный, белый экранКэш/расширения браузераSafari в режиме инкогнито или отключите блокировщики

Логи — доказательство при отладке: при сбое Gateway сопоставьте openclaw doctor с Help / Troubleshooting, не меняйте конфиг наугад.

6 Первый запуск: низкорисковое задание

В ~/openclaw-test/notes.txt две строки, например «Код проекта: Alpha». В Dashboard или CLI отправьте:

Прочитай notes.txt в папке openclaw-test, кратко перескажи в трёх предложениях и сохрани summary.md в той же папке.

Считается успехом, если: ① ответ модели совпадает с файлом; ② появился summary.md; ③ openclaw doctor без ошибок; ④ в логах есть запись запроса. Не пишется файл — сначала права macOS, а не «сломалась модель».

7 Частые ошибки новичков

1

command not found

В PATH нет глобального npm bin → поправьте ~/.zshrc, перезапустите Terminal.

2

Неверный API Key / 401

Новый Key, тот же provider, что в onboard; проверьте пробелы при вставке.

3

Dashboard не открывается

Сначала gateway status, затем порт и правильный Mac (локальный vs удалённый).

4

Отказ в доступе / нет записи

Настройки → Конфиденциальность — доступ Terminal/OpenClaw только к тестовой папке.

Дальше

После теста постепенно подключайте рабочие каталоги, Telegram/Slack, календарь. На каждом шаге: узкий эксперимент → логи → расширение.

  1. 1Разрешённый каталог: с тестовой папки на один непродакшен-репозиторий
  2. 2В openclaw.json — белый список каналов (например allowFrom)
  3. 3Для 24/7 проверьте автозапуск LaunchAgent и периодически openclaw doctor

8 OpenClaw на Mac mini — проще и тише

OpenClaw — самостоятельный Gateway: для круглосуточной работы и чётких границ прав удобнее не основной MacBook. Mac mini M4 компактен, потребляет около 4 Вт в простое, подходит для тихой работы 24/7; в macOS официальный скрипт, LaunchAgent и SSH обслуживаются без лишней возни; Gatekeeper, SIP и FileVault помогают держать агента в отдельном аккаунте и тестовой папке. Для дома или малой команды Mac mini M4 — разумная база: сначала пройдите тест на своём Mac, затем перенесите узел на выделенный mini. Если хотите запустить эту схему на самом удобном железе — Mac mini M4 сейчас один из лучших стартов по цене и стабильности.

OpenClaw 24/7 · низкое энергопотребление
zuvcloud · Mac Cloud

Mac mini — ваш узел OpenClaw

Быстрый старт · удалённый SSH · стабильная сеть · для самостоятельного AI Gateway и Dashboard.

Получить сейчас