Inštalácia OpenClaw a konfigurácia OmniProxy

OpenClaw je AI asistent nainštalovaný vo vašom vlastnom počítači. Môžete s ním komunikovať priamo cez Telegram, Discord, WhatsApp alebo Feishu bez toho, aby ste museli mať otvorenú ďalšiu chatovú aplikáciu. Konverzácie a záznamy zostávajú v tomto počítači a asistent môže následne vykonávať ďalšie kroky lokálne.

Skôr než začnete

OpenClaw vyžaduje Node 24.16 alebo novší. Môžete použiť aj Node 26.1 alebo novší, pričom sa odporúča Node 26. Node poskytuje runtime prostredie potrebné pre OpenClaw.

Možno ho nainštalovať na macOS, Linux a Windows. Ak počítač nemá vhodnú verziu Node, inštalačný skript ju pripraví automaticky: Node 26 na macOS a Node 24 LTS na Linuxe. pnpm je potrebný iba pri kompilácii OpenClaw zo zdrojového kódu.

Ak už máte nainštalovanú staršiu verziu Node, nemusíte ju najprv odinštalovať. Počas testovania 9. 10. 2026 bola systémová verzia Node v tomto počítači 24.2.0, čo je menej ako požadovaných 24.16, a skript bez interaktívneho nastavenia automaticky pripravil Node 24.21.0.

Chcete okno

Desktopový spoločník

• Použite inštalátor Hub vo Windows
• Použite GitHub DMG na macOS
• Lokálnu bránu (Gateway) možno nainštalovať počas úvodného nastavenia

Oficiálne odporúčané

Inštalačný skript

• macOS Linux WSL2
• Použite PowerShell vo Windows
• Môžete pridať --no-onboard

Node je už nainštalovaný

Správca balíkov

• npm pnpm alebo bun
• Potom spustite onboard
• Verziu Node nájdete na inštalačnej stránke

Inštalácia a prvé spustenie

Desktopového spoločníka s grafickým oknom si môžete nainštalovať alebo inštaláciu vykonať priamo cez terminál. Gateway je lokálna služba zodpovedná za prijímanie správ, volanie modelov a vracanie výsledkov. Môžete ju nastaviť pri prvom otvorení desktopového spoločníka.

Ak chcete okno

• Windows: Stiahnite a spustite OpenClawCompanion-Setup-x64.exe alebo OpenClawCompanion-Setup-arm64.exe. Inštalátor je podpísaný a obsahuje nastavenia, stav v systémovej lište, chat a režimy uzlov.
• macOS: Stiahnite si OpenClaw .dmg z vydaní OpenClaw na GitHub. Uprednostnite dmg, hoci môžete použiť aj .zip. Po inštalácii otvorte OpenClaw.app. Ak táto verzia neobsahuje súbor pre macOS, postupujte podľa stránky aplikácie pre macOS.

Pri prvom otvorení môžete nechať OpenClaw pripraviť Gateway v tomto počítači alebo sa pripojiť k existujúcej vzdialenej Gateway.

Inštalácia cez terminál

Pre macOS, Linux a WSL2 použite:

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

Pre Windows PowerShell použite:

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

Skript rozpozná aktuálny systém, v prípade potreby nainštaluje Node, nainštaluje OpenClaw a následne spustí úvodný proces nastavenia (onboarding). Proces vás prevedie prvotným nastavením.

Ak ešte nechcete spustiť onboarding, použite namiesto toho na macOS, Linuxe a WSL2:

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

Vo Windows použite oficiálnu -NoOnboard možnosť:

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

Ak už spravujete Node sami, môžete použiť aj npm, pnpm alebo bun. S npm 12 alebo npm 11.16 a novším spustite:

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

Pre npm 11.15 a staršie odstráňte --allow-scripts=openclaw. Pri použití pnpm pridajte --allow-build=openclaw. Presné rozdiely nájdete na inštalačnej stránke.

Po inštalácii spustite tieto tri príkazy v poradí:

openclaw --version
openclaw doctor
openclaw gateway status

openclaw --version zobrazí verziu, openclaw doctor skontroluje bežné problémy s prostredím a openclaw gateway status ukáže, či je Gateway spustená. Základná inštalácia je dokončená až vtedy, keď všetky tri príkazy vyprodukujú normálny výstup.

Ak terminál nahlási, že nemôže nájsť openclaw, zvyčajne chýba globálny adresár bin pre npm v premennej PATH. PATH je zoznam umiestnení, kde terminál hľadá programy. Porovnajte výstup node -v, npm prefix -g a echo "$PATH", pridajte príslušný adresár bin do PATH a potom znova otvorte terminál.

Ak ~/.openclaw už obsahuje konfiguráciu, ktorá sa práve používa, predvolený inštalačný skript použije tento adresár. Ak chcete nainštalovať samostatnú kópiu bez zmeny existujúcej konfigurácie, spustite neinštalačný skript a zadajte nový adresár:

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

--no-onboard je predvolené správanie tohto skriptu. Dňa 9. 10. 2026 tento príkaz nainštaloval OpenClaw 2026.9.9. Po inštalácii spustite openclaw spustiteľný súbor z priečinka bin adresára.

Získanie hodnôt pripojenia z OmniProxy

Najprv potvrďte, že OmniProxy beží, potom otvorte zoznam modelov a pripravte si nasledujúce tri hodnoty:

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 ktorú OpenClaw odosiela požiadavky na modely, a musí končiť na /v1. Pri pripájaní k OmniProxy použite openai-completions pre api. Zmeňte to na openai-responses iba vtedy, ak model skutočne funguje cez /v1/responses.

ID modelu je úplný identifikátor modelu v zozname. Skopírujte ho presne tak, ako je zobrazený, vrátane všetkých lomiek. Nasledujúce dva názvy sú len referencie z dokumentácie poskytovateľa k 9. 10. 2026; nepoužívajte ich, ak sa v zozname nenachádzajú: claude-sonnet-5-5, gpt-6-luna.

Aj keď brána (gateway) kľúč neoveruje, apiKey musí stále obsahovať hodnotu. Môžete použiť zástupný reťazec, ktorý sa používa iba v tomto počítači. Neukladajte skutočný kľúč do úložiska (repository).

Zadanie konfigurácie nástroja

Poskytovateľa (Provider) možno chápať ako súbor nastavení pripojenia, ktoré OpenClaw používa na nájdenie modelovej služby. Tu je poskytovateľ pomenovaný omniproxy.

Spustite nasledujúci príkaz v termináli a nahraďte adresu, kľúč a dve ID modelov svojimi vlastnými hodnotami:

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

Tento príkaz zapíše poskytovateľa a zoznam modelov do konfigurácie. Po úspešnom vykonaní príkazu nemusíte reštartovať Gateway.

Ďalej zadajte predvolený model. Referencia modelu pozostáva z omniproxy/ nasledovaného ID modelu. Zachovajte každú lomku, ktorá je už v ID prítomná. Ak je ID v zozname modelov dlhšie ako krátky názov nižšie, použite úplnú hodnotu zo zoznamu:

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

reasoning, input, cost, contextWindowa maxTokens možno vynechať. Keď nie sú poskytnuté, textové modely sa spracovávajú pomocou predvolených nastavení.

Rovnaké nastavenia môžete zapísať aj priamo do konfiguračného súboru. V hlavnej konfigurácii sa poskytovateľ nachádza pod models.providers. Každý agent môže mať aj svoj vlastný models.json; agent je inštancia asistenta, ktorá skutočne prijíma úlohy a volá modely. Súbor sa nachádza v agent/models.json v rámci príslušného adresára agenta pod ~/.openclaw/agents/.

Ak tento models.json obsahuje neprázdny baseUrl, prepíše adresu v hlavnej konfigurácii.

Skontrolovať inštaláciu

Tri príkazy

• openclaw --version
• openclaw doctor
• gateway status

Konfigurácia

models.providers

• baseUrl končí na /v1
• Nastaviť api na completions
• Zadajte aspoň id modelu

Vybrať

provider/model

• Použite túto referenciu pre primárny
• Uprednostnite premennú prostredia pre kľúč
• Použite zoznam brány ako zdroj pravdy

Overenie skutočnej úlohy

Prejdite do bežného adresára projektu a odošlite veľmi krátku správu. Nahraďte referenciu modelu v príkaze svojím úplným ID modelu:

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

--local spustí túto úlohu agenta lokálne, --model špecifikuje model, ktorý sa má použiť pre toto spustenie, a --timeout 300 nastaví maximálny čas čakania na 300 sekúnd.

Skutočná odpoveď modelu sa musí zobraziť v termináli. Dňa 9. 10. 2026 OpenClaw 2026.9.9 prijal odpoveď pomocou tohto príkazu. Prvé volanie môže trvať minútu alebo dve.

Ak sa zobrazí pôvodná chyba Request timed out before a response was generated , zvýšte --timeout a odošlite požiadavku znova. Zvyčajne to znamená, že čas čakania bol nedostatočný a nemusí to nevyhnutne znamenať, že adresa je nesprávna.

Po úspešnej krátkej odpovedi ho požiadajte o prečítanie lokálneho súboru, ktorý zadáte. Potom otvorte záznamy požiadaviek OmniProxy a potvrďte zdroj a ID modelu zobrazené v zázname. Výstup iba z príkazu verzie alebo doctor neznamená, že pripojenie k modelu bolo plne nakonfigurované.

Inštalácia

Príkaz odpovedá

• Číslo verzie sa zobrazí
• doctor nehlási žiadne blokátory
• Stav brány je čitateľný

Úloha

Dokončil malú úlohu

• Napríklad prečítajte lokálny súbor
• Odpoveď nie je chyba
• Referencia modelu je správna

Denníky (Logs)

Viditeľné v bráne

• Zdrojom je OpenClaw
• ID modelu sa zhoduje
• Kľúč nebol pridaný do úložiska

Bežné chyby

• Nemožno nájsť openclaw: Pridajte globálny adresár bin pre npm do PATH, potom znova otvorte terminál. Ak ste inštalovali do určeného adresára, spustite spustiteľný súbor z priečinka bin tohto adresára.
• node -v je pod 24.16: Nemusíte najprv odinštalovať starú verziu. Skontrolujte verziu Node pripravenú inštalačným skriptom alebo použite 24.16+ či 26.1+ podľa popisu na inštalačnej stránke. Odporúča sa Node 26.
• Model sa nezobrazuje: Model musí byť zahrnutý v poli models pod models.providers a musí mať aspoň rovnaké id. Nastavenie iba agents.defaults.models samo o sebe nezaregistruje nový model.
• Odpoveď 400 spomína rolu vývojára: Keď hostiteľ adresy nie je api.openai.com, ponechajte predvolené nastavenie a nenastavujte supportsDeveloperRole na true. Aj keď je nastavené na true, stále bude prepísané.
• Časový limit vyprší príliš rýchlo: Zvýšte --timeout na viac ako 300 sekúnd pred zmenou adresy.
• Volania nástrojov zlyhajú po výbere gpt-6-luna: Podporuje Chat Completions; volanie funkcií v Chat Completions je podporované iba vtedy, keď reasoning_effort je none. Ak sa ID v zozname líši od tohto, použite ID zobrazené v zozname.
• Adresa je nedostupná: Potvrďte, že OmniProxy beží, že baseUrl končí na /v1, a že adresa zapísaná do konfigurácie je prístupná. Ostatné adresy v súkromnej sieti musia byť povolené samostatne.
• Požiadavky stále smerujú na inú adresu po konfigurácii: Skontrolujte, či models.json tohto agenta obsahuje iný baseUrl.

Oficiálne referencie

Inštalačné kroky nájdete v OpenClaw install. Pre konfiguráciu vlastného poskytovateľa pozri Custom providers a configuration fields. Pre ID modelov použité v príkladoch porovnajte s Claude model overview a GPT-6 Luna.

Nahraďte každú zástupnú hodnotu hodnotami z vašej vlastnej konfigurácie OmniProxy. Nikdy nezverejňujte skutočný kľúč.

Uložený výsledok alebo HTTP 200 sám o sebe nepreukazuje plnú kompatibilitu Agentov. Skontrolujte zdroj a model v zázname volania OmniProxy.

Oficiálne zdroje · OpenClaw ↗