OpenClaw на Windows и Mac: полный гайд

Установил OpenClaw на десятке машин — от MacBook Air до Windows-ноутбука с 8 Гб оперативки. Везде работает, но подводные камни на каждой платформе свои.

Собрал всё в один гайд. Две платформы, конкретные шаги, решения типичных проблем.

Что такое OpenClaw и зачем устанавливать локально

OpenClaw — среда для запуска ИИ-агентов прямо на вашем компьютере. Агент работает в терминале, умеет читать и редактировать файлы, выполнять команды, подключаться к внешним сервисам через MCP.

Ключевое: OpenClaw работает с любой LLM. Claude, GPT, Gemini, Llama, Mistral — подключаете API нужного провайдера и работаете. Это не продукт одной компании, а открытая платформа.

Почему локально, а не в облаке? Потому что агент работает с вашими файлами. Код, документы, конфиги — всё на вашей машине. Это и быстрее, и безопаснее.

Что понадобится на обеих платформах

Минимальный набор одинаковый:

• Node.js 18+ — среда выполнения, на которой работает OpenClaw
• API-ключ LLM-провайдера — Anthropic, OpenAI, Google или другой. От $5 на старте хватит
• Терминал — на Mac встроенный Terminal, на Windows — PowerShell или WSL
• 10-15 минут свободного времени

Установка на Mac

Mac — самая простая платформа для OpenClaw. Терминал из коробки, Unix-система, всё работает предсказуемо.

Шаг 1: установить Node.js через Homebrew

Если Homebrew не установлен, сначала поставьте его. Откройте Terminal (Cmd+Space, наберите Terminal):

Теперь ставим Node.js:

Проверяем:

Альтернатива: скачать установщик с nodejs.org. Работает так же, но Homebrew удобнее — обновлять проще.

Шаг 2: установить OpenClaw

Проверяем:

Если видите номер версии — готово.

Шаг 3: первый запуск

Перейдите в любую рабочую папку и запустите:

При первом запуске OpenClaw попросит API-ключ. Введите ключ вашего LLM-провайдера. OpenClaw сохранит его в конфигурации и больше спрашивать не будет.

Попробуйте первую команду: попросите агента создать файл или рассказать о текущей папке.

Шаг 4: настроить SOUL.md

SOUL.md — файл идентичности агента. Создайте его в корне проекта:

Минимальная структура:

Когда запускаете openclaw из папки с SOUL.md, агент автоматически загружает этот файл и работает по его правилам.

Установка на Windows

Windows требует чуть больше внимания. Есть два пути: через PowerShell (проще) и через WSL (мощнее).

Путь 1: PowerShell (быстрый старт)

Подходит для тех, кто хочет попробовать OpenClaw без лишних настроек.

Шаг 1: установить Node.js

Скачайте LTS-версию с nodejs.org. Запустите установщик, нажимайте Next. Убедитесь что галочка "Add to PATH" включена — она стоит по умолчанию.

Откройте PowerShell (Win+X, затем "Windows PowerShell") и проверьте:

Шаг 2: установить OpenClaw

Если PowerShell ругается на execution policy, выполните сначала:

Шаг 3: первый запуск

Введите API-ключ при первом запуске. Всё — агент работает.

Шаг 4: SOUL.md

Создайте файл SOUL.md в папке проекта:

Заполните по той же структуре что и для Mac. Сохраните, закройте Notepad, запустите openclaw из этой папки.

Путь 2: WSL (полноценная среда)

WSL (Windows Subsystem for Linux) — это Linux внутри Windows. Все инструменты работают как на настоящем Linux. Рекомендую если планируете работать с OpenClaw серьезно.

Шаг 1: установить WSL

В PowerShell от имени администратора:

Перезагрузите компьютер. После перезагрузки откроется Ubuntu и попросит задать имя пользователя и пароль.

Шаг 2: установить Node.js в WSL

Шаг 3: установить OpenClaw

Если npm ругается на права доступа:

Шаг 4: запуск и настройка

Дальше всё как на Mac. Файлы Windows доступны в WSL по пути /mnt/c/Users/ВашеИмя/. Но лучше работать в домашней директории WSL — быстрее файловая система.

Выбор и подключение LLM-провайдера

OpenClaw — это агентская среда, а не модель. Модель вы выбираете сами.

Anthropic (Claude) — console.anthropic.com. Ключ начинается с sk-ant-. Сильный в работе с кодом и длинными текстами.

OpenAI (GPT) — platform.openai.com. Ключ начинается с sk-. Хорошо работает для широкого спектра задач.

Google (Gemini) — aistudio.google.com. Длинный контекст, конкурентные цены.

Для старта рекомендую Claude Sonnet или GPT-4o — оптимальный баланс цены и качества. $5-10 хватает на несколько недель активной работы.

Траблшутинг по платформам

Проблемы на Mac

"command not found: openclaw" после установки

npm поставил пакет, но путь к глобальным пакетам не в PATH. Решение:

Ошибка прав доступа при npm install -g

Не используйте sudo. Лучше настроить npm на установку в домашнюю директорию:

Проблемы на Windows (PowerShell)

"running scripts is disabled on this system"

"openclaw is not recognized as a cmdlet"

Node.js не добавил npm в PATH. Проверьте npm prefix -g и добавьте этот путь в переменную среды PATH через "Параметры системы" -> "Переменные среды".