Instalacija OpenClaw-a i konfiguracija OmniProxy-a

OpenClaw je AI asistent instaliran na vašem računalu. S njim možete razgovarati izravno putem Telegrama, Discorda, WhatsAppa ili Feishu-a bez potrebe za otvaranjem dodatnog prozora za chat. Razgovori i zapisi ostaju na ovom računalu, a on može nastaviti s izvršavanjem naknadnih koraka lokalno.

Prije početka

OpenClaw zahtijeva Node 24.16 ili noviji. Možete koristiti i Node 26.1 ili noviji, pri čemu se preporučuje Node 26. Node osigurava runtime okruženje potrebno za OpenClaw.

Može se instalirati na macOS, Linux i Windows. Ako računalo nema odgovarajuću verziju Node-a, instalacijska skripta će je automatski pripremiti: Node 26 na macOS-u i Node 24 LTS na Linuxu. pnpm je potreban samo ako gradite OpenClaw iz izvornog koda.

Ako je starija verzija Node-a već instalirana, ne morate je prvo deinstalirati. Tijekom testiranja 09.10.2026., verzija sustava Node na ovom računalu bila je 24.2.0, što je ispod potrebnih 24.16, a neinteraktivna instalacijska skripta automatski je pripremila Node 24.21.0.

Želite prozor

Desktop suputnik

• Koristite Hub instalacijski program na Windowsima
• Koristite GitHub DMG na macOS-u
• Lokalni Gateway se može instalirati tijekom početnog postavljanja

Službeno preporučeno

Instalacijska skripta

• macOS Linux WSL2
• Koristite PowerShell na Windowsima
• Možete dodati --no-onboard

Node je već instaliran

Upravitelj paketa

• npm pnpm ili bun
• Zatim pokrenite onboard
• Pogledajte stranicu za instalaciju za verziju Node-a

Instalacija i prvo pokretanje

Možete instalirati desktop suputnika s grafičkim prozorom ili instalirati izravno putem terminala. Gateway je lokalna usluga odgovorna za primanje poruka, pozivanje modela i vraćanje rezultata. Možete ga postaviti pri prvom otvaranju desktop suputnika.

Ako želite prozor

• Windows: Preuzmite i pokrenite OpenClawCompanion-Setup-x64.exe ili OpenClawCompanion-Setup-arm64.exe. Instalacijski program je potpisan i uključuje postavke, status u traci, chat i načine rada čvora.
• macOS: Preuzmite OpenClaw .dmg iz OpenClaw GitHub izdanja. Preferirajte dmg, iako možete koristiti i .zip. Otvorite OpenClaw.app nakon instalacije. Ako ova verzija ne uključuje macOS datoteku, slijedite stranicu za macOS aplikaciju.

Prilikom prvog otvaranja, možete dopustiti OpenClaw-u da pripremi Gateway na ovom računalu ili se povezati na postojeći udaljeni Gateway.

Instalacija putem terminala

Za macOS, Linux i WSL2, koristite:

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

Za Windows PowerShell, koristite:

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

Skripta detektira trenutni sustav, instalira Node kada je potrebno, instalira OpenClaw, a zatim pokreće početni proces uvođenja (onboarding). Proces uvođenja vodi vas kroz prvo postavljanje.

Ako još ne želite započeti uvođenje, umjesto toga koristite sljedeće na macOS-u, Linuxu i WSL2:

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

Na Windowsima koristite službenu -NoOnboard opciju:

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

Ako već sami upravljate Node-om, možete koristiti i npm, pnpm ili bun. S npm 12 ili npm 11.16 i novijim, pokrenite:

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

Za npm 11.15 i starije, uklonite --allow-scripts=openclaw. Kada koristite pnpm, dodajte --allow-build=openclaw. Pogledajte stranicu za instalaciju za točne razlike.

Nakon instalacije, pokrenite ove tri naredbe redom:

openclaw --version
openclaw doctor
openclaw gateway status

openclaw --version prikazuje verziju, openclaw doctor provjerava uobičajene probleme s okruženjem, i openclaw gateway status pokazuje radi li Gateway. Osnovna instalacija je dovršena tek kada sve tri naredbe daju normalan izlaz.

Ako terminal javi da ne može pronaći openclaw, npm globalni bin direktorij obično nedostaje u PATH-u. PATH je popis lokacija gdje terminal traži programe. Usporedite izlaz node -v, npm prefix -g, i echo "$PATH", dodajte odgovarajući bin direktorij u PATH, a zatim ponovno otvorite terminal.

Ako ~/.openclaw već sadrži konfiguraciju koja se trenutno koristi, zadana instalacijska skripta će koristiti taj direktorij. Za instalaciju zasebne kopije bez promjene postojeće konfiguracije, pokrenite neinteraktivnu skriptu i navedite novi direktorij:

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

--no-onboard je zadano ponašanje ove skripte. 09.10.2026., ova naredba je instalirala OpenClaw 2026.9.9. Nakon instalacije, pokrenite openclaw izvršnu datoteku iz direktorija bin mape.

Dohvaćanje vrijednosti povezivanja iz OmniProxy-a

Prvo potvrdite da OmniProxy radi, zatim otvorite njegov popis modela i pripremite sljedeće tri vrijednosti:

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 adresa na koju OpenClaw šalje zahtjeve za modelima i mora završavati s /v1. Prilikom povezivanja na OmniProxy, koristite openai-completions za api. Promijenite ga u openai-responses samo ako model zapravo radi putem /v1/responses.

ID modela je potpuni identifikator modela na popisu. Kopirajte ga točno kako je prikazano, uključujući sve kose crte. Sljedeća dva imena su samo reference iz dokumentacije pružatelja usluga od 09.10.2026.; nemojte ih koristiti ako se ne pojavljuju na popisu: claude-sonnet-5-5, gpt-6-luna.

Čak i ako gateway ne provjerava ključ, apiKey i dalje mora sadržavati vrijednost. Možete koristiti niz rezerviranog mjesta (placeholder) koji se koristi samo na ovom računalu. Nemojte predati pravi ključ u repozitorij.

Unos konfiguracije alata

Pružatelj (Provider) se može shvatiti kao skup postavki povezivanja koje OpenClaw koristi za pronalaženje usluge modela. Ovdje je pružatelj nazvan omniproxy.

Pokrenite sljedeću naredbu u terminalu, zamjenjujući adresu, ključ i dva ID-a modela vlastitim vrijednostima:

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

Ova naredba zapisuje pružatelja i popis modela u konfiguraciju. Ne morate ponovno pokretati Gateway nakon što naredba uspije.

Zatim navedite zadani model. Referenca modela sastoji se od omniproxy/ praćeno ID-om modela. Zadržite svaku kosu crtu koja je već prisutna u ID-u. Ako je ID na popisu modela duži od kratkog imena ispod, koristite potpunu vrijednost s popisa:

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

reasoning, input, cost, contextWindow, i maxTokens se mogu izostaviti. Kada nisu navedeni, tekstualni modeli se obrađuju koristeći zadane postavke.

Iste postavke možete napisati i izravno u konfiguracijsku datoteku. U glavnoj konfiguraciji, pružatelj se nalazi pod models.providers. Svaki agent također može imati svoj models.json; agent je instanca asistenta koja zapravo prima zadatke i poziva modele. Datoteka se nalazi na agent/models.json unutar odgovarajućeg direktorija agenta pod ~/.openclaw/agents/.

Ako ovaj models.json sadrži neprazan baseUrl, on nadjačava adresu u glavnoj konfiguraciji.

Provjeri instalaciju

Tri naredbe

• openclaw --version
• openclaw doctor
• gateway status

Konfiguracija

models.providers

• baseUrl završava s /v1
• Postavi api na completions
• Navedite barem id modela

Odaberite

provider/model

• Koristite ovu referencu za primarni
• Preferirajte varijablu okruženja za ključ
• Koristite popis gateway-a kao izvor istine

Provjera stvarnog zadatka

Uđite u običan direktorij projekta i pošaljite vrlo kratku poruku. Zamijenite referencu modela u naredbi svojim potpunim ID-om modela:

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

--local pokreće ovaj zadatak agenta lokalno, --model navodi model koji se koristi za ovo pokretanje, i --timeout 300 postavlja maksimalno vrijeme čekanja na 300 sekundi.

Stvarni odgovor modela mora se pojaviti u terminalu. 09.10.2026., OpenClaw 2026.9.9 primio je odgovor koristeći ovu naredbu. Prvi poziv može potrajati minutu ili dvije.

Ako se pojavi izvorna pogreška Request timed out before a response was generated , povećajte --timeout i ponovno pošaljite zahtjev. To obično znači da vrijeme čekanja nije bilo dovoljno i ne znači nužno da je adresa netočna.

Nakon što kratki odgovor uspije, zatražite ga da pročita lokalnu datoteku koju navedete. Zatim otvorite zapise zahtjeva OmniProxy-a i potvrdite izvor i ID modela prikazan u zapisu. Izlaz samo iz naredbe verzije ili doctor ne znači da je veza s modelom u potpunosti konfigurirana.

Instalacija

Naredba odgovara

• Prikazan je broj verzije
• doctor ne prijavljuje blokatore
• Status Gateway-a je čitljiv

Zadatak

Dovršio je mali zadatak

• Na primjer, pročitajte lokalnu datoteku
• Odgovor nije pogreška
• Referenca modela je točna

Zapisnici

Vidljivo u gateway-u

• Izvor je OpenClaw
• ID modela se podudara
• Ključ nije dodan u repozitorij

Uobičajene pogreške

• Ne mogu pronaći openclaw: Dodajte npm globalni bin direktorij u PATH, zatim ponovno otvorite terminal. Ako ste instalirali u određeni direktorij, pokrenite izvršnu datoteku iz tog direktorija bin mape.
• node -v je ispod 24.16: Ne morate prvo deinstalirati staru verziju. Provjerite verziju Node-a koju je pripremila instalacijska skripta ili koristite 24.16+ ili 26.1+ kako je opisano na stranici za instalaciju. Preporučuje se Node 26.
• Model se ne pojavljuje: Model mora biti uključen u models niz pod models.providers i mora imati barem isti id. Postavljanje samo agents.defaults.models samo po sebi ne registrira novi model.
• Odgovor 400 spominje ulogu programera: Kada host adrese nije api.openai.com, zadržite zadano i nemojte postavljati supportsDeveloperRole na true. Čak i ako je postavljeno na true, i dalje će biti nadjačano.
• Vrijeme čekanja brzo istječe: Povećajte --timeout na više od 300 sekundi prije promjene adrese.
• Pozivi alata ne uspijevaju nakon odabira gpt-6-luna: Podržava Chat Completions; pozivanje funkcija u Chat Completions podržano je samo kada reasoning_effort je none. Ako se ID na popisu razlikuje od ovog, koristite ID prikazan na popisu.
• Adresa nije dostupna: Potvrdite da OmniProxy radi, da baseUrl završava s /v1, i da je adresa zapisana u konfiguraciju dostupna. Ostale adrese privatne mreže moraju se zasebno dopustiti.
• Zahtjevi i dalje idu na drugu adresu nakon konfiguracije: Provjerite sadrži li agentov models.json drugačiji baseUrl.

Službene reference

Za korake instalacije, pogledajte OpenClaw install. Za prilagođenu konfiguraciju pružatelja, pogledajte Custom providers i configuration fields. Za ID-ove modela korištene u primjerima, usporedite s Claude model overview i GPT-6 Luna.

Zamijenite svaki predložak vrijednostima iz vlastite OmniProxy konfiguracije. Nikada ne objavite stvarni ključ.

Spremljeni rezultat ili HTTP 200 sami po sebi ne dokazuju punu kompatibilnost Agenta. Provjerite izvor i model u zapisu poziva OmniProxy.

Službeni izvori · OpenClaw ↗