Namestitev OpenClaw in konfiguracija OmniProxy

OpenClaw je pomočnik AI, nameščen v vašem računalniku. Z njim se lahko pogovarjate neposredno prek Telegrama, Discorda, WhatsAppa ali Feishu, ne da bi morali imeti odprto drugo okno za klepet. Pogovori in zapisi ostanejo v tem računalniku in lahko nadaljuje z izvajanjem naslednjih korakov lokalno.

Preden začnete

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

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

Če je starejša različica Node že nameščena, je ni treba najprej odstraniti. Med testiranjem 2026-10-09 je bila sistemska različica Node v tem računalniku 24.2.0, kar je pod zahtevanimi 24.16, in neinteraktivni namestitveni skript je samodejno pripravil Node 24.21.0.

Želite okno

Namizni spremljevalec

• Uporabite namestitveni program Hub v sistemu Windows
• Uporabite GitHub DMG v sistemu 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

Upravitelj paketov

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

Prva namestitev in zagon

Namestite lahko namiznega spremljevalca 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šč.
• macOS: Prenesite OpenClaw .dmg iz izdaj OpenClaw na GitHubu. Raje uporabite dmg, čeprav lahko uporabite tudi .zip. Po namestitvi odprite OpenClaw.app. Če ta različica ne vključuje datoteke za macOS, sledite strani aplikacije za macOS.

Ob prvem odpiranju lahko OpenClawu dovolite, da pripravi Gateway v 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. Postopek uvajanja vas vodi skozi prvo nastavitev.

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

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 zaporedoma 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 prikažejo običajen izhod.

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

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

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. Na dan 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 vrednosti povezave 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 modelov, 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 od 2026-10-09; ne uporabljajte ju, če se ne pojavita na seznamu: claude-sonnet-5-5, gpt-6-luna.

Tudi če prehod ne preverja ključa, mora apiKey še vedno vsebovati vrednost. Uporabite lahko nadomestni niz, ki se uporablja samo v tem računalniku. Ne uveljavljajte (commit) pravega ključa v repozitorij.

Vnos konfiguracije orodja

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

V terminalu zaženite naslednji ukaz in zamenjajte naslov, ključ in 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. Ohranite vsako poševnico, ki je že prisotna 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 modeli besedila 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 ustrezne mape 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

provider/model

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

Preverjanje dejanske naloge

Vstopite v običajno mapo projekta in pošljite zelo kratko sporočilo. Zamenjajte referenco modela v ukazu s svojim celotnim ID-jem modela:

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

--local zažene to nalogo agenta lokalno, --model določi model, ki se uporablja za ta zagon, --timeout 300 pa nastavi največji čas čakanja na 300 sekund.

V terminalu se mora pojaviti dejanski odgovor modela. Na dan 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 kratek odgovor uspe, ga prosite, naj prebere lokalno datoteko, ki jo določite. Nato odprite zapise zahtev OmniProxy in potrdite vir ter ID modela, prikazana v zapisu. Izhod samo iz ukaza za različico ali doctor ne pomeni, da je bila povezava modela v celoti konfigurirana.

Namestitev

Ukaz se odzove

• Prikaže se številka različice
• doctor ne poroča o blokadah
• Stanje prehoda je berljivo

Naloga

Opravil je majhno nalogo

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

Dnevniki

Vidno v prehodu

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

Pogoste napake

• Ni mogoče najti openclaw: Dodajte globalno mapo bin npm v PATH, nato znova odprite terminal. Če ste namestili v določeno mapo, 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+ ali 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 nastavitev in ne nastavite supportsDeveloperRole na true. Tudi če je nastavljeno na true, bo vseeno preglasil.
• Hitro poteče čas (timeout): 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 zasebnega omrežja je treba dovoliti ločeno.
• 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 Namestitev OpenClaw. Za konfiguracijo ponudnika po meri glejte Ponudniki po meri in konfiguracijska polja. Za ID-je modelov, uporabljene v primerih, primerjajte s pregledom modelov Claude 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 agenta. Preverite vir in model v zapisu klica OmniProxy.

Uradni viri · OpenClaw ↗