OpenClaw zamrzl v chatu? Tady je kompletní návod na opravu

Jak vypadá zdravý stav

Abyste věděli, co hledat, zde je výstup, který byste měli vidět u bezproblémové instance:

• openclaw gateway status

  musí ukazovat

  Runtime: running

  a

  Connectivity probe: ok

  .

• openclaw channels status --probe

  by měl hlásit, že transport je připojený (connected), a pokud je podporováno, works nebo

  audit ok

  .

• openclaw status

  by neměl obsahovat žádné zjevné chyby v autentizaci (

  auth error

  ) nebo konfiguraci (

  config error

  ).

Řešení konkrétních problémů

Problém nastal po aktualizaci

Pokud chatbot přestal fungovat hned po aktualizaci, je to častý příznak poškozených závislostí. Oficiální postup je:

1. Spusťte

   openclaw status --all

   .
2. Hledejte chybu

   plugin load failed: dependency tree corrupted

   .
3. Spusťte opravný příkaz:

   openclaw doctor --fix

   .
4. Restartujte bránu:

   openclaw gateway restart

   .
5. Ověřte stav pomocí

   openclaw status --all

   .

Příkaz

doctor --fix

auth shadows

Problém je specifický pro Telegram

Pokud používáte Telegram bota, může být problém skrytý v jedné z těchto oblastí:

• Bot je online, ale nereaguje na zprávy: Zkontrolujte párování příkazem

  openclaw pairing list telegram

  .
• Bot ve skupině mlčí: Ověřte v nastavení skupiny, zda bot nevyžaduje zmínku (

  mention requirement

  ) a zda nemá zapnutý soukromý režim (

  privacy mode

  ).
• Chyby v logu související se sítí: Problém bude pravděpodobně v DNS, IPv6 nebo nastavení proxy. Upravte síťovou konfiguraci.
• Při startu se objeví chyba

  getMe returned 401

  : Váš token pro Telegram bota je neplatný. Získejte nový token od BotFather a aktualizujte ho v konfiguraci (v botToken, tokenFile nebo proměnné TELEGRAM_BOT_TOKEN).
• Bot přestane reagovat kvůli pomalému znovupřipojování: Problém opět často směřuje na síťové nastavení, proxy nebo DNS. Sledujte logy přes

  openclaw logs --follow

  pro detailní chyby.

Problém je v samotné bráně (gateway)

• OpenClaw odkazuje na starou verzi: Ujistěte se, že vaše systémová proměnná PATH ukazuje na adresář s novější instalací OpenClaw.
• Služba brány je poškozená: Oficiální dokumentace doporučuje přeinstalovat službu brány zamýšlenou verzí.

  Reinstall the intended gateway service from the newer install.

• Odstraňte staré obaly (wrappers): Zbavte se zastaralých systémových balíčků nebo starých položek, které stále ukazují na starý binární soubor openclaw.

Rychlá diagnostika podle symptomů

• Brána neběží / sonda selhává → Zaměřte se na bránu, službu a proměnnou PATH.
• Brána běží, ale chatbot neodpovídá → Prověřte tok kanálu, párování, nastavení soukromí, token a síťové připojení k Telegram API.
• Zamrzlo to po aktualizaci → Prioritou je

  openclaw doctor --fix

  a restart brány.
• Logy se plní opakujícími se fatálními chybami → Ukazuje to na poškozenou konfiguraci nebo plugin, nejde o dočasný výpadek.

Alternativní a pokročilá řešení

Pokud výše uvedené rady nepomohou, komunita nabízí další kreativní postupy. Uživatelé na YouTube ukazují, jak nahrát celou dokumentaci OpenClaw do projektu Claude a využít AI k diagnostice a opravě chyb ve vaší konfiguraci. To podle nich řeší až 99 % problémů s nastavením. Jiný přístup radí použít Claude Code tak, že mu ukážete svou složku s OpenClaw, vložíte FAQ dokumentaci a popíšete problém — nástroj pak sám najde a opraví chybu.

Závěr

Přestaňte hádat. S OpenClaw je správný postup vždy stejný: spustit základní diagnostické příkazy a poté se zaměřit na konkrétní větev — ať už je to brána, nebo kanál jako Telegram. Spusťte příkazy uvedené v sekci „První pomoc“ a podívejte se na výstup. Prvních 20–30 řádků z

openclaw gateway status

openclaw channels status --probe

openclaw logs --follow