OpenClaw nefunguje v botchatu? Tady je návod na diagnostiku krok za krokem

I když zatím neznáme přesnou příčinu, proč vám OpenClaw v botchatu nefunguje, cesta k nápravě je jasná. Dokumentace OpenClaw vyžaduje, abyste při potížích s kanálem, který se sice připojí, ale chová se nesprávně, provedli kroky v přesně daném pořadí. Následující návod vás provede celým procesem a upozorní na nejčastější problémy, zejména u platformy Telegram.

Diagnostický žebříček: Co musíte zkontrolovat jako první

Toto je základní sada příkazů, kterou dokumentace OpenClaw přikazuje spustit v uvedeném pořadí. Bez jejich výstupu se v řešení problému dál nepohnete:

1. openclaw status

2. openclaw gateway status

3. openclaw logs --follow

4. openclaw doctor

5. openclaw channels status --probe

Zdravý systém by měl hlásit:

Runtime: running

Connectivity probe: ok

audit ok

Pokud ani po provedení těchto kroků bot nereaguje, zaměřte se na následující specifické scénáře spojené s Telegramem, které jsou nejčastějším zdrojem potíží.

Telegram: 4 nejčastější důvody, proč bot nereaguje

Telegramový bot se může tvářit jako online, ale v soukromé zprávě nebo skupině mlčí. Zde je přehled nejtypičtějších problémů a jejich řešení, tak jak je uvádí oficiální dokumentace.

1. Bot je online, ale ve skupině neodpovídá

Nejpravděpodobnější příčinou je nastavení soukromí bota nebo požadavek na zmínění. Pokud chcete, aby bot viděl všechny zprávy ve skupině, musíte v nastavení u BotFather vypnout tzv. "privacy mode" (pomocí příkazu /setprivacy), nebo z bota udělat administrátora skupiny. Důležité: Po změně nastavení musíte bota ze skupiny odebrat a znovu přidat, aby Telegram změny aplikoval.

2. Při spuštění se objeví chyba

getMe returned 401

Tato chyba znamená jediné: token, který jste získali od BotFather, je nesprávný nebo vypršela jeho platnost. Zkontrolujte a aktualizujte hodnotu botToken, cestu k tokenFile nebo proměnnou prostředí TELEGRAM_BOT_TOKEN pro výchozí účet.

3. Zprávy se neodesílají a logy ukazují síťovou chybu

Pokud se bot potýká s odesíláním zpráv, dokumentace doporučuje zkontrolovat logy Telegram API a vaši síťovou konfiguraci. Problém často spočívá ve špatně nastaveném DNS, IPv6 nebo proxy serveru pro připojení k api.telegram.org.

4. V logu se opakuje konflikt getUpdates 409

Tato chyba jasně signalizuje, že se stejný token pokouší použít více procesů najednou. Může jít o jinou spuštěnou bránu (gateway) OpenClaw, externí skript nebo jiný poller. Dokumentace zdůrazňuje, že v jednu chvíli smí pro jeden bot token aktivně běžet pouze jeden proces.

Co dělat, když bot přestal fungovat po aktualizaci

Pokud problémy nastaly ihned po aktualizaci OpenClaw, dokumentace radí tento tříkrokový reset:

1. Spusťte

   openclaw status --all

   a zkontrolujte celkový stav.
2. Spusťte

   openclaw doctor --fix

   , který vyčistí zastaralé dočasné a ověřovací soubory.
3. Restartujte bránu pomocí

   openclaw gateway restart

   .

Poté znovu ověřte stav pomocí

openclaw status --all

plugin load failed: dependency tree corrupted

openclaw doctor --fix

Jak by mělo vypadat správné nastavení Telegramu

Pro jistotu si zopakujme, jak se telegramový kanál v OpenClaw aktivuje. Nepoužívá se k tomu příkaz

openclaw channels login telegram

channels.telegram.enabled: true

openclaw pairing list telegram

Závěrečné shrnutí

Na základě dostupných informací nelze s jistotou říci, že "bot nefunguje kvůli X". Chybí pro to důkazy. Řešením je však systematický postup. Začněte s žebříčkem pěti diagnostických příkazů. Pokud z něj nezískáte odpověď, u Telegramu zkontrolujte výše zmíněné čtyři nejpravděpodobnější příčiny: nastavení soukromí/zmiňování, platnost tokenu, síťovou konfiguraci a konflikty pollingu.