openclaw status
openclaw status --all
openclaw gateway probe
openclaw gateway status
openclaw doctor
openclaw channels status --probe
openclaw logs --follow

Pokud chcete začít ještě rychleji, stačí vám pro začátek těchto pět klíčových příkazů:

openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe

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 je přesně určen k odstranění zastaralých dočasných souborů pluginů a poškozených autentizačních stínů (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 a openclaw logs --follow vám téměř vždy přesně odhalí, kde je zakopaný pes — ať už v párování, nastavení soukromí, tokenu, nebo samotné bráně.

openclaw status
openclaw status --all
openclaw gateway probe
openclaw gateway status
openclaw doctor
openclaw channels status --probe
openclaw logs --follow

Pokud chcete začít ještě rychleji, stačí vám pro začátek těchto pět klíčových příkazů:

openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe

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 je přesně určen k odstranění zastaralých dočasných souborů pluginů a poškozených autentizačních stínů (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 a openclaw logs --follow vám téměř vždy přesně odhalí, kde je zakopaný pes — ať už v párování, nastavení soukromí, tokenu, nebo samotné bráně.