„OpenClaw“ diegimas ir „OmniProxy“ konfigūravimas

„OpenClaw“ yra jūsų kompiuteryje įdiegtas DI asistentas. Galite su juo bendrauti tiesiogiai per „Telegram“, „Discord“, „WhatsApp“ ar „Feishu“, nelaikydami atviro kito pokalbių lango. Pokalbiai ir įrašai lieka šiame kompiuteryje, be to, jis gali tęsti tolesnius veiksmus vietoje.

Prieš pradedant

„OpenClaw“ reikalauja „Node 24.16“ arba naujesnės versijos. Taip pat galite naudoti „Node 26.1“ ar naujesnę versiją (rekomenduojama „Node 26“). „Node“ suteikia „OpenClaw“ reikalingą vykdymo aplinką.

Ją galima įdiegti „macOS“, „Linux“ ir „Windows“ sistemose. Jei kompiuteryje nėra tinkamos „Node“ versijos, diegimo scenarijus ją paruoš automatiškai: „Node 26“ „macOS“ sistemoje ir „Node 24 LTS“ „Linux“ sistemoje. „pnpm“ reikalingas tik kuriant „OpenClaw“ iš pirminio kodo.

Jei jau įdiegta senesnė „Node“ versija, pirmiausia jos šalinti nereikia. 2026-10-09 atlikto testavimo metu sistemos „Node“ versija šiame kompiuteryje buvo 24.2.0 (žemesnė nei reikalaujama 24.16), o neinteraktyvus diegimo scenarijus automatiškai paruošė „Node 24.21.0“.

Norite lango

Darbalaukio pagalbinė programa

• Naudokite „Hub“ diegimo programą „Windows“ sistemoje
• Naudokite „GitHub DMG“ „macOS“ sistemoje
• Vietinį „Gateway“ galima įdiegti pradinės sąrankos metu

Oficialiai rekomenduojama

Diegimo scenarijus

• macOS Linux WSL2
• Naudokite „PowerShell“ „Windows“ sistemoje
• Galite pridėti --no-onboard

„Node“ jau įdiegta

Paketų tvarkyklė

• npm pnpm arba bun
• Tada paleiskite onboard
• „Node“ versiją rasite diegimo puslapyje

Pirmasis diegimas ir paleidimas

Galite įdiegti darbalaukio pagalbinę programą su grafiniu langu arba įdiegti tiesiogiai per terminalą. „Gateway“ yra vietinė paslauga, atsakinga už pranešimų gavimą, modelių iškvietimą ir rezultatų grąžinimą. Ją galite nustatyti pirmą kartą atidarę darbalaukio pagalbinę programą.

Jei norite lango

• Windows: Atsisiųskite ir paleiskite OpenClawCompanion-Setup-x64.exe arba OpenClawCompanion-Setup-arm64.exe. Diegimo programa yra pasirašyta ir apima nustatymus, dėklo būseną, pokalbius ir „node“ režimus.
• macOS: Atsisiųskite OpenClaw .dmg iš „OpenClaw“ „GitHub“ leidimų. Pirmenybę teikite „dmg“, nors galite naudoti ir .zip. Įdiegę atidarykite „OpenClaw.app“. Jei šioje versijoje nėra „macOS“ failo, vadovaukitės „macOS“ programos puslapiu.

Atidarydami pirmą kartą, galite leisti „OpenClaw“ paruošti „Gateway“ šiame kompiuteryje arba prisijungti prie esamo nuotolinio „Gateway“.

Diegimas per terminalą

„macOS“, „Linux“ ir „WSL2“ sistemoms naudokite:

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

„Windows PowerShell“ naudokite:

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

Scenarijus aptinka esamą sistemą, prireikus įdiegia „Node“, įdiegia „OpenClaw“ ir tada pradeda pradinį parengiamąjį procesą. Parengiamasis procesas padės atlikti pirmąją sąranką.

Jei dar nenorite pradėti parengiamojo proceso, „macOS“, „Linux“ ir „WSL2“ sistemose naudokite:

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

„Windows“ sistemoje naudokite oficialią -NoOnboard parinktį:

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

Jei „Node“ jau tvarkote patys, taip pat galite naudoti „npm“, „pnpm“ arba „bun“. Su „npm 12“ arba „npm 11.16“ ir naujesnėmis versijomis paleiskite:

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

„npm 11.15“ ir senesnėms versijoms pašalinkite --allow-scripts=openclaw. Naudodami „pnpm“, pridėkite --allow-build=openclaw. Tikslius skirtumus rasite diegimo puslapyje.

Įdiegę, iš eilės paleiskite šias tris komandas:

openclaw --version
openclaw doctor
openclaw gateway status

openclaw --version parodo versiją, openclaw doctor patikrina bendras aplinkos problemas, o openclaw gateway status parodo, ar „Gateway“ veikia. Pagrindinis diegimas baigtas tik tada, kai visos trys komandos pateikia įprastą išvestį.

Jei terminalas praneša, kad neranda openclaw, „npm“ visuotinio „bin“ katalogo greičiausiai nėra „PATH“ kintamajame. „PATH“ yra vietų, kuriose terminalas ieško programų, sąrašas. Palyginkite node -v, npm prefix -gišvestį ir echo "$PATH", pridėkite atitinkamą „bin“ katalogą prie „PATH“ ir iš naujo atidarykite terminalą.

Jei ~/.openclaw jau turi šiuo metu naudojamą konfigūraciją, numatytasis diegimo scenarijus naudos tą katalogą. Norėdami įdiegti atskirą kopiją nekeisdami esamos konfigūracijos, paleiskite neinteraktyvų scenarijų ir nurodykite naują katalogą:

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

--no-onboard yra numatytoji šio scenarijaus elgsena. 2026-10-09 ši komanda įdiegė „OpenClaw 2026.9.9“. Įdiegę, paleiskite openclaw vykdomąjį failą iš katalogo bin aplanko.

Ryšio reikšmių gavimas iš „OmniProxy“

Pirmiausia patvirtinkite, kad „OmniProxy“ veikia, tada atidarykite jo modelių sąrašą ir paruoškite šias tris reikšmes:

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 yra adresas, į kurį „OpenClaw“ siunčia modelių užklausas, ir jis turi baigtis /v1. Jungdamiesi prie „OmniProxy“, naudokite openai-completions skirta api. Pakeiskite jį į openai-responses tik jei modelis iš tikrųjų veikia per /v1/responses.

Modelio ID yra visas modelio identifikatorius sąraše. Nukopijuokite jį tiksliai taip, kaip parodyta, įskaitant visus pasviruosius brūkšnius. Šie du pavadinimai yra tik nuorodos iš teikėjo dokumentacijos 2026-10-09 duomenimis; nenaudokite jų, jei jų nėra sąraše: claude-sonnet-5-5, gpt-6-luna.

Net jei „gateway“ nepatvirtina rakto, apiKey vis tiek turi turėti reikšmę. Galite naudoti vietos rezervavimo eilutę, kuri naudojama tik šiame kompiuteryje. Nekelkite tikro rakto į saugyklą.

Įrankio konfigūracijos įvedimas

Teikėją (Provider) galima suprasti kaip ryšio nustatymų rinkinį, kurį „OpenClaw“ naudoja modelio paslaugai surasti. Čia teikėjas pavadintas omniproxy.

Terminale paleiskite šią komandą, pakeisdami adresą, raktą ir du modelių ID savo reikšmėmis:

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

Ši komanda įrašo teikėją ir modelių sąrašą į konfigūraciją. Po komandos sėkmės „Gateway“ iš naujo paleisti nereikia.

Tada nurodykite numatytąjį modelį. Modelio nuorodą sudaro omniproxy/ po kurio eina modelio ID. Išsaugokite visus ID jau esančius pasviruosius brūkšnius. Jei ID modelių sąraše yra ilgesnis nei trumpasis pavadinimas žemiau, naudokite visą reikšmę iš sąrašo:

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

reasoning, input, cost, contextWindow, ir maxTokens galima praleisti. Kai jie nepateikiami, teksto modeliai tvarkomi naudojant numatytuosius nustatymus.

Taip pat galite įrašyti tuos pačius nustatymus tiesiai į konfigūracijos failą. Pagrindinėje konfigūracijoje teikėjas yra po models.providers. Kiekvienas agentas taip pat gali turėti savo models.json; agentas yra asistento egzempliorius, kuris iš tikrųjų gauna užduotis ir iškviečia modelius. Failas yra agent/models.json atitinkamame agento kataloge po ~/.openclaw/agents/.

Jei šiame models.json yra netuščias baseUrl, jis nepaiso pagrindinės konfigūracijos adreso.

Patikrinti diegimą

Trys komandos

• openclaw --version
• openclaw doctor
• gateway status

Konfigūracija

models.providers

• baseUrl baigiasi /v1
• Nustatyti api į completions
• Nurodykite bent modelio id

Pasirinkite

provider/model

• Naudokite šią nuorodą pagrindiniam
• Raktui teikite pirmenybę aplinkos kintamajam
• Naudokite „gateway“ sąrašą kaip tiesos šaltinį

Tikros užduoties patikrinimas

Įeikite į įprastą projekto katalogą ir išsiųskite labai trumpą pranešimą. Komandoje pakeiskite modelio nuorodą savo visu modelio ID:

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

--local vykdo šią agento užduotį vietoje, --model nurodo šiam vykdymui naudojamą modelį, o --timeout 300 nustato maksimalų laukimo laiką iki 300 sekundžių.

Terminale turi pasirodyti tikras modelio atsakymas. 2026-10-09 „OpenClaw 2026.9.9“ gavo atsakymą naudodamas šią komandą. Pirmasis iškvietimas gali užtrukti minutę ar dvi.

Jei pasirodo pradinė klaida Request timed out before a response was generated , padidinkite --timeout ir vėl išsiųskite užklausą. Tai dažniausiai reiškia, kad laukimo laikas buvo nepakankamas, ir nebūtinai rodo, kad adresas neteisingas.

Kai trumpas atsakymas pavyks, paprašykite jo perskaityti jūsų nurodytą vietinį failą. Tada atidarykite „OmniProxy“ užklausų įrašus ir patvirtinkite įraše rodomą šaltinį bei modelio ID. Išvestis tik iš versijos komandos ar „doctor“ nereiškia, kad modelio ryšys buvo visiškai sukonfigūruotas.

Diegimas

Komanda atsako

• Rodomas versijos numeris
• „doctor“ nepraneša apie kliūtis
• „Gateway“ būsena yra skaitoma

Užduotis

Atlikta maža užduotis

• Pavyzdžiui, perskaityti vietinį failą
• Atsakymas nėra klaida
• Modelio nuoroda teisinga

Žurnalai

Matomi „gateway“

• Šaltinis yra „OpenClaw“
• Modelio ID sutampa
• Raktas nebuvo įtrauktas į saugyklą

Dažnos klaidos

• Nerandama openclaw: Pridėkite „npm“ visuotinį „bin“ katalogą prie „PATH“, tada iš naujo atidarykite terminalą. Jei įdiegėte į nurodytą katalogą, paleiskite vykdomąjį failą iš to katalogo bin aplanko.
• node -v yra žemesnė nei 24.16: Nereikia pirmiausia šalinti senos versijos. Patikrinkite diegimo scenarijaus paruoštą „Node“ versiją arba naudokite 24.16+ ar 26.1+, kaip aprašyta diegimo puslapyje. Rekomenduojama „Node 26“.
• Modelis nerodomas: Modelis turi būti įtrauktas į models masyvą po models.providers ir turi turėti bent tą patį id. Tik nustatymas agents.defaults.models pats savaime neregistruoja naujo modelio.
• 400 atsakyme minimas kūrėjo vaidmuo: Kai adreso pagrindinis kompiuteris nėra api.openai.com, palikite numatytąjį ir nenustatykite supportsDeveloperRole į „true“. Net jei jis nustatytas į „true“, jis vis tiek bus nepaisomas.
• Greitai baigiasi laikas: Padidinkite --timeout iki daugiau nei 300 sekundžių prieš keisdami adresą.
• Įrankių iškvietimai nepavyksta pasirinkus gpt-6-luna: Jis palaiko „Chat Completions“; funkcijų iškvietimas „Chat Completions“ palaikomas tik tada, kai reasoning_effort yra none. Jei ID sąraše skiriasi nuo šio, naudokite sąraše rodomą ID.
• Adresas nepasiekiamas: Patvirtinkite, kad „OmniProxy“ veikia, kad baseUrl baigiasi /v1, ir kad į konfigūraciją įrašytas adresas yra pasiekiamas. Kiti privataus tinklo adresai turi būti leidžiami atskirai.
• Užklausos po konfigūravimo vis tiek siunčiamos kitu adresu: Patikrinkite, ar to agento models.json turi kitą baseUrl.

Oficialios nuorodos

Diegimo veiksmus rasite OpenClaw install. Individualaus teikėjo konfigūraciją rasite Custom providers ir configuration fields. Pavyzdžiuose naudojamus modelių ID palyginkite su Claude model overview ir GPT-6 Luna.

Pakeiskite visus rezervuotus laukelius reikšmėmis iš savo „OmniProxy“ konfigūracijos. Niekada neskelbkite tikro rakto.

Vien išsaugoto rezultato ar HTTP 200 nepakanka visapusiškam agento suderinamumui įrodyti. Patikrinkite šaltinį ir modelį „OmniProxy“ užklausos įraše.

Oficialūs šaltiniai · OpenClaw ↗