Как установить OpenClaw на Windows

<h1>Как установить OpenClaw на Windows</h1> <p class="lead">OpenClaw — это CLI-инструмент из <a href="https://www.npmjs.com/package/openclaw">npm-реестра</a>, который обещает сделать разработку проще, быстрее и с меньшим количеством слёз. На Windows путь к нему слегка тернист: Node.js, npm, PowerShell, пути с пробелами и политики выполнения любят устраивать сюрпризы. Ниже — пошаговая инструкция, как установить OpenClaw на Windows и не сойти с ума.</p> <h2>0. Что понадобится</h2> <ul> <li>Windows 10 или 11 (64-бит, желательно свежий билд).</li> <li><a href="https://nodejs.org/ru">Node.js</a> LTS — вместе с ним придёт npm.</li> <li><a href="https://apps.microsoft.com/detail/9n0dx20hk701">Windows Terminal</a> или хотя бы PowerShell / CMD.</li> <li>Права администратора для некоторых манипуляций.</li> <li>Терпение, чай и пять минут на перезагрузку терминала.</li> </ul> <h2>1. Установите Node.js и npm</h2> <p>OpenClaw написан на JavaScript, поэтому без Node.js никуда. Идём на <a href="https://nodejs.org/ru">nodejs.org</a>, качаем версию с пометкой LTS (не Current — вы не на конференции, вам нужна стабильность). Запускаем установщик, жмём Next-Next-Next, и главное: не снимайте галочку «Add to PATH». Без неё Windows не найдёт <code>node</code> и <code>npm</code>, и вы будете гуглить, почему «команда не найдена».</p> <p>Проверяем:</p> <p><code>node -v</code> <code>npm -v</code></p> <p>Если видите версии — отлично. Если npm выглядит архаично, обновите его:</p> <p><code>npm install -g npm</code></p> <p>Если же терминал пишет «не является внутренней или внешней командой» — закройте его и откройте заново. Потом, возможно, перезагрузите компьютер. Да, классика.</p> <h3>Куда ставить Node.js</h3> <p>Лучше оставить путь по умолчанию <code>C:\Program Files\nodejs</code>. Если поставили в папку с пробелами или кириллицей — поздравляем, вы купили билет в мир странных ошибок npm. Переустановите в нормальное место, и жизнь наладится.</p> <h2>2. Разрешите PowerShell запускать скрипты</h2> <p>PowerShell по умолчанию смотрит на вас с подозрением и не разрешает запускать скрипты. npm часто использует скрипты, поэтому лучше сразу дать разрешение на уровне текущего пользователя.</p> <p>Откройте PowerShell от имени администратора и выполните:</p> <p><code>Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser</code></p> <p>Система спросит: «А вы уверены?» — отвечаем <code>Y</code>. Если хотите разобраться, почитайте про политики в <a href="https://learn.microsoft.com/ru-ru/powershell/module/microsoft.powershell.core/about/about&lt;em&gt;execution&lt;/em&gt;policies">документации Microsoft</a>.</p> <p>Проверьте результат:</p> <p><code>Get-ExecutionPolicy -List</code></p> <p>У <code>CurrentUser</code> должно стоять <code>RemoteSigned</code>. Если у вас PowerShell 5.1, рекомендую поставить <a href="https://github.com/PowerShell/PowerShell/releases">PowerShell 7</a>: он быстрее и меньше ворчит.</p> <h2>3. Установите OpenClaw</h2> <p>Самый чистый способ — не засорять систему глобальной установкой, а запускать через <code>npx</code>:</p> <p><code>npx openclaw --version</code></p> <p>npx сам скачает последнюю версию, выполнит команду и не оставит мусора. Если инструмент нужен постоянно, ставим глобально:</p> <p><code>npm install -g openclaw</code></p> <p>А потом просто:</p> <p><code>openclaw --version</code></p> <p>Если видите версию — вы великолепны. Если нет — читаем следующий раздел.</p> <h3>Локальная установка в проект</h3> <p>Если OpenClaw нужен только в одном проекте, не пихайте его глобально. В папке проекта выполните:</p> <p><code>npm install openclaw --save-dev</code></p> <p>А запускайте через npx, чтобы не зависеть от PATH:</p> <p><code>npx openclaw</code></p> <p>Так версия инструмента зафиксируется в <code>package.json</code>, и коллеги не удивятся, почему у вас всё работает, а у них нет.</p> <h2>4. Разберитесь с PATH и глобальными пакетами</h2> <p>Иногда npm ставит глобальные бинарники в папку, которую Windows не видит. Узнайте, куда:</p> <p><code>npm config get prefix</code></p> <p>Ещё один способ найти каталог:</p> <p><code>npm bin -g</code></p> <p>Внутри этой папки найдите каталог, где лежит <code>openclaw.cmd</code>. Добавьте его в переменную среды PATH: <code>Параметры → Система → О системе → Дополнительные параметры системы → Переменные среды</code>. Перезапустите терминал. Да, опять перезапуск.</p> <p>Чтобы не мучиться с правами администратора, можно перенаправить глобальные пакеты в пользовательскую папку:</p> <p><code>npm config set prefix "C:\Users\$env:USERNAME\AppData\Roaming\npm-global"</code></p> <p>Не забудьте добавить новый <code>bin</code> в PATH. Иначе OpenClaw останется там, где его никто не найдёт.</p> <h2>5. Включите поддержку длинных путей</h2> <p>Windows любит ругаться, если путь к файлу длиннее 260 символов. Node.js и npm с удовольствием создают такие пути. Откройте PowerShell от администратора и выполните:</p> <p><code>New-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" -Name "LongPathsEnabled" -Value 1 -PropertyType DWORD -Force</code></p> <p>Перезагрузитесь. Теперь <code>nodemodules</code> сможет разрастаться без ограничений. Почти без ограничений.</p> <h2>6. Windows Terminal: красиво и удобно</h2> <p>CMD устарел, стандартный PowerShell тоже ничего, а Windows Terminal умеет вкладки, темы и не выглядит как 1995 год. Качаем из <a href="https://apps.microsoft.com/detail/9n0dx20hk701">Microsoft Store</a> или с <a href="https://github.com/microsoft/terminal">GitHub</a>.</p> <p>Настройте профиль по умолчанию на PowerShell и шрифт с поддержкой лигатур, например Cascadia Code. После этого запускать <code>npx openclaw</code> становится приятнее — ну, почти.</p> <h2>7. WSL2: когда надоело бороться с Windows</h2> <p>Если OpenClaw ведёт себя особенно капризно или вам удобнее Linux-окружение, поставьте <a href="https://learn.microsoft.com/ru-ru/windows/wsl/install">WSL2</a>. В PowerShell от администратора:</p> <p><code>wsl --install</code></p> <p>Перезагрузитесь, заведите пользователя, поставьте Node.js внутри Ubuntu:</p> <p><code>sudo apt update &amp;&amp; sudo apt install -y nodejs npm</code></p> <p>И запускайте:</p> <p><code>npx openclaw</code></p> <p>В WSL пути к проектам держите внутри файловой системы Linux, а не на <code>C:\</code>, иначе производительность упадёт, и вы будете ругаться.</p> <h2>8. Типичные проблемы и как их победить</h2> <h3>«npm ERR! code ENOENT»</h3> <p>Обычно означает, что npm не нашёл нужный файл. Проверьте, установился ли пакет, и очистите кэш:</p> <p><code>npm cache clean --force</code></p> <h3>«Cannot find module» при запуске</h3> <p>Попробуйте удалить <code>nodemodules</code> и переустановить зависимости:</p> <p><code>rm -Recurse -Force node_modules</code> <code>npm install</code></p> <p>Если не помогло — проверьте версию Node. OpenClaw может не дружить с очень старыми релизами.</p> <h3>PowerShell ругается на запуск скриптов</h3> <p>Вернитесь к шагу 2. Если не помогает, возможно, включена групповая политика организации — тогда пишите в IT-отдел с мемом.</p> <h3>Антивирус или Windows Defender блокирует установку</h3> <p>Редко, но бывает. Проверьте карантин или журнал защитника. Если файл <code>openclaw.cmd</code> улетел в карантин — верните его и добавьте папку npm в исключения. Или просто используйте WSL, там таких проблем меньше.</p> <h3>Долгий запуск через npx</h3> <p>npx каждый раз проверяет реестр. Можно закрепить версию:</p> <p><code>npx openclaw@1.2.3 --version</code></p> <p>Или установить глобально, если используете инструмент регулярно.</p> <h3>Посмотрите, что установлено глобально</h3> <p>Если подозреваете бардак, проверьте список:</p> <p><code>npm ls -g --depth=0</code></p> <p>А если совсем всё плохо, npm сам подскажет, где болит:</p> <p><code>npm doctor</code></p> <h2>9. Обновление и удаление</h2> <p>Обновить глобальную установку:</p> <p><code>npm update -g openclaw</code></p> <p>Удалить:</p> <p><code>npm uninstall -g openclaw</code></p> <p>Если использовали npx — ничего удалять не надо, он сам всё приберёт. Почти как хороший кот.</p> <h2>Итог</h2> <p>OpenClaw на Windows ставится за десять минут, если не считать часа на борьбу с PATH, политиками PowerShell и длинными путями. Установите Node.js LTS, разрешите скрипты, запускайте через <code>npx openclaw</code> или ставьте глобально, используйте Windows Terminal, а при желании — WSL2. Удачи, и пусть ваши когти не сломаются.</p>