Инсталација 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. Инсталер је потписан и укључује подешавања, статус у системској палети, ћаскање и режиме рада са Node-ом.
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, а затим покреће почетни процес увођења (onboarding). Процес увођења вас води кроз подешавање при првом покретању.

Ако још не желите да започнете увођење, уместо тога користите следеће на 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, npm глобални bin директоријум обично недостаје у 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.

ID модела је потпуни идентификатор модела на листи. Копирајте га тачно како је приказано, укључујући све косе црте. Следећа два имена су само референце из документације провајдера од 09.10.2026; немојте их користити ако се не појављују на листи: claude-sonnet-5-5, gpt-6-luna.

Чак и ако gateway не потврђује кључ, apiKey мора ипак да садржи вредност. Можете користити placeholder стринг који се користи само на овом рачунару. Немојте уносити прави кључ у репозиторијум.

Унос конфигурације алата

Провајдер се може разумети као скуп подешавања за повезивање која OpenClaw користи да пронађе сервис модела. Овде је провајдер именован omniproxy.

Покрените следећу команду у терминалу, замењујући адресу, кључ и два ID-а модела својим вредностима:

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/ праћеног ID-ом модела. Сачувајте сваку косу црту која је већ присутна у ID-у. Ако је ID на листи модела дужи од кратког имена испод, користите пуну вредност са листе:

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
Наведите барем id модела

Изаберите

provider/model

Користите ову референцу за примарни
Преферирајте променљиву окружења за кључ
Користите листу gateway-а као извор истине

Прво потврдите да се команда може пронаћи, затим унесите адресу и модел. Референца модела мора укључивати име провајдера.

Верификација стварног задатка

Уђите у обичан директоријум пројекта и пошаљите врло кратку поруку. Замените референцу модела у команди својим пуним ID-ом модела:

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-а и потврдите извор и ID модела приказан у запису. Излаз само команде за верзију или doctor-а не значи да је повезивање модела у потпуности конфигурисано.

Инсталација

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

Број верзије је приказан
doctor не пријављује блокаде
Статус Gateway-а је читљив

Задатак

Завршио је мали задатак

На пример, прочитајте локалну датотеку
Одговор није грешка
Референца модела је тачна

Логови

Видљиво у gateway-у

Извор је OpenClaw
ID модела се поклапа
Кључ није додат у репозиторијум

Након што команда за верзију да излаз, морате такође примити један стварни одговор.

Уобичајене грешке

Не могу да пронађем openclaw: Додајте npm глобални bin директоријум у 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. Ако се ID на листи разликује од овог, користите ID приказан на листи.
Адреса није доступна: Потврдите да OmniProxy ради, да baseUrl се завршава са /v1, и да је адреса уписана у конфигурацију доступна. Остале адресе приватне мреже морају бити посебно дозвољене.
Захтеви и даље иду на другу адресу након конфигурације: Проверите да ли тај агент models.json садржи другачији baseUrl.

Званичне референце

За кораке инсталације, погледајте OpenClaw install. За конфигурацију прилагођеног провајдера, погледајте Custom providers и configuration fields. За ID-ове модела коришћене у примерима, упоредите са Claude model overview и GPT-6 Luna.

Замените сваки чувар места вредностима из ваше OmniProxy конфигурације. Никада не објављујте стварни кључ.

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

Званични извори · OpenClaw ↗