OpenClaw: co to je, jak ho nainstalovat a propojit s Telegramem

OpenClaw se mi objevil ve feedu minulou zimu, když projekt během týdne dvakrát změnil název a získal na GitHubu stovky tisíc hvězdiček. Od té doby lidé stále častěji hledají „instalace OpenClaw“ a „OpenClaw Telegram“.

Níže procházím oficiální dokumentaci: co tenhle nástroj je, jak se liší od Claude Code, jak ho nainstalovat ve Windows, macOS nebo Linuxu, jak vybrat model a jak připojit telegramového bota. Zvlášť se věnuji také bezpečnosti, protože OpenClaw se zapletl do několika mediálně sledovaných incidentů.

Naučte se se službou pracovat v dokumentaci Ailoot.

Co je OpenClaw srozumitelně?#

OpenClaw připojuje model AI k vašemu botovi v Telegramu. Po nastavení příslušných nástrojů a oprávnění může shrnovat zprávy nebo naplánovat připomínku. Proces brány a jeho místní konfigurace běží na vašem počítači či serveru. To neznamená, že je každá konverzace místní: při výběru cloudového modelu se požadavek a relevantní kontext konverzace posílají jeho poskytovateli. Při připojení přes Ailoot jde požadavek přes Ailoot k poskytovateli vybraného modelu. Místní inference vyžaduje místní model bez záložního přechodu do cloudu; zprávy Telegramu stále procházejí Telegramem a zapnuté nástroje mohou kontaktovat další služby.

Projekt vyvíjí open-source komunita OpenClaw. Repozitář na GitHubu vznikl 24. listopadu 2025 a k 22. srpnu 2026 má 387 tisíc hvězdiček a 81 tisíc forků — patří k nejrychleji rostoucím otevřeným projektům roku. Je napsaný v TypeScriptu.

Projekt má pozoruhodnou historii názvů, kterou stojí za to znát, abyste se neztratili ve starších článcích. Začal jako Warelay, brána pro WhatsApp. Potom se jmenoval Clawdbot. V lednu 2026 požádala společnost Anthropic o změnu názvu kvůli ochranné známce a projekt se na několik dní jmenoval Moltbot. Dne 30. ledna 2026 dostal svůj konečný název: OpenClaw. Pokud tedy narazíte na pokyny pro „Clawdbot“ nebo „Moltbot“, jde o tentýž projekt; ty články vznikly před přejmenováním.

Maskotem projektu je humr Molty a „svlékání krunýře“ se stalo oficiální metaforou pro každé přejmenování.

Jak se OpenClaw liší od Claude Code a Hermes Agent?#

Na tento rozdíl se mě lidé ptají pořád, protože zvenčí všechny vypadají jako „AI agenti“. Tady je srovnávací tabulka:

Jak tabulku číst. Claude Code používám při vývoji: je nejsilnější, když potřebujete výkonný model a pracujete s kódem. OpenClaw a Hermes slouží k něčemu jinému: jde o agenta, který běží pořád, tráví čas v Telegramu, pamatuje si včerejší konverzaci a plní úkoly podle plánu. Rozdíl mezi OpenClaw a Hermes je jemnější; už máme průvodce Hermesem s instalací a nastavením.

Pokud si jen vybíráte nástroj, začněte přehledem: s čím lidé programují v roce 2026 a které úkoly svěřit AI agentovi. Také mám samostatný článek o instalaci Claude Code.

Co potřebujete před instalací OpenClaw?#

Verzi Node si předem ověřte — je to jediný přísný požadavek:

node --version

Podporované jsou verze 22.22.3+, 24.15+ a 25.9+; doporučená je Node 26. Pokud příkaz vrátí „command not found“ nebo je verze zastaralá, nemusíte si dělat starosti: oficiální instalátor za vás stáhne aktuální verzi Node, takže nemusíte nic instalovat ručně.

Zbývá otázka modelu. OpenClaw sám nepřemýšlí: volá model, který si zvolíte. Tady jsou možnosti, co se týče ceny: klíč Anthropic, OpenAI nebo Google — poskytovateli platíte za skutečné použití; anebo lokální model přes Ollama — bez finančních nákladů, ale náročný na hardware. Obě možnosti proberu níže v samostatných částech.

Jak nainstalovat OpenClaw v macOS a Linuxu?#

Doporučená cesta vede přes oficiální instalátor:

1. Spusťte instalátor

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

   Skript rozpozná váš operační systém, zkontroluje Node (a v případě potřeby ho nainstaluje), nainstaluje OpenClaw a potom otevře průvodce nastavením. Pokud se chcete před spuštěním průvodce nejprve porozhlédnout, přidejte příznak: bash -s -- --no-onboard.

2. Ověřte, že se vše nainstalovalo

   openclaw --version
   openclaw doctor
   openclaw gateway status
   

   První příkaz zobrazí verzi, druhý zkontroluje konfiguraci a třetí potvrdí, že brána běží a naslouchá na portu 18789.

Pokud používáte npm a chcete instalaci spravovat sami:

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

Nedávno se tu objevil problém, kterému se věnuje samostatná kapitola dokumentace. npm 12 ve výchozím nastavení blokuje instalační skripty balíčků a bez příznaku --allow-scripts=openclaw se instalace zastaví se zprávou allowScripts. V npm 11.15 a starších verzích příznak není potřeba — toto omezení tam ještě není. Svou verzi zjistíte příkazem: npm --version.

Příznak --install-daemon ve druhém příkazu nastaví automatické spouštění: v macOS jde o LaunchAgent, v Linuxu o službu systemd. Brána se spustí po restartu nebo přihlášení podle podmínek správce služeb. Nezabraňuje to uspání ani neudrží bránu při vypnutém počítači. Odpovědi na Telegramu vyžadují bdělého hostitele se síťovým připojením; potřebujete-li odpovědi při uspaném nebo vypnutém notebooku, použijte stále zapnutý server.

Jak nainstalovat OpenClaw ve Windows?#

První možnost je pro ty, kdo dávají přednost oknům před terminálem. Windows Hub je nativní aplikace OpenClaw pro Windows 10 (20H2+) a Windows 11, momentálně v beta verzi. Přejděte na stránku vydání Windows Hubu a stáhněte instalátor pro svůj procesor: OpenClawCompanion-Setup-x64.exe pro běžné počítače, nebo verzi arm64 pro ARM. Po instalaci se v nabídce Start objeví OpenClaw Companion s ikonou na systémové liště, oknem chatu a nastavením.

Při prvním spuštění aplikace nabídne „Set up locally“ — tuto možnost potvrďte. Vytvoří vyhrazené prostředí WSL s názvem OpenClawGateway, nainstaluje do něj bránu a připojí se k ní. Nedotkne se vaší stávající instalace Ubuntu, pokud nějakou máte.

Druhá možnost je přes PowerShell:

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

První řádek nainstaluje OpenClaw; druhý zaregistruje automatické spouštění prostřednictvím Plánovače úloh systému Windows. Pokud zásady vašeho počítače blokují vytváření úloh, OpenClaw sám přejde na záložní možnost: zástupce ve složce Po spuštění, takže se brána spustí při přihlášení.

Třetí možnost je WSL2, které dokumentace označuje za nejkompatibilnější běhové prostředí ve Windows. Nainstalujte Ubuntu, povolte systemd a potom postupujte podle pokynů pro Linux z předchozí části:

wsl --install -d Ubuntu-24.04

Ve WSL povolte systemd v souboru /etc/wsl.conf (v části [boot], na řádku systemd=true), restartujte WSL spuštěním příkazu wsl --shutdown v PowerShellu a potom nainstalujte OpenClaw linuxovým příkazem. Pokud vám pojmy „distribuce“ a „systemd“ nic neříkají, použijte Windows Hub; udělá to všechno za vás.

Jak vybrat model a dokončit úvodní nastavení?#

Model je motor asistenta. Průvodce nastavením nabídne seznam poskytovatelů; zde jsou tři praktické možnosti:

Anthropic má příjemnou vychytávku: pokud už máte na počítači nainstalovaný Claude Code a jste přihlášení, OpenClaw může použít toto přihlášení. Nejprve na počítači spusťte claude auth login a potom OpenClaw řekněte, aby ho použil:

openclaw models auth login --provider anthropic --method cli --set-default

Pokud brána běží jako služba na pozadí (což je případ použití --install-daemon), klíč musí být dostupný této službě. Vložte ho do souboru ~/.openclaw/.env — průvodce to udělá za vás, takže soubor nemusíte upravovat ručně. Po jakýchkoli změnách restartujte a ověřte stav:

openclaw gateway restart
openclaw models status

Pokud je pro vás placení obtížné, řešením je lokální model z části o Ollama.

Jak propojit OpenClaw s Telegramem?#

Telegram je nejrychlejší kanál k připojení: potřebujete jen token bota, bez ověřování firemního účtu. Dokumentace ho označuje za nejsnazší způsob, jak začít komunikovat s asistentem z telefonu. Tady je celý postup:

1. Vytvořte bota pomocí BotFather

   Otevřete chat v Telegramu s @BotFather (ujistěte se, že jde přesně o toto uživatelské jméno — existuje spousta podvodných účtů), pošlete /newbot a zvolte jméno a uživatelské jméno končící na bot. V odpovědi dostanete token ve tvaru 123456789:ABCdef... — je to klíč k vašemu botovi, proto s ním zacházejte jako s heslem.

2. Zadejte token do OpenClaw

   Nejjednodušší je použít průvodce: spusťte openclaw configure a vyberte kanál Telegram. Ruční alternativou je nastavení channels.telegram.botToken nebo proměnná prostředí TELEGRAM_BOT_TOKEN. Dokumentace výslovně uvádí, že příkaz openclaw channels login telegram neexistuje; Telegram se připojuje pouze prostřednictvím tokenu.

3. Spusťte bránu a napište botovi

   openclaw gateway
   

   Otevřete svého bota v Telegramu a něco mu pošlete. Odpoví osmiznakovým párovacím kódem. Jde o bezpečnostní opatření: zprávy se nebudou zpracovávat, dokud neschválíte odesílatele.

4. Schvalte sami sebe

   openclaw pairing list telegram
   openclaw pairing approve telegram CODE
   

   Kód platí jednu hodinu, proto příliš dlouho nečekejte. První schválený odesílatel se automaticky stane vlastníkem privilegovaných příkazů.

Jsou tu dva zapeklité body, na které lidé často narazí.

Prvním jsou skupiny. OpenClaw ve výchozím nastavení blokuje všechny skupiny: musíte bota výslovně povolit v nastavení channels.telegram.groups a ve skupině nechat zapnutý režim requireMention: true. Pak odpoví jen tehdy, když ho někdo osloví uživatelským jménem, a nebude se vměšovat do obecné konverzace. Telegram má také vlastní režim soukromí botů: ve skupině bot ve výchozím nastavení vidí jen příkazy. Vypněte ho pomocí /setprivacy přes @BotFather. Po změně musíte bota ze skupiny odebrat a znovu ho přidat; jinak Telegram nastavení nepoužije.

Druhým bodem je neotevírat přístup všem. Nastavení obsahují režim dmPolicy: "open" s hvězdičkou v seznamu přístupů: botovi může dávat příkazy kdokoli, kdo ho najde podle uživatelského jména. U osobního asistenta to přímo otevírá cestu k tomu, aby někdo jiný ovládal váš počítač. Nechte zapnuté párování pomocí kódu nebo zadejte své číselné ID do allowFrom.

Jak spustit OpenClaw s lokálním modelem přes Ollama?#

Tato možnost ponechává inferenci modelu na vašem hardwaru, pokud vyberete výhradně místní cestu bez záložního přechodu do cloudu; nepotřebuje placený endpoint modelu. Celý postup s Telegramem tím není místní: zprávy stále procházejí Telegramem a zapnuté online nástroje mohou posílat data dalším službám.

1. Nainstalujte Ollama

   Stáhněte instalátor z ollama.com/download — jsou tam verze pro macOS, Windows a Linux.

2. Stáhněte model

   ollama pull gemma4
   

3. Propojte Ollama s OpenClaw

   openclaw onboard
   

   Vyberte poskytovatele Ollama a režim: Local only (jen vaše vlastní modely), Cloud only (modely z ollama.com) nebo Cloud + Local. Průvodce vyhledá lokální server a zobrazí nainstalované modely.

4. Ověřte nastavení

   openclaw models list --provider ollama
   

Zde je otevřená výhrada, bez které by tato část zněla jako reklama. Dokumentace OpenClaw přímo uvádí, že pohodlné používání agenta s lokálním modelem vyžaduje hardware na úrovni dvou plně vybavených Maců Studio, zatímco grafická karta s pamětí 24 GB zvládne jen nenáročné požadavky, a to se zpožděním. Malé a silně komprimované modely zkracují kontext a hůře odolávají škodlivým pokynům ukrytým v cizím textu. Prakticky řečeno: lokální model na dobrém notebooku stačí k tomu, abyste si ho „vyzkoušeli a pochopili, o co jde“, ale cloudový model je pro každodenní práci s asistentem využívajícím nástroje stále mnohem spolehlivější.

Ještě jedno varování z dokumentace pro každého, kdo sestavuje kombinaci WSL2 + Ollama + GPU NVIDIA: oficiální linuxový instalátor Ollama povoluje automatické spouštění služby s politikou restartů „always“ a na WSL2 s GPU to může uvést počítač do smyčky restartů. Řešením je vypnout automatické spouštění služby. Pokud na to narazíte, podívejte se do části pro řešení potíží na stránce Ollama v dokumentaci.

Jak bezpečné je spouštět OpenClaw?#

Začnu hlavním bodem, kterému ne každý rozumí. OpenClaw má přístup k vašemu počítači: k souborům, příkazům i prohlížeči. Dokumentace to říká přímo: projekt je navržen pro jednoho důvěryhodného uživatele a přístup k botovi byste neměli poskytovat cizím lidem. Pokud někdo může psát vašemu agentovi, může ho využít k ovládání vašeho počítače.

Praktické minimum:

1. Nechte zapnuté párování pomocí kódu nebo použijte seznam povolených přístupů — o nastavení jsem psal v části o Telegramu.
2. Nevystavujte bránu internetu, pokud to nepotřebujete. Ve výchozím nastavení naslouchá pouze na vašem zařízení; nechte to tak.
3. Po každé změně konfigurace spusťte vestavěnou kontrolu:

openclaw security audit

Kontroluje otevřený přístup, příliš široká oprávnění nástrojů, slabé tokeny a vystavené porty. Některé nálezy lze automaticky opravit příznakem --fix.

Samostatná poznámka ke podvodům — a tohle není teorie. Když projekt v lednu 2026 v panice měnil svůj název, spekulanti během několika sekund obsadili staré adresy a okamžitě zveřejnili adresu kryptopeněženky; falešní „vývojáři OpenClaw“ začali propagovat podvodný token. Z toho plynou dvě pevná pravidla. OpenClaw stahujte pouze z openclaw.ai nebo github.com/openclaw/openclaw. A projekt nemá vlastní kryptoměnu: jakýkoli „token OpenClaw“ je podvod. Za žádných okolností na něj neposílejte peníze.

Co umí OpenClaw po instalaci?#

Tady je, co bych vyzkoušel v tomto pořadí:

1. Brána a model. Spusťte openclaw gateway status a pak otevřete openclaw dashboard. Načtený panel potvrzuje dostupnost Control UI. V jeho chatu odešlete „Odpověz: test připojení modelu“ a ověřte, že přijde odpověď AI; samotné načtení stránky model netestuje.
2. Telegram a zamýšlený úkol. Po nastavení bota a schválení vlastního párování pošlete novou zprávu tomuto botovi v Telegramu a zkontrolujte, zda tam dorazí odpověď. Pak vyzkoušejte jeden omezený úkol s viditelným výsledkem, například shrnutí neškodné testovací složky, kterou jste mu povolili číst. U připomínky zvlášť ověřte uložený plán a její doručení. Odpověď v panelu nedokládá doručení do Telegramu ani provedení naplánovaného úkolu.
3. Plánované úlohy. Asistent může spouštět úlohy podle plánu — ranní souhrn v Telegramu, pravidelné kontroly e-mailu. Proto necháváte bránu běžet nepřetržitě.
4. Paměť. OpenClaw ukládá dlouhodobou paměť do běžných souborů Markdown ve své pracovní složce: kdo jste, jak vám má odpovídat a co si zapamatoval z dřívějších konverzací. Soubory můžete sami otevřít a přečíst — žádná černá skříňka.
5. Dovednosti. Dovednosti a zásuvné moduly třetích stran mohou obsahovat cizí kód, proto je před použitím pečlivě prověřte.

Platí tu jedno pravidlo: nezapínejte všechno najednou. Začněte jednou stabilní konverzací, potom přidejte Telegram a nakonec plánované úlohy. Díky tomu se každá chyba projeví ve svém kroku, místo aby se z toho stalo „všechno se rozbilo a já nevím kde“.

Co dělat, když se instalace nepovede?#

Projděme si tři časté situace.

Ihned po instalaci se zobrazí „openclaw: command not found“. Téměř vždy jde o problém s cestou: složka globálních balíčků npm není v proměnné PATH vašeho terminálu. Dokumentace doporučuje tyto diagnostické příkazy:

node -v
npm prefix -g
echo "$PATH"

Cesta z druhého příkazu by se měla objevit ve třetím. Pokud tam není, přidejte ji do nastavení shellu nebo terminál jednoduše zavřete a znovu otevřete: někdy se cesta k Node objeví až v nové relaci po instalaci.

Brána běží, ale asistent mlčí. Příznak popsaný v častých dotazech dokumentace: na první zprávu nepřijde odpověď a počítadlo tokenů ukazuje nulu. To znamená, že agent se vůbec nespustil — nejčastěji není nakonfigurovaný model. Kontrolujte v tomto pořadí:

openclaw gateway restart
openclaw status
openclaw models status

Pokud je model nakonfigurovaný a odpověď stále nepřichází, příkaz openclaw logs --follow zobrazí živý protokol a místo, kde se proces zasekává.

Telegramový bot neodpovídá. Kontrolujte v tomto pořadí: token patří botovi, kterému píšete; brána běží (openclaw gateway status); a vaše párování bylo schváleno (openclaw pairing list telegram). Párovací kód platí jednu hodinu — pokud jste botovi psali včera, napište mu znovu a schvalte nový kód.

Když si vůbec nevíte rady, dokumentace navrhuje něco nečekaného, ale rozumného: předejte diagnostiku lokálnímu AI agentovi, který vidí váš počítač. Claude Code nebo Codex dokážou z výstupu příkazů openclaw status --all a openclaw doctor pochopit konfiguraci rychleji než podpora v chatu. Celý kruh se uzavírá — AI opravuje AI.

Na co dalšího se lidé ptají ohledně OpenClaw?#

Poznejte Ailoot.