OpenClaw installimine ja OmniProxy seadistamine

OpenClaw on teie arvutisse installitud tehisintellekti assistent. Saate sellega otse suhelda Telegrami, Discordi, WhatsAppi või Feishu kaudu, ilma et peaksite hoidma avatuna eraldi vestlusakent. Vestlused ja kirjed jäävad sellesse arvutisse ning see saab jätkata järgnevate toimingute tegemist kohapeal.

Enne alustamist

OpenClaw nõuab Node 24.16 või uuemat versiooni. Võite kasutada ka Node 26.1 või uuemat, soovitatav on Node 26. Node pakub OpenClaw’ks vajalikku käituskeskkonda.

Seda saab installida macOS-ile, Linuxile ja Windowsile. Kui arvutis pole sobivat Node’i versiooni, valmistab installiskript selle automaatselt ette: Node 26 macOS-il ja Node 24 LTS Linuxil. pnpm on vajalik ainult siis, kui koostate OpenClaw’d lähtekoodist.

Kui vanem Node’i versioon on juba installitud, ei pea te seda esmalt desinstallima. 2026-10-09 tehtud testimisel oli selle arvuti süsteemne Node’i versioon 24.2.0, mis on alla nõutud 24.16, ja interaktiivne installiskript valmistas automaatselt ette Node 24.21.0.

Kas soovite akent

Töölauakaaslane

• Kasutage Windowsis Hubi installijat
• Kasutage macOS-il GitHubi DMG-d
• Kohaliku Gateway saab installida esmase seadistamise ajal

Ametlikult soovitatav

Installiskript

• macOS Linux WSL2
• Kasutage Windowsis PowerShell-i
• Saate lisada --no-onboard

Node on juba installitud

Paketihaldur

• npm pnpm või bun
• Seejärel käivitage onboard
• Vaadake Node'i versiooni installilehelt

Installimine ja esmakordne käivitamine

Saate installida graafilise aknaga töölauakaaslase või installida otse terminali kaudu. Gateway on kohalik teenus, mis vastutab sõnumite vastuvõtmise, mudelite kutsumise ja tulemuste tagastamise eest. Saate selle seadistada töölauakaaslase esmakordsel avamisel.

Kui soovite akent

• Windows: Laadige alla ja käivitage OpenClawCompanion-Setup-x64.exe või OpenClawCompanion-Setup-arm64.exe. Installija on allkirjastatud ja sisaldab seadeid, salve olekut, vestlust ja sõlmerežiime.
• macOS: Laadige alla OpenClaw .dmg OpenClaw’ GitHubi väljalasetest. Eelistage dmg-d, kuigi võite kasutada ka .zip. Pärast installimist avage OpenClaw.app. Kui see versioon ei sisalda macOS-i faili, järgige macOS-i rakenduse lehte.

Esmakordsel avamisel saate lasta OpenClaw’l valmistada Gateway selles arvutis ette või ühenduda olemasoleva kaug-Gatewayga.

Installimine terminali kaudu

macOS-i, Linuxi ja WSL2 jaoks kasutage:

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

Windows PowerShell-i jaoks kasutage:

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

Skript tuvastab praeguse süsteemi, installib vajadusel Node’i, installib OpenClaw’ ja käivitab seejärel esmase seadistusprotsessi. Seadistusvoog juhendab teid esmakordsel seadistamisel.

Kui te ei soovi veel seadistamist alustada, kasutage macOS-il, Linuxil ja WSL2-l selle asemel järgmist:

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

Windowsis kasutage ametlikku -NoOnboard valikut:

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

Kui haldate Node’i juba ise, võite kasutada ka npm-i, pnpm-i või bun-i. npm 12 või npm 11.16 ja uuemate versioonide puhul käivitage:

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

npm 11.15 ja varasemate versioonide puhul eemaldage --allow-scripts=openclaw. pnpm-i kasutamisel lisage --allow-build=openclaw. Täpsete erinevuste kohta vaadake installilehte.

Pärast installimist käivitage need kolm käsku järjekorras:

openclaw --version
openclaw doctor
openclaw gateway status

openclaw --version kuvab versiooni, openclaw doctor kontrollib levinud keskkonnaprobleeme ja openclaw gateway status näitab, kas Gateway töötab. Põhiline installimine on lõpetatud alles siis, kui kõik kolm käsku annavad tavapärase väljundi.

Kui terminal teatab, et ei leia openclaw, on npm-i globaalne bin-kataloog tavaliselt PATH-ist puudu. PATH on loend asukohtadest, kust terminal programme otsib. Võrrelge väljundit node -v, npm prefix -gja echo "$PATH", lisage vastav bin-kataloog PATH-i ja avage terminal uuesti.

Kui ~/.openclaw sisaldab juba praegu kasutatavat konfiguratsiooni, kasutab vaikimisi installiskript seda kataloogi. Eraldi koopia installimiseks ilma olemasolevat konfiguratsiooni muutmata käivitage mitteinteraktiivne skript ja määrake uus kataloog:

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

--no-onboard on selle skripti vaikimisi käitumine. 2026-10-09 installis see käsk OpenClaw 2026.9.9. Pärast installimist käivitage openclaw käivitatav fail kataloogi bin kaustast.

Ühenduse väärtuste hankimine OmniProxyst

Esmalt veenduge, et OmniProxy töötab, seejärel avage selle mudelite loend ja valmistage ette järgmised kolm väärtust:

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 on aadress, kuhu OpenClaw saadab mudelipäringud, ja see peab lõppema /v1. OmniProxyga ühendamisel kasutage openai-completions väärtuse jaoks api. Muutke see väärtuseks openai-responses ainult siis, kui mudel tegelikult töötab läbi /v1/responses.

Mudeli ID on mudeli täielik identifikaator loendis. Kopeerige see täpselt nii, nagu näidatud, sealhulgas kõik kaldkriipsud. Järgmised kaks nime on ainult viited teenusepakkuja dokumentatsioonist seisuga 2026-10-09; ärge kasutage neid, kui neid loendis ei ole: claude-sonnet-5-5, gpt-6-luna.

Isegi kui lüüs võtit ei valideeri, apiKey peab siiski sisaldama väärtust. Võite kasutada kohatäitja stringi, mida kasutatakse ainult selles arvutis. Ärge lisage hoidlasse päris võtit.

Tööriista konfiguratsiooni sisestamine

Teenusepakkujat (Provider) saab mõista kui ühendusseadete kogumit, mida OpenClaw kasutab mudeliteenuse leidmiseks. Siin on teenusepakkuja nimeks omniproxy.

Käivitage terminalis järgmine käsk, asendades aadressi, võtme ja kaks mudeli ID-d oma väärtustega:

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

See käsk kirjutab teenusepakkuja ja mudelite loendi konfiguratsiooni. Pärast käsu õnnestumist ei pea te Gatewayd taaskäivitama.

Järgmisena määrake vaikimisi mudel. Mudeliviide koosneb eesliitest omniproxy/, millele järgneb mudeli ID. Säilitage kõik ID-s juba olevad kaldkriipsud. Kui mudelite loendis olev ID on pikem kui allpool toodud lühinimi, kasutage loendist täielikku väärtust:

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

reasoning, input, cost, contextWindowja maxTokens võib kõik välja jätta. Kui neid ei esitata, käsitletakse tekstimalle vaikeseadetega.

Samuti saate samad seaded kirjutada otse konfiguratsioonifaili. Põhikonfiguratsioonis asub teenusepakkuja jaotises models.providers. Igal agendil võib olla ka oma models.json; agent on assistendi eksemplar, mis tegelikult võtab vastu ülesandeid ja kutsub mudeleid. Fail asub aadressil agent/models.json vastavas agendi kataloogis jaotise ~/.openclaw/agents/all.

Kui see models.json sisaldab mittetühja baseUrl, alistab see põhikonfiguratsioonis oleva aadressi.

Kontrollige installimist

Kolm käsku

• openclaw --version
• openclaw doctor
• gateway status

Konfiguratsioon

models.providers

• baseUrl lõpeb /v1-ga
• Määrake api väärtuseks completions
• Määrake vähemalt mudeli id

Valige

provider/model

• Kasutage seda viidet esmase jaoks
• Eelistage võtme jaoks keskkonnamuutujat
• Kasutage tõeallikana lüüsi loendit

Kontrollige tegelikku ülesannet

Sisenege tavalisse projektikataloogi ja saatke väga lühike sõnum. Asendage käsus olev mudeliviide oma täieliku mudeli ID-ga:

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

--local käivitab selle agendi ülesande kohapeal, --model määrab selle käivitamise jaoks kasutatava mudeli ja --timeout 300 määrab maksimaalseks ooteajaks 300 sekundit.

Terminalis peab ilmuma tegelik mudeli vastus. 2026-10-09 sai OpenClaw 2026.9.9 selle käsu abil vastuse. Esimene kõne võib võtta ühe või kaks minutit.

Kui ilmub algne viga Request timed out before a response was generated , suurendage --timeout ja saatke päring uuesti. See tähendab tavaliselt, et ooteaeg oli ebapiisav ja ei pruugi tähendada, et aadress on vale.

Pärast lühikese vastuse õnnestumist paluge sellel lugeda teie määratud kohalikku faili. Seejärel avage OmniProxy päringukirjed ja kinnitage kirjes näidatud allikas ja mudeli ID. Ainult versioonikäsu või doctor-käsu väljund ei tähenda, et mudeli ühendus on täielikult konfigureeritud.

Installimine

Käsk vastab

• Versiooninumber on kuvatud
• doctor ei teata blokeerijatest
• Gateway olek on loetav

Ülesanne

See täitis väikese ülesande

• Näiteks lugege kohalikku faili
• Vastus ei ole viga
• Mudeliviide on õige

Logid

Nähtav lüüsis

• Allikas on OpenClaw
• Mudeli ID ühtib
• Võtit ei lisatud hoidlasse

Levinud vead

• Ei leia openclaw: Lisage npm-i globaalne bin-kataloog PATH-i, seejärel avage terminal uuesti. Kui installisite määratud kataloogi, käivitage käivitatav fail selle kataloogi bin kaustast.
• node -v on alla 24.16: Te ei pea vana versiooni esmalt desinstallima. Kontrollige installiskripti ettevalmistatud Node’i versiooni või kasutage 24.16+ või 26.1+, nagu on kirjeldatud installilehel. Soovitatav on Node 26.
• Mudelit ei kuvata: Mudel peab olema lisatud models massiivi jaotise models.providers all ja sellel peab olema vähemalt sama id. Ainult agents.defaults.models seadistamine ei registreeri iseenesest uut mudelit.
• 400-vastus mainib arendaja rolli: Kui aadressi host ei ole api.openai.com, hoidke vaikeseade ja ärge seadke supportsDeveloperRole väärtuseks true. Isegi kui see on seatud väärtusele true, alistatakse see ikkagi.
• See aegub kiiresti: Suurendage --timeout üle 300 sekundi enne aadressi muutmist.
• Tööriistakutsed ebaõnnestuvad pärast valimist gpt-6-luna: See toetab Chat Completionsi; funktsioonide kutsumine Chat Completionsis on toetatud ainult siis, kui reasoning_effort on none. Kui loendis olev ID erineb sellest, kasutage loendis näidatud ID-d.
• Aadressini ei jõuta: Veenduge, et OmniProxy töötab, et baseUrl lõpeb /v1-ga ja et konfiguratsiooni kirjutatud aadress on juurdepääsetav. Teised privaatvõrgu aadressid peavad olema eraldi lubatud.
• Päringud lähevad pärast konfigureerimist ikkagi teisele aadressile: Kontrollige, kas selle agendi models.json sisaldab erinevat baseUrl.

Ametlikud viited

Installimisetappide kohta vaadake OpenClaw install. Kohandatud teenusepakkuja konfiguratsiooni kohta vaadake Custom providers ja configuration fields. Näidetes kasutatud mudeli ID-de võrdlemiseks vaadake Claude model overview ja GPT-6 Luna.

Asenda iga lünk oma OmniProxy seadistuse väärtustega. Ära kunagi avalda tõelist võtit.

Salvestatud tulemus või HTTP 200 iseenesest ei tõesta täielikku Agenti ühilduvust. Vaata allikat ja mudelit OmniProxy päringukirjetes.

Ametlikud allikad · OpenClaw ↗