Namestitev OpenClaw in konfiguracija OmniProxy

OpenClaw je pomočnik z umetno inteligenco, ki ga namestite na svoj računalnik. Z njim se lahko pogovarjate neposredno prek Telegrama, Discorda, WhatsAppa ali Feishu, ne da bi morali imeti odprto dodatno okno za klepet. Pogovori in zapisi ostanejo na tem računalniku, kjer lahko tudi lokalno izvaja nadaljnje korake.

Preden začnete

OpenClaw zahteva Node 24.16 ali novejši. Uporabite lahko tudi Node 26.1 ali novejši, priporočljiv pa je Node 26. Node zagotavlja izvajalno okolje, ki ga OpenClaw potrebuje.

Namestite ga lahko na macOS, Linux in Windows. Če računalnik nima ustrezne različice Node, jo bo namestitveni skript pripravil samodejno: Node 26 na macOS in Node 24 LTS na Linuxu. pnpm je potreben le, če OpenClaw gradite iz izvorne kode.

Če imate že nameščeno starejšo različico Node, je ni treba najprej odstraniti. Med testiranjem 2026-10-09 je bila sistemska različica Node na tem računalniku 24.2.0, kar je manj od zahtevanih 24.16, zato je neinteraktivni namestitveni skript samodejno pripravil Node 24.21.0.

Želite okno

Namizni spremljevalec

• Uporabite namestitveni program Hub v sistemu Windows
• Uporabite GitHub DMG na macOS
• Lokalni prehod (Gateway) lahko namestite med začetno nastavitvijo

Uradno priporočeno

Namestitveni skript

• macOS Linux WSL2
• Uporabite PowerShell v sistemu Windows
• Dodate lahko --no-onboard

Node je že nameščen

Upravljalnik paketov

• npm pnpm ali bun
• Nato zaženite onboard
• Oglejte si stran za namestitev za različico Node

Namestitev in prvi zagon

Namiznega spremljevalca lahko namestite z grafičnim oknom ali pa neposredno prek terminala. Gateway je lokalna storitev, odgovorna za prejemanje sporočil, klicanje modelov in vračanje rezultatov. Nastavite ga lahko ob prvem odpiranju namiznega spremljevalca.

Če želite okno

• Windows: Prenesite in zaženite OpenClawCompanion-Setup-x64.exe ali OpenClawCompanion-Setup-arm64.exe. Namestitveni program je podpisan in vključuje nastavitve, stanje v sistemski vrstici, klepet in načine vozlišča.
• macOS: Prenesite OpenClaw .dmg iz GitHub izdaj OpenClaw. Priporočamo dmg, čeprav lahko uporabite tudi .zip. Po namestitvi odprite OpenClaw.app. Če ta različica ne vključuje datoteke za macOS, sledite navodilom na strani za aplikacijo macOS.

Ob prvem odpiranju lahko OpenClawu dovolite, da pripravi Gateway na tem računalniku, ali pa se povežete z obstoječim oddaljenim Gatewayem.

Namestitev prek terminala

Za macOS, Linux in WSL2 uporabite:

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

Za Windows PowerShell uporabite:

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

Skript zazna trenutni sistem, po potrebi namesti Node, namesti OpenClaw in nato zažene začetni postopek uvajanja (onboarding). Postopek uvajanja vas vodi skozi prvo nastavitev.

Če še ne želite začeti uvajanja, namesto tega na macOS, Linux in WSL2 uporabite:

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

V sistemu Windows uporabite uradno možnost -NoOnboard:

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

Če Node že upravljate sami, lahko uporabite tudi npm, pnpm ali bun. Z npm 12 ali npm 11.16 in novejšimi zaženite:

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

Za npm 11.15 in starejše odstranite --allow-scripts=openclaw. Pri uporabi pnpm dodajte --allow-build=openclaw. Za natančne razlike glejte stran za namestitev.

Po namestitvi po vrsti zaženite te tri ukaze:

openclaw --version
openclaw doctor
openclaw gateway status

openclaw --version prikaže različico, openclaw doctor preveri pogoste težave z okoljem, openclaw gateway status pa pokaže, ali Gateway deluje. Osnovna namestitev je končana šele, ko vsi trije ukazi vrnejo običajen izpis.

Če terminal poroča, da ne najde openclaw, globalni imenik bin za npm običajno manjka v spremenljivki PATH. PATH je seznam lokacij, kjer terminal išče programe. Primerjajte izpis node -v, npm prefix -g in echo "$PATH", dodajte ustrezni imenik bin v PATH in nato znova odprite terminal.

Če ~/.openclaw že vsebuje konfiguracijo, ki je trenutno v uporabi, bo privzeti namestitveni skript uporabil ta imenik. Če želite namestiti ločeno kopijo, ne da bi spremenili obstoječo konfiguracijo, zaženite neinteraktivni skript in določite nov imenik:

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

--no-onboard je privzeto vedenje tega skripta. Dne 2026-10-09 je ta ukaz namestil OpenClaw 2026.9.9. Po namestitvi zaženite izvršljivo datoteko openclaw iz mape bin v imeniku.

Pridobitev povezovalnih vrednosti iz OmniProxy

Najprej potrdite, da OmniProxy deluje, nato odprite njegov seznam modelov in pripravite naslednje tri vrednosti:

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 je naslov, na katerega OpenClaw pošilja zahteve za modele, in se mora končati z /v1. Pri povezovanju z OmniProxy uporabite openai-completions za api. Spremenite ga v openai-responses le, če model dejansko deluje prek /v1/responses.

ID modela je popoln identifikator modela na seznamu. Kopirajte ga natančno tako, kot je prikazano, vključno s poševnicami. Naslednji dve imeni sta le referenci iz dokumentacije ponudnika z dne 2026-10-09; ne uporabljajte ju, če se ne pojavita na seznamu: claude-sonnet-5-5, gpt-6-luna.

Tudi če prehod (gateway) ne preverja ključa, mora apiKey vsebovati vrednost. Uporabite lahko nadomestni niz, ki se uporablja samo na tem računalniku. Pravega ključa ne shranjujte v repozitorij.

Vnos konfiguracije orodja

Ponudnika (Provider) lahko razumemo kot nabor povezovalnih nastavitev, ki jih OpenClaw uporablja za iskanje storitve modela. Tukaj je ponudnik poimenovan omniproxy.

V terminalu zaženite naslednji ukaz in zamenjajte naslov, ključ ter dva ID-ja modela s svojimi vrednostmi:

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

Ta ukaz zapiše ponudnika in seznam modelov v konfiguracijo. Po uspešni izvedbi ukaza vam ni treba znova zagnati Gatewaya.

Nato določite privzeti model. Referenca modela je sestavljena iz omniproxy/, ki ji sledi ID modela. Ohranjajte vse poševnice, ki so že prisotne v ID-ju. Če je ID na seznamu modelov daljši od spodnjega kratkega imena, uporabite celotno vrednost s seznama:

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

reasoning, input, cost, contextWindow in maxTokens lahko izpustite. Če niso podani, se besedilni modeli obravnavajo s privzetimi nastavitvami.

Iste nastavitve lahko zapišete tudi neposredno v konfiguracijsko datoteko. V glavni konfiguraciji se ponudnik nahaja pod models.providers. Vsak agent ima lahko tudi svoj models.json; agent je primerek pomočnika, ki dejansko prejema naloge in kliče modele. Datoteka se nahaja na agent/models.json znotraj ustreznega imenika agenta pod ~/.openclaw/agents/.

Če ta models.json vsebuje neprazen baseUrl, preglasi naslov v glavni konfiguraciji.

Preverite namestitev

Trije ukazi

• openclaw --version
• openclaw doctor
• gateway status

Konfiguracija

models.providers

• baseUrl se konča z /v1
• Nastavite api na completions
• Določite vsaj id modela

Izberite

ponudnik/model

• Uporabite to referenco za primarno
• Za ključ raje uporabite okoljsko spremenljivko
• Uporabite seznam gatewaya kot vir resnice

Preverjanje z dejansko nalogo

Odprite običajen imenik projekta in pošljite zelo kratko sporočilo. V ukazu zamenjajte referenco modela s svojim celotnim ID-jem modela:

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

--local izvaja to nalogo agenta lokalno, --model določa model za to izvedbo, --timeout 300 pa nastavi največji čas čakanja na 300 sekund.

V terminalu se mora prikazati dejanski odgovor modela. Dne 2026-10-09 je OpenClaw 2026.9.9 prejel odgovor z uporabo tega ukaza. Prvi klic lahko traja minuto ali dve.

Če se pojavi prvotna napaka Request timed out before a response was generated, povečajte --timeout in znova pošljite zahtevo. To običajno pomeni, da čas čakanja ni bil zadosten in ne pomeni nujno, da je naslov napačen.

Ko je kratek odgovor uspešen, ga prosite, naj prebere lokalno datoteko, ki jo določite. Nato odprite zapise zahtev OmniProxy in potrdite vir ter ID modela, prikazana v zapisu. Izpis samo iz ukaza za različico ali doctor ne pomeni, da je povezava z modelom v celoti konfigurirana.

Namestitev

Ukaz se odzove

• Prikazana je številka različice
• doctor poroča o brez blokad
• Stanje Gatewaya je berljivo

Naloga

Opravil je majhno nalogo

• Na primer, preberite lokalno datoteko
• Odgovor ni napaka
• Referenca modela je pravilna

Dnevniki

Vidno v gatewayu

• Vir je OpenClaw
• ID modela se ujema
• Ključ ni bil dodan v repozitorij

Pogoste napake

• Ne najdem openclaw: Dodajte globalni imenik bin za npm v PATH, nato znova odprite terminal. Če ste namestili v določen imenik, zaženite izvršljivo datoteko iz mape bin tega imenika.
• node -v je pod 24.16: Stare različice vam ni treba najprej odstraniti. Preverite različico Node, ki jo je pripravil namestitveni skript, ali uporabite 24.16+ oziroma 26.1+, kot je opisano na strani za namestitev. Priporočljiv je Node 26.
• Model se ne prikaže: Model mora biti vključen v polje models pod models.providers in mora imeti vsaj enak id. Nastavitev samo agents.defaults.models sama po sebi ne registrira novega modela.
• Odgovor 400 omenja vlogo razvijalca: Ko gostitelj naslova ni api.openai.com, ohranite privzeto vrednost in ne nastavite supportsDeveloperRole na true. Tudi če je nastavljeno na true, bo vseeno preglasjeno.
• Hitro poteče časovna omejitev: Povečajte --timeout na več kot 300 sekund, preden spremenite naslov.
• Klici orodij ne uspejo po izbiri gpt-6-luna: Podpira Chat Completions; klicanje funkcij v Chat Completions je podprto le, če je reasoning_effort nastavljen na none. Če se ID na seznamu razlikuje od tega, uporabite ID, prikazan na seznamu.
• Naslov ni dosegljiv: Potrdite, da OmniProxy deluje, da se baseUrl konča z /v1 in da je naslov, zapisan v konfiguraciji, dostopen. Druge naslove zasebnih omrežij je treba dovoliti posebej.
• Zahteve po konfiguraciji še vedno gredo na drug naslov: Preverite, ali models.json tega agenta vsebuje drugačen baseUrl.

Uradne reference

Za korake namestitve glejte OpenClaw install. Za konfiguracijo ponudnika po meri glejte Custom providers in configuration fields. Za ID-je modelov, uporabljene v primerih, primerjajte s Claude model overview in GPT-6 Luna.

Zamenjajte vsako mesto z vrednostmi iz vaše lastne konfiguracije OmniProxy. Nikoli ne objavite resničnega ključa.

Shranjen rezultat ali HTTP 200 sam po sebi ne dokazuje popolne združljivosti Agentov. Preverite vir in model v zapisu klica OmniProxy.

Uradni viri · OpenClaw ↗