База знаний Windows

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

09.04.2026

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

OpenClaw — бесплатный автономный ИИ-агент с открытым исходным кодом, который работает локально на вашем компьютере и общается через мессенджеры: Telegram, WhatsApp, Slack, Discord, Signal и другие. В этом руководстве вы установите OpenClaw на Windows, подключите языковую модель и запустите агента, которому можно написать в мессенджер и получить ответ.

К концу инструкции у вас будет полностью настроенный OpenClaw, готовый к работе на вашем ПК с Windows.

Что понадобится

Прежде чем начинать, убедитесь, что у вас есть:

Windows 10 (версия 1809) или Windows 11 — более ранние версии не поддерживаются. Проверить версию: Win + R, введите winver, нажмите Enter.
2 ГБ свободного места на диске — для Node.js, OpenClaw и его зависимостей.
Стабильное подключение к интернету — для установки пакетов и работы с API языковой модели.
API-ключ языковой модели — понадобится на этапе настройки. Если у вас его ещё нет, вы получите его на шаге 3.
Права администратора — нужны для установки Node.js и глобальных npm-пакетов.

Никаких специальных знаний программирования не требуется — достаточно уметь открыть командную строку и вставить команду.

Шаг 1. Установка Node.js

OpenClaw работает на Node.js — среде выполнения JavaScript. Вам нужна версия 22 или новее.

Проверьте, установлен ли Node.js

Откройте PowerShell (нажмите Win + X, выберите «Windows PowerShell» или «Терминал») и выполните:

node --version

Если вы видите номер версии вроде v22.4.1 — Node.js уже установлен. Убедитесь, что первая цифра 22 или больше, и переходите к шагу 2.

Если появилось сообщение об ошибке — установите Node.js по инструкции ниже.

Установка через официальный установщик

Перейдите на сайт nodejs.org.
Скачайте версию LTS (Long Term Support) — кнопку слева. Это стабильный выпуск.
Запустите скачанный .msi-файл.
В установщике:
- Нажимайте Next на каждом шаге.
- Оставьте галочку «Automatically install the necessary tools» — это установит дополнительные компоненты сборки.
- Нажмите Install, при запросе подтвердите права администратора.
После завершения нажмите Finish.

Проверяем результат

После установки Node.js закройте и откройте PowerShell заново, чтобы обновились переменные окружения. Затем выполните:

node --version npm --version

Вы должны увидеть что-то вроде:

v22.4.1 10.2.4

Если команда node по-прежнему не найдена, перезагрузите компьютер — иногда Windows обновляет PATH только после перезапуска.

После этого шага у вас установлены Node.js и npm, которые необходимы для работы OpenClaw.

Шаг 2. Установка OpenClaw

Способ A: официальный установщик

Самый простой способ — официальный скрипт установки. Откройте PowerShell и выполните:

iwr -useb https://openclaw.ai/install.ps1 | iex

Скрипт автоматически установит OpenClaw и запустит мастер настройки.

Способ B: через npm

Альтернативный способ — установка через npm:

npm install -g openclaw@latest

Проверка установки

openclaw --version

Ожидаемый вывод — номер версии OpenClaw.

Если возникает ошибка политики выполнения скриптов

В Windows PowerShell по умолчанию может быть запрещён запуск скриптов. Если вы видите ошибку execution policy, выполните в PowerShell от имени администратора:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Подтвердите изменение, набрав Y и нажав Enter. После этого повторите установку OpenClaw.

Если возникает ошибка прав доступа

Убедитесь, что PowerShell запущен от имени администратора, затем повторите команду:

npm install -g openclaw@latest

После этого шага у вас установлен OpenClaw и доступна команда openclaw в терминале.

Шаг 3. Получение API-ключа языковой модели

OpenClaw — это оболочка, а «мозг» агента — языковая модель (LLM). Вам нужен API-ключ одного из провайдеров.

Какую модель выбрать

Anthropic Claude — лучший выбор для начала. Модели Claude хорошо справляются с русским языком и сложными задачами.
OpenAI GPT — хорошая альтернатива с широким набором моделей.
Kimi — бюджетный вариант с поддержкой длинного контекста.
Ollama — полностью локальный запуск без отправки данных в облако. Требует мощный ПК (16+ ГБ RAM, желательно с видеокартой NVIDIA).

Как получить ключ на примере Anthropic Claude

Зарегистрируйтесь в console.anthropic.com.
Перейдите в раздел API Keys.
Нажмите Create Key и задайте имя, например openclaw.
Скопируйте ключ — он начинается с sk-ant-.... Сохраните его в надёжном месте: ключ показывается только один раз.
Пополните баланс. Для тестирования обычно достаточно 5 долларов.

Для OpenAI GPT

Зарегистрируйтесь на platform.openai.com.
Перейдите в API Keys и нажмите Create new secret key.
Скопируйте ключ, который начинается с sk-....
Пополните баланс в разделе Billing.

После этого шага у вас есть API-ключ, который OpenClaw будет использовать для обращения к языковой модели.

Шаг 4. Первая настройка — openclaw onboard

Откройте PowerShell (обычный, не обязательно от администратора) и запустите мастер настройки:

openclaw onboard --install-daemon

Мастер настройки проведёт вас через несколько шагов:

Выбор языковой модели — выберите провайдера: Claude, GPT, Kimi или Ollama. Для первого раза рекомендуется Claude.
Ввод API-ключа — вставьте ключ, полученный в шаге 3. В PowerShell для вставки можно использовать правую кнопку мыши или Ctrl + V.
Выбор мессенджера — укажите, через какой мессенджер агент будет общаться: Telegram, WhatsApp, Slack, Discord или Signal. Для старта Telegram — самый простой вариант.
Имя и описание агента — задайте имя, которое будет отображаться в мессенджере.
Файл SOUL.md — мастер создаст файл «личности» агента. Позже вы сможете отредактировать его, чтобы задать тон, стиль и область знаний агента.

После завершения в директории ~/.openclaw/ появятся файлы конфигурации:

dir $HOME\.openclaw

Вы увидите структуру вроде:

Directory: C:\Users\username\.openclaw

Mode Name

d----- workspace
-a---- openclaw.json
-a---- credentials

~/.openclaw/
├── openclaw.json
├── workspace/
│ ├── SOUL.md
│ ├── AGENTS.md
│ └── skills/
└── credentials

openclaw.json — основные настройки агента в формате JSON5.
workspace/SOUL.md — файл личности, определяющий поведение и стиль агента.
workspace/skills/ — директория для скиллов и расширений функциональности.
credentials — файл с ключами и токенами.

После этого шага у вас будет настроенный агент с конфигурацией, файлом личности и подключённым мессенджером.

Шаг 5. Первый запуск

Запустите агента:

openclaw gateway --port 18789

В терминале вы увидите примерно такой вывод:

OpenClaw agent started Connected to Telegram Dashboard: http://127.0.0.1:18789/ ⏳ Waiting for messages...

Теперь откройте выбранный мессенджер и напишите агенту любое сообщение, например:

Привет! Расскажи о себе.

Агент должен ответить в течение нескольких секунд. Если ответ пришёл — установка завершена успешно.

Чтобы остановить агента, нажмите Ctrl + C в PowerShell.

Полезные команды для работы

openclaw gateway --port 18789 openclaw gateway --port 18789 --verbose openclaw doctor openclaw update

Автозапуск OpenClaw при включении компьютера

Нажмите Win + R, введите shell:startup и нажмите Enter — откроется папка автозагрузки.
Создайте в ней файл openclaw.bat со следующим содержимым:

openclaw gateway --port 18789

При следующем входе в систему OpenClaw запустится автоматически в фоновом режиме.

После этого шага у вас будет работающий ИИ-агент, который отвечает на сообщения в мессенджере.

Решение частых проблем

«openclaw» is not recognized as an internal or external command

Node.js установлен, но команда openclaw не найдена. Возможные причины и решения:

PowerShell не обновил PATH. Закройте и откройте PowerShell заново. Если не помогло — перезагрузите компьютер.
npm-пакеты не добавлены в PATH. Проверьте путь глобальных пакетов:

npm root -g

Добавьте родительскую директорию в системный PATH:

$npmPath = (npm root -g) -replace 'node_modules$', '' [Environment]::SetEnvironmentVariable("PATH", "$env:PATH;$npmPath", "User")

После этого перезапустите PowerShell.

Ошибка политики выполнения скриптов

Если при запуске openclaw вы видите ошибку вида File cannot be loaded because running scripts is disabled on this system, выполните:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Подтвердите изменение и повторите команду.

Error: unsupported Node.js version

OpenClaw требует Node.js 22 или новее. Проверьте версию:

node --version

Если версия ниже 22, скачайте свежую LTS-версию с nodejs.org и установите поверх текущей — установщик обновит Node.js автоматически.

Error: Invalid API key или Authentication failed

Убедитесь, что вы скопировали ключ полностью и без лишних пробелов.
Проверьте, что на счёте провайдера есть средства.
Убедитесь, что выбран правильный провайдер: ключ Claude не подойдёт для GPT и наоборот.

Перенастроить ключ можно, отредактировав конфигурационный файл:

notepad $HOME\.openclaw\openclaw.json

Антивирус блокирует OpenClaw

Некоторые антивирусы, особенно встроенный Windows Defender, могут блокировать работу Node.js-приложений. Если агент не запускается или соединение обрывается:

Откройте «Безопасность Windows» → «Защита от вирусов и угроз» → «Управление настройками».
В разделе «Исключения» добавьте папку %USERPROFILE%\.openclaw.
Также добавьте путь к Node.js, обычно C:\Program Files\nodejs\.

Агент запускается, но не отвечает в мессенджере

Проверьте, что бот в мессенджере корректно создан и токен указан верно.
Убедитесь, что выбранный мессенджер был правильно подключён на этапе настройки.
Для диагностики запустите OpenClaw с подробным выводом через --verbose.

Если базовые проверки не помогли, выполните команду диагностики:

openclaw doctor

Она поможет выявить проблемы с конфигурацией, окружением и подключениями.

Итог

Теперь у вас есть установленный и настроенный OpenClaw на Windows. Вы подготовили систему, установили Node.js, получили API-ключ языковой модели, прошли первичную настройку и запустили агента для общения через мессенджер.

Дальше вы можете доработать файл SOUL.md, подключать новые навыки и адаптировать агента под свои задачи.