Instalace OpenClaw a konfigurace OmniProxy

OpenClaw je AI asistent nainstalovaný přímo ve vašem počítači. Můžete s ním komunikovat přes Telegram, Discord, WhatsApp nebo Feishu, aniž byste museli mít otevřené další okno chatu. Konverzace a záznamy zůstávají v tomto počítači a asistent může lokálně provádět následné kroky.

Než začnete

OpenClaw vyžaduje Node 24.16 nebo novější. Můžete použít i Node 26.1 nebo novější, přičemž doporučujeme verzi 26. Node poskytuje běhové prostředí, které OpenClaw potřebuje.

Lze jej nainstalovat na macOS, Linux a Windows. Pokud počítač nemá vhodnou verzi Node, instalační skript ji připraví automaticky: Node 26 na macOS a Node 24 LTS na Linuxu. pnpm je vyžadováno pouze při sestavování OpenClaw ze zdrojových kódů.

Pokud již máte nainstalovanou starší verzi Node, nemusíte ji nejprve odinstalovávat. Během testování dne 9. 10. 2026 byla systémová verze Node v tomto počítači 24.2.0, což je méně než požadovaných 24.16, a neinteraktivní instalační skript automaticky připravil verzi 24.21.0.

Chcete okno

Desktopový společník

• Použijte instalátor Hub ve Windows
• Použijte GitHub DMG na macOS
• Lokální Gateway lze nainstalovat během počátečního nastavení

Oficiálně doporučeno

Instalační skript

• macOS Linux WSL2
• Použijte PowerShell ve Windows
• Můžete přidat --no-onboard

Node již nainstalován

Správce balíčků

• npm pnpm nebo bun
• Poté spusťte onboard
• Verzi Node naleznete na stránce instalace

Instalace a první spuštění

Můžete nainstalovat desktopového společníka s grafickým oknem, nebo instalovat přímo přes terminál. Gateway je lokální služba zodpovědná za příjem zpráv, volání modelů a vracení výsledků. Můžete ji nastavit při prvním otevření desktopového společníka.

Pokud chcete okno

• Windows: Stáhněte a spusťte OpenClawCompanion-Setup-x64.exe nebo OpenClawCompanion-Setup-arm64.exe. Instalátor je podepsaný a obsahuje nastavení, stav v oznamovací oblasti, chat a režimy uzlů.
• macOS: Stáhněte OpenClaw .dmg z releasů OpenClaw na GitHubu. Preferujte dmg, i když můžete použít i .zip. Po instalaci otevřete OpenClaw.app. Pokud tato verze neobsahuje soubor pro macOS, postupujte podle stránky aplikace pro macOS.

Při prvním otevření můžete nechat OpenClaw připravit Gateway v tomto počítači, nebo se připojit k existující vzdálené Gateway.

Instalace přes terminál

Pro macOS, Linux a WSL2 použijte:

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

Pro Windows PowerShell použijte:

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

Skript detekuje aktuální systém, v případě potřeby nainstaluje Node, nainstaluje OpenClaw a poté spustí počáteční proces onboardingu. Proces onboardingu vás provede prvotním nastavením.

Pokud ještě nechcete spouštět onboarding, použijte na macOS, Linuxu a WSL2 místo toho:

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

Ve Windows použijte oficiální -NoOnboard možnost:

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

Pokud již Node spravujete sami, můžete použít také npm, pnpm nebo bun. S npm 12 nebo npm 11.16 a novějším spusťte:

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

Pro npm 11.15 a starší odstraňte --allow-scripts=openclaw. Při použití pnpm přidejte --allow-build=openclaw. Přesné rozdíly naleznete na stránce instalace.

Po instalaci spusťte tyto tři příkazy v pořadí:

openclaw --version
openclaw doctor
openclaw gateway status

openclaw --version zobrazí verzi, openclaw doctor zkontroluje běžné problémy s prostředím a openclaw gateway status zobrazí, zda Gateway běží. Základní instalace je dokončena pouze tehdy, když všechny tři příkazy poskytnou normální výstup.

Pokud terminál nahlásí, že nemůže najít openclaw, obvykle chybí globální binární adresář npm v proměnné PATH. PATH je seznam umístění, kde terminál hledá programy. Porovnejte výstup node -v, npm prefix -g, a echo "$PATH", přidejte odpovídající binární adresář do PATH a poté znovu otevřete terminál.

Pokud ~/.openclaw již obsahuje konfiguraci, která se právě používá, výchozí instalační skript použije tento adresář. Chcete-li nainstalovat samostatnou kopii bez změny stávající konfigurace, spusťte neinteraktivní skript a zadejte nový adresář:

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

--no-onboard je výchozí chování tohoto skriptu. Dne 9. 10. 2026 tento příkaz nainstaloval OpenClaw 2026.9.9. Po instalaci spusťte openclaw spustitelný soubor ze složky bin v daném adresáři.

Získání hodnot připojení z OmniProxy

Nejprve potvrďte, že OmniProxy běží, poté otevřete seznam modelů a připravte si následující tři 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 kterou OpenClaw odesílá požadavky na modely, a musí končit /v1. Při připojování k OmniProxy použijte openai-completions pro api. Změňte jej na openai-responses pouze v případě, že model skutečně funguje přes /v1/responses.

ID modelu je úplný identifikátor modelu v seznamu. Zkopírujte jej přesně tak, jak je zobrazen, včetně všech lomítek. Následující dva názvy jsou pouze reference z dokumentace poskytovatele k 9. 10. 2026; nepoužívejte je, pokud se v seznamu neobjevují: claude-sonnet-5-5, gpt-6-luna.

I když gateway klíč neověřuje, apiKey musí stále obsahovat hodnotu. Můžete použít zástupný řetězec, který se používá pouze v tomto počítači. Neukládejte skutečný klíč do repozitáře.

Zadání konfigurace nástroje

Poskytovatele (Provider) lze chápat jako sadu nastavení připojení, která OpenClaw používá k vyhledání modelové služby. Zde je poskytovatel pojmenován omniproxy.

Spusťte v terminálu následující příkaz a nahraďte adresu, klíč a dvě ID modelů svými 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 příkaz zapíše poskytovatele a seznam modelů do konfigurace. Po úspěšném provedení příkazu není třeba restartovat Gateway.

Dále určete výchozí model. Reference modelu se skládá z omniproxy/ následovaného ID modelu. Zachovejte všechna lomítka, která jsou již v ID obsažena. Pokud je ID v seznamu modelů delší než krátký název níže, použijte úplnou hodnotu ze seznamu:

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

reasoning, input, cost, contextWindow, a maxTokens lze vynechat. Pokud nejsou poskytnuty, textové modely jsou zpracovávány pomocí výchozích nastavení.

Stejná nastavení můžete také zapsat přímo do konfiguračního souboru. V hlavní konfiguraci se poskytovatel nachází pod models.providers. Každý agent může mít také své vlastní models.json; agent je instance asistenta, která skutečně přijímá úkoly a volá modely. Soubor se nachází v agent/models.json v rámci odpovídajícího adresáře agenta pod ~/.openclaw/agents/.

Pokud toto models.json obsahuje neprázdné baseUrl, přepíše adresu v hlavní konfiguraci.

Zkontrolovat instalaci

Tři příkazy

• openclaw --version
• openclaw doctor
• gateway status

Konfigurace

models.providers

• baseUrl končí /v1
• Nastavit api na completions
• Zadejte alespoň id modelu

Vybrat

provider/model

• Použijte tuto referenci pro primární
• Preferujte proměnnou prostředí pro klíč
• Použijte seznam gateway jako zdroj pravdy

Ověření skutečného úkolu

Přejděte do běžného adresáře projektu a odešlete velmi krátkou zprávu. V příkazu nahraďte referenci modelu svým úplným ID modelu:

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

--local spustí tento úkol agenta lokálně, --model určuje model, který se má pro toto spuštění použít, a --timeout 300 nastavuje maximální dobu čekání na 300 sekund.

V terminálu se musí objevit skutečná odpověď modelu. Dne 9. 10. 2026 obdržel OpenClaw 2026.9.9 odpověď pomocí tohoto příkazu. První volání může trvat minutu nebo dvě.

Pokud se objeví původní chyba Request timed out before a response was generated , zvyšte --timeout a odešlete požadavek znovu. To obvykle znamená, že doba čekání byla nedostatečná, a nemusí to nutně znamenat, že adresa je nesprávná.

Poté, co krátká odpověď proběhne úspěšně, požádejte asistenta o přečtení místního souboru, který určíte. Poté otevřete záznamy požadavků OmniProxy a potvrďte zdroj a ID modelu zobrazené v záznamu. Výstup pouze z příkazu verze nebo doctor neznamená, že připojení k modelu bylo plně nakonfigurováno.

Instalace

Příkaz odpovídá

• Číslo verze je zobrazeno
• doctor nehlásí žádné blokující problémy
• Stav Gateway je čitelný

Úkol

Dokončil malý úkol

• Například přečíst místní soubor
• Odpověď není chyba
• Reference modelu je správná

Logy

Viditelné v gateway

• Zdroj je OpenClaw
• ID modelu souhlasí
• Klíč nebyl přidán do repozitáře

Běžné chyby

• Nelze najít openclaw: Přidejte globální binární adresář npm do PATH a poté znovu otevřete terminál. Pokud jste instalovali do určeného adresáře, spusťte spustitelný soubor ze složky bin v daném adresáři.
• node -v je nižší než 24.16: Nemusíte nejprve odinstalovat starou verzi. Zkontrolujte verzi Node připravenou instalačním skriptem, nebo použijte 24.16+ či 26.1+ podle popisu na stránce instalace. Doporučuje se Node 26.
• Model se neobjevuje: Model musí být zahrnut v poli models pod models.providers a musí mít alespoň stejné id. Nastavení pouze agents.defaults.models samo o sobě nový model nezaregistruje.
• Odpověď 400 zmiňuje roli vývojáře: Pokud hostitel adresy není api.openai.com, ponechte výchozí nastavení a nenastavujte supportsDeveloperRole na true. I když je nastaveno na true, bude přepsáno.
• Časový limit vyprší příliš rychle: Zvyšte --timeout na více než 300 sekund před změnou adresy.
• Volání nástrojů selhávají po výběru gpt-6-luna: Podporuje Chat Completions; volání funkcí v Chat Completions je podporováno pouze tehdy, když reasoning_effort je none. Pokud se ID v seznamu liší od tohoto, použijte ID zobrazené v seznamu.
• Adresu nelze dosáhnout: Potvrďte, že OmniProxy běží, že baseUrl končí /v1, a že adresa zapsaná do konfigurace je přístupná. Ostatní adresy v soukromé síti musí být povoleny samostatně.
• Požadavky stále směřují na jinou adresu po konfiguraci: Zkontrolujte, zda models.json daného agenta obsahuje jiný baseUrl.

Oficiální reference

Pro kroky instalace viz OpenClaw install. Pro vlastní konfiguraci poskytovatele viz Custom providers a configuration fields. Pro ID modelů použitá v příkladech porovnejte s Claude model overview a GPT-6 Luna.

Nahraďte všechna záložní místa hodnotami z vlastní konfigurace OmniProxy. Nikdy nezveřejňujte skutečný klíč.

Uložený výsledek nebo HTTP 200 samo o sobě nedokazuje plnou kompatibilitu agenta. Zkontrolujte zdroj a model v záznamu požadavku OmniProxy.

Oficiální zdroje · OpenClaw ↗