Установка OpenClaw и настройка OmniProxy

OpenClaw — это ИИ-ассистент, который устанавливается на ваш компьютер. С ним можно общаться прямо в Telegram, Discord, WhatsApp или Feishu, не держа постоянно открытым отдельное окно чата. Диалоги и журналы остаются на этом компьютере, а ассистент может локально выполнять последующие действия.

Подготовка к установке

Для OpenClaw требуется Node 24.16 или более поздней версии. Также можно использовать Node 26.1 или новее; рекомендуется Node 26. Node — это базовая среда выполнения, необходимая для работы OpenClaw.

Установка поддерживается в macOS, Linux и Windows. Если подходящей версии Node на компьютере нет, установочный скрипт подготовит её самостоятельно: Node 26 в macOS и Node 24 LTS в Linux. pnpm требуется только при сборке OpenClaw из исходного кода.

Если на компьютере уже установлена более старая версия Node, удалять её заранее не нужно. Во время тестирования 2026-10-09 системная версия Node на этом компьютере была 24.2.0, то есть ниже требуемой 24.16, а неинтерактивный установочный скрипт самостоятельно подготовил Node 24.21.0.

Нужно окно

Настольный компаньон

Установочный пакет Hub для Windows
DMG с GitHub для macOS
При первом запуске можно установить локальный Gateway

Рекомендуется официально

Скрипт установки

macOS Linux WSL2
Для Windows использовать PowerShell
Можно добавить --no-onboard

Node уже установлен

Менеджер пакетов

npm pnpm или bun
Затем запустить onboard
Версию Node см. на странице установки

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

Установка и первый запуск

Можно установить настольный клиент с графическим интерфейсом или выполнить установку непосредственно через терминал. Gateway — это локальная служба, которая принимает сообщения, вызывает модель и возвращает результат. Её можно подготовить при первом запуске настольного клиента.

Если нужен графический интерфейс

Windows: загрузите и запустите OpenClawCompanion-Setup-x64.exe или OpenClawCompanion-Setup-arm64.exe. Установочный пакет подписан и включает настройки, состояние в системном трее, чат и режим node.
macOS: загрузите файл .dmg для OpenClaw со страницы GitHub releases проекта OpenClaw. Предпочтительно использовать dmg, но также доступен .zip. После установки откройте OpenClaw.app. Если для этой версии нет файлов macOS, следуйте указаниям на странице приложения для macOS.

При первом запуске можно разрешить OpenClaw подготовить Gateway на этом компьютере или подключиться к уже существующему удалённому Gateway.

Установка через терминал

В macOS, Linux и WSL2 используйте:

curl -fsSL https://openclaw.ai/install.sh | bash

В Windows PowerShell используйте:

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

Скрипт определит текущую систему, при необходимости установит Node, затем установит OpenClaw и запустит мастер первоначальной настройки. Мастер поможет выполнить первичную конфигурацию.

Если пока не хотите запускать мастер, в macOS, Linux и WSL2 используйте вместо этого:

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard

В Windows используйте официальный параметр -NoOnboard:

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard

Если вы самостоятельно управляете установкой Node, также можно использовать npm, pnpm или bun. Для npm 12, а также npm 11.16 и новее выполните:

npm install -g openclaw@latest --allow-scripts=openclaw
openclaw onboard --install-daemon

В npm 11.15 и более ранних версиях необходимо убрать --allow-scripts=openclaw. При использовании pnpm добавьте --allow-build=openclaw. Точные различия приведены на странице установки.

После завершения установки поочерёдно выполните следующие три команды:

openclaw --version
openclaw doctor
openclaw gateway status

Команда openclaw --version показывает версию, openclaw doctor проверяет распространённые проблемы со средой, а openclaw gateway status показывает, работает ли Gateway. Базовую установку можно считать завершённой только в том случае, если все три команды выдают нормальный результат.

Если терминал сообщает, что команда openclaw не найдена, обычно это означает, что глобальный каталог bin для npm не добавлен в PATH. PATH — это список расположений, в которых терминал ищет программы. Сопоставьте результаты команд node -v, npm prefix -g и echo "$PATH", добавьте соответствующий каталог bin в PATH, а затем заново откройте терминал.

Если в ~/.openclaw уже есть используемая конфигурация, установочный скрипт по умолчанию будет работать с этим каталогом. Чтобы установить отдельную копию и не изменять существующую конфигурацию, запустите неинтерактивный скрипт и укажите новый каталог:

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --prefix "$HOME/openclaw-omniproxy" --no-onboard

Для этого скрипта --no-onboard используется по умолчанию. Во время тестирования 2026-10-09 эта команда установила OpenClaw 2026.9.9. После установки необходимо запускать openclaw из каталога bin этой установки.

Получение параметров подключения из OmniProxy

Сначала убедитесь, что OmniProxy работает, затем откройте список моделей и подготовьте следующие три значения:

baseUrl: https://your-omniproxy-origin.example/v1
apiKey:  <YOUR_OMNIPROXY_API_KEY>
Model ID: полностью скопируйте из текущего списка моделей OmniProxy

baseUrl — это адрес, на который OpenClaw отправляет запросы к моделям. Он должен оканчиваться на /v1. При подключении к OmniProxy для параметра api используйте openai-completions. Меняйте его на openai-responses только в том случае, если эта модель действительно работает через /v1/responses.

Model ID — это полный идентификатор модели в списке. Скопируйте его без изменений; если он содержит косые черты, сохраните их. Следующие два имени приведены только для сопоставления с документацией поставщиков по состоянию на 2026-10-09. Не используйте их, если они отсутствуют в списке: claude-sonnet-5-5, gpt-6-luna.

Даже если шлюз не проверяет ключ, поле apiKey всё равно должно содержать значение. Можно использовать строку-заполнитель, применяемую только на этом компьютере. Не добавляйте настоящий ключ в репозиторий.

Заполнение конфигурации инструмента

Provider можно рассматривать как набор параметров подключения, с помощью которых OpenClaw находит сервис моделей. Здесь Provider называется omniproxy.

Выполните следующую команду в терминале, заменив адрес, ключ и два идентификатора моделей своими значениями:

openclaw config set models.providers.omniproxy '{"baseUrl":"https://your-omniproxy-origin.example/v1","apiKey":"<YOUR_OMNIPROXY_API_KEY>","api":"openai-completions","models":[{"id":"claude-sonnet-5-5","name":"Claude Sonnet 5.5"},{"id":"gpt-6-luna","name":"GPT-6 Luna"}]}' --strict-json --merge

Эта команда запишет Provider и список моделей в конфигурацию. После успешного выполнения команды перезапускать Gateway не нужно.

Затем укажите модель по умолчанию. Ссылка на модель состоит из omniproxy/ и Model ID. Все косые черты, изначально присутствующие в ID, необходимо сохранить. Если ID в списке моделей длиннее короткого имени в примере ниже, используйте полное значение из списка:

openclaw config set agents.defaults.model.primary '"omniproxy/claude-sonnet-5-5"' --strict-json

Параметры reasoning, input, cost, contextWindow и maxTokens можно не указывать. Если они не заполнены, текстовая модель будет обрабатываться стандартным способом.

Те же настройки можно записать непосредственно в конфигурационный файл. В основной конфигурации Provider находится в models.providers. У каждого agent также может быть собственный файл models.json; agent — это экземпляр ассистента, который фактически принимает задачи и вызывает модель. Файл расположен в agent/models.json внутри каталога соответствующего agent в ~/.openclaw/agents/.

Если в этом файле models.json задан непустой параметр baseUrl, он переопределит адрес из основной конфигурации.

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

Три команды

openclaw --version
openclaw doctor
gateway status

Конфигурация

models.providers

baseUrl заканчивается на /v1
api использовать с completions
Для модели указать как минимум id

Выбор

provider/модель

Для primary использовать эту ссылку
Ключ предпочтительно задавать через переменную окружения
Ориентироваться на список шлюза

Сначала убедитесь, что команда доступна, затем укажите адрес и модель. Ссылка на модель должна включать имя Provider.

Проверка на реальной задаче

Перейдите в обычный каталог проекта и отправьте короткое сообщение. Замените ссылку на модель в команде своим полным Model ID:

openclaw agent --local --model omniproxy/claude-sonnet-5-5 --timeout 300 --message "Ответь одним словом."

Параметр --local означает, что эта задача agent выполняется локально, --model указывает используемую модель, а --timeout 300 задаёт максимальное время ожидания в 300 секунд.

В терминале должен действительно появиться ответ модели. Во время тестирования 2026-10-09 OpenClaw 2026.9.9 получил ответ при выполнении этой команды. Первый вызов может занять одну-две минуты.

Если появляется исходное сообщение об ошибке Request timed out before a response was generated, сначала увеличьте значение --timeout, а затем отправьте запрос ещё раз. Обычно это означает, что времени ожидания было недостаточно, и не обязательно указывает на неверный адрес.

После успешного короткого ответа попросите ассистента прочитать указанный вами локальный файл. Затем откройте журнал вызовов OmniProxy и проверьте источник и Model ID в записи. Наличие вывода только у команды версии или doctor ещё не означает, что подключение к модели полностью настроено.

Установка

Команда отвечает

Номер версии выводится
doctor не блокирует работу
Статус Gateway можно прочитать

Задача

Он выполнил небольшую задачу

Например, прочитал локальный файл
Ответ не содержит ошибки
Ссылка на модель указана верно

Запись

Шлюз видит запрос

Источник — OpenClaw
ID модели совпадает
Ключ не попал в репозиторий

После того как команда версии выдаст результат, необходимо также получить хотя бы один реальный ответ.

Распространённые ошибки

Команда openclaw не найдена: добавьте глобальный каталог bin для npm в PATH, а затем заново откройте терминал. При установке в указанный каталог запускайте программу из его каталога bin.
Версия из node -v ниже 24.16: предварительно удалять старую версию не нужно. Проверьте версию Node, подготовленную установочным скриптом, либо установите 24.16+ или 26.1+ согласно странице установки. Рекомендуется Node 26.
Модель не появляется: модель должна находиться в массиве models внутри models.providers и иметь как минимум соответствующий id. Запись только в agents.defaults.models не регистрирует новую модель отдельно.
Возвращается ошибка 400 с упоминанием роли developer: если хост адреса отличается от api.openai.com, оставьте значение по умолчанию и не устанавливайте supportsDeveloperRole в true. Даже если задать true, это значение всё равно будет переопределено.
Быстро истекает время ожидания: увеличьте --timeout до 300 секунд или больше, не меняя пока адрес.
Выбрана gpt-6-luna, но вызов инструментов завершается ошибкой: эта модель поддерживает Chat Completions; вызов функций в Chat Completions поддерживается только при значении reasoning_effort, равном none. Если ID в списке отличается, используйте значение из списка.
Не удаётся подключиться к адресу: убедитесь, что OmniProxy работает, baseUrl оканчивается на /v1, а записанный в конфигурацию адрес доступен. Для других адресов в частной сети может потребоваться отдельное разрешение доступа.
После настройки запросы всё равно отправляются на другой адрес: проверьте, не указан ли другой baseUrl в файле models.json этого agent.

Официальные справочные материалы

Порядок установки приведён в OpenClaw install. Настройка пользовательского Provider описана в Custom providers и разделе Поля конфигурации. Идентификаторы моделей из примеров можно сопоставить с материалами Обзор моделей Claude и GPT-6 Luna.

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

Сохранённый результат или HTTP 200 сами по себе не доказывают полную совместимость Агента. Проверьте источник и модель в журнале вызовов OmniProxy.

Официальные источники · OpenClaw ↗