Скачать и установить OpenClaw на Windows | open-claw.su

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 запущен от имени администратора (правой кнопкой по PowerShell > «Запуск от имени администратора»), затем повторите команду npm install -g openclaw@latest.

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

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

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

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

Провайдер	Рекомендация	Где получить ключ
Anthropic Claude	Лучший выбор для начала. Модели Claude отлично справляются с русским языком и сложными задачами.	console.anthropic.com
OpenAI GPT	Хорошая альтернатива с широким набором моделей.	platform.openai.com
Kimi	Бюджетный вариант с поддержкой длинного контекста.	kimi.ai
Ollama	Полностью локальный запуск, без отправки данных в облако. Требует мощный ПК (16+ ГБ RAM, желательно с видеокартой NVIDIA).	ollama.com

Как получить ключ (на примере 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       # Основные настройки (формат JSON5)
├── 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

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

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

Нажмите 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 после выполнения.

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

Если при запуске 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.
Проверьте, не блокирует ли файрвол или антивирус исходящие соединения.
Запустите диагностику и проверьте вывод в терминале, где запущен gateway:

openclaw doctor

Что дальше

Установка --- это только начало. Вот что стоит сделать следующим шагом:

Установка OpenClaw на Mac --- инструкция для macOS.
Установка OpenClaw на Linux --- инструкция для Ubuntu, Debian и других дистрибутивов.
Gateway: как устроен и как настроить --- подробно о gateway, дашборде и удалённом доступе.
Безопасность OpenClaw --- что нужно знать перед запуском агента.
Выбор языковой модели --- какую LLM выбрать для OpenClaw.

OpenClaw --- проект с открытым исходным кодом и сообществом из более чем 145 000 пользователей на GitHub. Присоединяйтесь, экспериментируйте и делайте своего агента полезнее с каждым днём.