Инсталиране на OpenClaw и конфигуриране на OmniProxy

OpenClaw е AI асистент, инсталиран на вашия собствен компютър. Можете да разговаряте с него директно чрез 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, не е необходимо първо да я деинсталирате. По време на тестването на 09.10.2026 г., системната версия на Node на този компютър беше 24.2.0, под изискваната 24.16, и неинтерактивният инсталационен скрипт автоматично подготви Node 24.21.0.

Искате прозорец

Настолен спътник

• Използвайте инсталатора Hub на Windows
• Използвайте GitHub DMG на macOS
• Локалният Gateway може да бъде инсталиран по време на първоначалната настройка

Официално препоръчано

Инсталационен скрипт

• macOS Linux WSL2
• Използвайте PowerShell на Windows
• Можете да добавите --no-onboard

Node вече е инсталиран

Мениджър на пакети

• npm pnpm или bun
• След това стартирайте onboard
• Вижте страницата за инсталиране за версията на Node

Инсталиране и първо стартиране

Можете да инсталирате настолния спътник с графичен прозорец или да инсталирате директно чрез терминала. Gateway е локалната услуга, отговорна за получаване на съобщения, извикване на модели и връщане на резултатите. Можете да я настроите при първото отваряне на настолния спътник.

Ако искате прозорец

• Windows: Изтеглете и стартирайте OpenClawCompanion-Setup-x64.exe или OpenClawCompanion-Setup-arm64.exe. Инсталаторът е подписан и включва настройки, статус в системната лента, чат и режими на възел.
• macOS: Изтеглете OpenClaw .dmg от изданията на OpenClaw в GitHub. Предпочитайте 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 е поведението по подразбиране на този скрипт. На 09.10.2026 г. тази команда инсталира OpenClaw 2026.9.9. След инсталацията стартирайте openclaw изпълнимия файл от bin папката на директорията.

Получаване на стойности за връзка от OmniProxy

Първо потвърдете, че OmniProxy работи, след това отворете списъка с модели и подгответе следните три стойности:

baseUrl: https://your-omniproxy-origin.example/v1
apiKey:  <YOUR_OMNIPROXY_API_KEY>
Model ID: copy the full value from the current OmniProxy model list

baseUrl е адресът, до който OpenClaw изпраща заявки за модели, и той трябва да завършва с /v1. Когато се свързвате с OmniProxy, използвайте openai-completions за api. Променете го на openai-responses само ако моделът действително работи чрез /v1/responses.

Идентификаторът на модела (Model ID) е пълният идентификатор на модела в списъка. Копирайте го точно както е показано, включително всички наклонени черти. Следните две имена са само препратки от документацията на доставчика към 09.10.2026 г.; не ги използвайте, ако не се появяват в списъка: claude-sonnet-5-5, gpt-6-luna.

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

Въвеждане на конфигурацията на инструмента

Доставчикът (Provider) може да се разбере като набор от настройки за връзка, които OpenClaw използва, за да намери услуга за модели. Тук доставчикът е наречен 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

Тази команда записва доставчика и списъка с модели в конфигурацията. Не е необходимо да рестартирате Gateway след успешното изпълнение на командата.

След това посочете модела по подразбиране. Препратката към модела се състои от omniproxy/ последвано от идентификатора на модела. Запазете всяка наклонена черта, която вече присъства в идентификатора. Ако идентификаторът в списъка с модели е по-дълъг от краткото име по-долу, използвайте пълната стойност от списъка:

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

reasoning, input, cost, contextWindow, и maxTokens могат да бъдат пропуснати. Когато не са предоставени, текстовите модели се обработват с помощта на настройките по подразбиране.

Можете също да запишете същите настройки директно в конфигурационния файл. В основната конфигурация доставчикът се намира под models.providers. Всеки агент може също да има свой собствен models.json; агентът е инстанция на асистент, която действително получава задачи и извиква модели. Файлът се намира в agent/models.json в рамките на съответната директория на агента под ~/.openclaw/agents/.

Ако този models.json съдържа непразен baseUrl, той замества адреса в основната конфигурация.

Проверка на инсталацията

Три команди

• openclaw --version
• openclaw doctor
• gateway status

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

models.providers

• baseUrl завършва с /v1
• Задайте api на completions
• Посочете поне идентификатора на модела

Изберете

provider/model

• Използвайте тази препратка за основен
• Предпочитайте променлива на средата за ключа
• Използвайте списъка на шлюза като източник на истината

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

Влезте в обикновена директория на проект и изпратете много кратко съобщение. Заменете препратката към модела в командата с пълния си идентификатор на модела:

openclaw agent --local --model omniproxy/claude-sonnet-5-5 --timeout 300 --message "Reply with one word."

--local изпълнява тази задача на агента локално, --model посочва модела, който да се използва за това изпълнение, и --timeout 300 задава максималното време за изчакване на 300 секунди.

В терминала трябва да се появи реален отговор от модела. На 09.10.2026 г. OpenClaw 2026.9.9 получи отговор чрез тази команда. Първото извикване може да отнеме минута или две.

Ако се появи първоначалната грешка Request timed out before a response was generated , увеличете --timeout и изпратете заявката отново. Това обикновено означава, че времето за изчакване е било недостатъчно и не означава непременно, че адресът е неправилен.

След като краткият отговор успее, помолете го да прочете локален файл, който посочите. След това отворете записите на заявките на OmniProxy и потвърдете източника и идентификатора на модела, показани в записа. Изходът само от командата за версия или doctor не означава, че връзката с модела е напълно конфигурирана.

Инсталация

Командата отговаря

• Номерът на версията се показва
• doctor не съобщава за блокиращи фактори
• Статусът на Gateway е четим

Задача

Изпълни малка задача

• Например, прочетете локален файл
• Отговорът не е грешка
• Препратката към модела е правилна

Логове

Видими в шлюза

• Източникът е OpenClaw
• Идентификаторът на модела съвпада
• Ключът не е добавен в хранилището

Чести грешки

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

Официални препратки

За стъпките за инсталиране вижте OpenClaw install. За персонализирана конфигурация на доставчик вижте Custom providers и configuration fields. За идентификаторите на модели, използвани в примерите, сравнете с Claude model overview и GPT-6 Luna.

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

Запазен резултат или HTTP 200 сам по себе си не доказва пълна съвместимост на агента. Проверете източника и модела в записа на заявката в OmniProxy.

Официални източници · OpenClaw ↗