Как установить OpenClaw: пошаговое руководство

<h1>Как установить OpenClaw: пошаговое руководство</h1> <p class="lead">OpenClaw — это инструмент, который берёт рутину в когти и делает за вас половину работы. Если вы ещё не ставили его на свой ноутбук, самое время. Ниже — три способа установки на macOS, Linux и Windows: через npm, Docker и прямо из исходников на <a href="https://github.com/openclaw/openclaw">GitHub</a>. Без лишней воды, но с небольшой долей сарказма.</p> <h2>Что такое OpenClaw и зачем он вам</h2> <p>OpenClaw — это CLI-утилита для автоматизации задач, которую активно развивает сообщество. Если коротко: вы пишете команды, OpenClaw делает магию, а вы получаете больше времени на кофе и мемы. Подробнее о возможностях читайте в официальной документации: <a href="https://docs.openclaw.ai">docs.openclaw.ai</a>.</p> <h2>Что понадобится перед стартом</h2> <p>Не важно, какая у вас система — главное, чтобы руки росли из правильного места и в системе было несколько базовых вещей:</p> <ul> <li><strong>Node.js 18+</strong> — если ставите через npm. Проверьте версию командой <code>node -v</code>.</li> <li><strong>npm</strong> — обычно прилетает вместе с Node.js. Проверьте: <code>npm -v</code>.</li> <li><strong>Git</strong> — только если собираетесь клонировать исходники.</li> <li><strong>Docker</strong> — для способа с контейнером. Подойдёт любая свежая версия.</li> <li><strong>Терминал</strong> — да, придётся открыть чёрное окно. Не пугайтесь, оно не кусается.</li> </ul> <p>Если чего-то нет — сначала поставьте недостающее, потом возвращайтесь. Мы подождем. Нет, серьёзно, весь интернет никуда не денется.</p> <h2>Способ 1: установка через npm</h2> <p>Самый простой и универсальный путь. Работает везде, где есть Node.js: macOS, Linux, Windows. Один раз запускаете команду — и весь мир OpenClaw у вас в кармане.</p> <h3>macOS и Linux</h3> <p>Откройте терминал. Не тот, что вы используете для просмотра логов, а настоящий. Введите:</p> <pre><code>npm install -g openclaw</code></pre> <p>Система может спросить пароль или ругнуться на права — это нормально. Если npm ругается на <code>permission denied</code>, не спешите судорожно писать <code>sudo</code> в каждую команду. Лучше настройте <a href="https://docs.npmjs.com/resolving-err-code-1">каталог для глобальных пакетов</a> или используйте менеджер версий Node, например nvm. Ваше будущее «я» скажет спасибо.</p> <h3>Windows</h3> <p>Откройте PowerShell или CMD. Желательно от имени администратора, если ранее глобальные пакеты ставились с боями. Введите:</p> <pre><code>npm install -g openclaw</code></pre> <p>Если Windows начнёт ныть про политики выполнения скриптов, выполните в PowerShell:</p> <pre><code>Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser</code></pre> <p>Не бойтесь, это стандартная процедура. Просто не ставьте <code>Unrestricted</code> на всех серверах компании — мы же не в диком западе.</p> <h2>Способ 2: Docker — для любителей чистоты</h2> <p>Если не хотите засорять систему пакетами, Node.js и прочими зависимостями, Docker — ваш лучший друг. Контейнер изолирован, его можно удалить одной командой, и никто не узнает о ваших экспериментах.</p> <p>Сначала убедитесь, что Docker запущён. Затем выполните:</p> <pre><code>docker pull openclaw/openclaw:latest</code></pre> <p>После скачивания запускайте утилиту так:</p> <pre><code>docker run --rm -it openclaw/openclaw:latest --version</code></pre> <p>Если хотите работать с файлами на хосте, не забудьте примонтировать директорию. Пример:</p> <pre><code>docker run --rm -it -v $(pwd):/workspace -w /workspace openclaw/openclaw:latest</code></pre> <p>В Windows вместо <code>$(pwd)</code> используйте абсолютный путь, например <code>C:\projects:/workspace</code>. Да, Docker в Windows любит именно такие танцы с бубном.</p> <h2>Способ 3: сборка из исходников на GitHub</h2> <p>Для тех, кто не доверяет готовым пакетам и считает, что настоящий инженер должен всё собрать сам. Или для тех, кто хочет последний коммит из dev-ветки. В любом случае, добро пожаловать в клуб.</p> <p>Клонируйте репозиторий:</p> <pre><code>git clone https://github.com/openclaw/openclaw.git <p>cd openclaw</p></code></pre> <p>Установите зависимости:</p> <pre><code>npm install</code></pre> <p>Соберите проект:</p> <pre><code>npm run build</code></pre> <p>И запустите локально:</p> <pre><code>npm start -- --version</code></pre> <p>Если всё прошло без ошибок, поздравляем — вы только что собрали OpenClaw из исходников. Можете похвастаться в резюме. Если вылезли ошибки — проверьте версию Node.js, почистите кэш npm командой <code>npm cache clean --force</code> и попробуйте ещё раз. Иногда помогает обычное «выключить и включить снова».</p> <h2>Проверка установки</h2> <p>Независимо от способа, убедитесь, что OpenClaw действительно установлен и готов работать:</p> <pre><code>openclaw --version</code></pre> <p>Если терминал показал версию — отлично, можно двигаться дальше. Если написал что-то вроде <code>command not found</code>, значит глобальные пакеты npm не попали в PATH. Решение: перезапустить терминал или добавить путь к npm-bin в переменные среды. В Windows это обычно <code>%APPDATA%\npm</code>, в macOS/Linux — <code>~/.npm-global/bin</code> или аналогичный.</p> <p>Для Docker-проверки используйте:</p> <pre><code>docker run --rm openclaw/openclaw:latest --version</code></pre> <h2>Если что-то пошло не так</h2> <p>Жизнь — боль, установка ПО — тоже. Вот типичные проблемы и быстрые фиксы:</p> <ul> <li><strong>«npm ERR! code EACCES»</strong> — права доступа. Не лечите sudo, лечите настройками npm или nvm.</li> <li><strong>«Cannot find module»</strong> — зависимости не встали. Попробуйте удалить <code>node_modules</code> и запустить <code>npm install</code> заново.</li> <li><strong>Долгая установка</strong> — скорее всего, npm тянет кэш из-за медленного зеркала. Включите VPN или смените registry.</li> <li><strong>Docker не видит файлы</strong> — проверьте путь монтирования. В Windows пути с пробелами любят превращаться в приключение.</li> <li><strong>Сборка падает на <code>npm run build</code></strong> — убедитесь, что Node.js не старше палеолита. OpenClaw хочет 18+.</li> </ul> <p>Если ничего не помогает, идите в официальную документацию <a href="https://docs.openclaw.ai">docs.openclaw.ai</a> или в раздел Issues на <a href="https://github.com/openclaw/openclaw">GitHub</a>. Там либо уже есть ответ, либо вы станете героем, который его напишет.</p> <h2>Итог</h2> <p>Установить OpenClaw можно тремя способами: через <code>npm install -g openclaw</code>, через <code>docker pull openclaw/openclaw</code> или собрав вручную из репозитория <a href="https://github.com/openclaw/openclaw">github.com/openclaw/openclaw</a>. Выбирайте тот, который ближе по духу: быстрый, изолированный или хардкорный. После установки не забудьте проверить версию командой <code>openclaw --version</code> и заглянуть в <a href="https://docs.openclaw.ai">документацию</a>, чтобы узнать, на что эта штука способна.</p> <p>Удачи, и пусть ваши claw-задачи решаются сами.</p>