Rozwiązywanie problemów

Ta strona to szczegółowy runbook. Zacznij od /help/troubleshooting, jeśli najpierw chcesz skorzystać z szybkiego przepływu triage.

Drabina poleceń

Najpierw uruchom je w tej kolejności:

openclaw statusopenclaw gateway statusopenclaw logs --followopenclaw doctoropenclaw channels status --probe

Oczekiwane sygnały prawidłowego działania:

• openclaw gateway status pokazuje Runtime: running, Connectivity probe: ok oraz wiersz Capability: ....
• openclaw doctor nie zgłasza blokujących problemów z konfiguracją ani usługą.
• openclaw channels status --probe pokazuje bieżący status transportu dla każdego konta oraz, tam gdzie jest to obsługiwane, wyniki sondowania/audytu, takie jak works lub audit ok.

Po aktualizacji

Użyj tego, gdy aktualizacja się zakończy, ale Gateway nie działa, kanały są puste albo wywołania modeli zaczynają kończyć się błędami 401.

openclaw status --allopenclaw update status --jsonopenclaw gateway status --deepopenclaw doctor --fixopenclaw gateway restart

Sprawdź:

• Update restart w openclaw status / openclaw status --all. Oczekujące lub nieudane przekazania zawierają następne polecenie do uruchomienia.
• plugin load failed: dependency tree corrupted; run openclaw doctor --fix w sekcji Channels. Oznacza to, że konfiguracja kanału nadal istnieje, ale rejestracja pluginu nie powiodła się, zanim kanał mógł zostać załadowany.
• błędy 401 dostawcy po ponownym uwierzytelnieniu. openclaw doctor --fix sprawdza przestarzałe cienie uwierzytelnienia OAuth poszczególnych agentów i usuwa stare kopie, aby wszyscy agenci rozwiązywali bieżący współdzielony profil.

Instalacje split brain i strażnik nowszej konfiguracji

Użyj tego, gdy usługa Gateway niespodziewanie zatrzymuje się po aktualizacji albo logi pokazują, że jeden plik binarny openclaw jest starszy niż wersja, która ostatnio zapisała openclaw.json.

OpenClaw oznacza zapisy konfiguracji polem meta.lastTouchedVersion. Polecenia tylko do odczytu nadal mogą sprawdzić konfigurację zapisaną przez nowszy OpenClaw, ale mutacje procesów i usług odmawiają kontynuowania ze starszego pliku binarnego. Blokowane działania obejmują uruchomienie, zatrzymanie, restart, odinstalowanie usługi Gateway, wymuszoną ponowną instalację usługi, uruchomienie Gateway w trybie usługi oraz czyszczenie portu przez gateway --force.

which openclawopenclaw --versionopenclaw gateway status --deepopenclaw config get meta.lastTouchedVersion

openclaw gateway install --forceopenclaw gateway restart

Niezgodność protokołu po rollbacku

Użyj tego, gdy logi nadal wypisują protocol mismatch po obniżeniu wersji lub wycofaniu OpenClaw. Oznacza to, że działa starszy Gateway, ale nowszy lokalny proces klienta nadal próbuje ponownie połączyć się z zakresem protokołu, którego starszy Gateway nie obsługuje.

openclaw --versionwhich -a openclawopenclaw gateway status --deepopenclaw doctor --deepopenclaw logs --follow

Sprawdź:

• protocol mismatch ... client=... v<version> min=<n> max=<n> expected=<n> w logach Gateway.
• Established clients: w openclaw gateway status --deep lub Gateway clients w openclaw doctor --deep. To pokazuje aktywne klienty TCP połączone z portem Gateway, w tym PID-y i wiersze poleceń, gdy system operacyjny na to pozwala.
• Proces klienta, którego wiersz poleceń wskazuje nowszą instalację OpenClaw lub wrapper, z którego wykonano rollback.

Naprawa:

1. Zatrzymaj lub zrestartuj przestarzały proces klienta OpenClaw pokazany przez gateway status --deep.
2. Zrestartuj aplikacje lub wrappery osadzające OpenClaw, takie jak lokalne dashboardy, edytory, pomocniki serwera aplikacji albo długo działające powłoki openclaw logs --follow.
3. Uruchom ponownie openclaw gateway status --deep lub openclaw doctor --deep i potwierdź, że przestarzały PID klienta zniknął.

Nie sprawiaj, aby starszy Gateway akceptował nowszy niezgodny protokół. Podbicia protokołu chronią kontrakt przewodowy; odzyskiwanie po rollbacku jest problemem czyszczenia procesu/wersji.

Pominięto symlink Skill jako wyjście poza ścieżkę

Użyj tego, gdy logi zawierają:

Skipping escaped skill path outside its configured root: ... reason=symlink-escape

OpenClaw traktuje każdy katalog główny skill jako granicę izolacji. Symlink w ~/.agents/skills, <workspace>/.agents/skills, <workspace>/skills lub ~/.openclaw/skills jest pomijany, gdy jego rzeczywisty cel rozwiązuje się poza tym katalogiem głównym, chyba że cel jest jawnie zaufany.

Sprawdź link:

ls -l ~/.agents/skills/<name>realpath ~/.agents/skills/<name>openclaw config get skills.load

Jeśli cel jest zamierzony, skonfiguruj zarówno bezpośredni katalog główny skill, jak i dozwolony cel symlinku:

{  skills: {    load: {      extraDirs: ["~/Projects/manager/skills"],      allowSymlinkTargets: ["~/Projects/manager/skills"],    },  },}

Następnie uruchom nową sesję albo poczekaj, aż watcher Skills się odświeży. Zrestartuj Gateway, jeśli działający proces poprzedza zmianę konfiguracji.

Nie używaj szerokich celów, takich jak ~, / albo cały synchronizowany folder projektu. Ogranicz allowSymlinkTargets do rzeczywistego katalogu głównego skill, który zawiera zaufane katalogi SKILL.md.

Jeśli Skill Workshop apply ma także zapisywać przez te zaufane symlinkowane ścieżki skill w workspace, włącz skills.workshop.allowSymlinkTargetWrites. Pozostaw to wyłączone dla współdzielonych katalogów głównych skill tylko do odczytu.

Powiązane:

• Konfiguracja Skills
• Przykłady konfiguracji

Anthropic 429: wymagane dodatkowe użycie dla długiego kontekstu

Użyj tego, gdy logi/błędy zawierają: HTTP 429: rate_limit_error: Extra usage is required for long context requests.

openclaw logs --followopenclaw models statusopenclaw config get agents.defaults.models

Sprawdź:

• Wybrany model Anthropic to model 1M Claude 4.x zdolny do GA albo model ma starsze params.context1m: true.
• Bieżące poświadczenie Anthropic nie kwalifikuje się do użycia długiego kontekstu.
• Żądania nie udają się tylko w długich sesjach/uruchomieniach modeli, które wymagają ścieżki kontekstu 1M.

Opcje naprawy:

Powiązane:

• Anthropic
• Użycie tokenów i koszty
• Dlaczego widzę HTTP 429 z Anthropic?

Odpowiedzi blokowane przez upstream 403

Użyj tego, gdy nadrzędny dostawca LLM zwraca ogólny 403, taki jak Your request was blocked.

Nie zakładaj, że zawsze jest to problem konfiguracji OpenClaw. Odpowiedź może pochodzić z nadrzędnej warstwy bezpieczeństwa, takiej jak CDN, WAF, reguła zarządzania botami lub reverse proxy przed endpointem zgodnym z OpenAI.

openclaw statusopenclaw gateway statusopenclaw logs --follow

Sprawdź:

• wiele modeli u tego samego dostawcy zawodzi w ten sam sposób
• HTML albo ogólny tekst bezpieczeństwa zamiast normalnego błędu API dostawcy
• zdarzenia bezpieczeństwa po stronie dostawcy dla tego samego czasu żądania
• mała bezpośrednia sonda curl udaje się, gdy normalne żądania w kształcie SDK zawodzą

Najpierw napraw filtrowanie po stronie dostawcy, gdy dowody wskazują na blokadę WAF/CDN. Preferuj wąsko ograniczoną regułę zezwolenia lub pominięcia dla ścieżki API używanej przez OpenClaw i unikaj wyłączania ochrony dla całej witryny.

Powiązane:

• Endpointy zgodne z OpenAI
• Konfiguracja dostawcy
• Logi

Lokalny backend zgodny z OpenAI przechodzi bezpośrednie sondy, ale uruchomienia agenta zawodzą

Użyj tego, gdy:

• curl ... /v1/models działa
• małe bezpośrednie wywołania /v1/chat/completions działają
• uruchomienia modeli OpenClaw zawodzą tylko przy normalnych turach agenta

curl http://127.0.0.1:1234/v1/modelscurl http://127.0.0.1:1234/v1/chat/completions \  -H 'content-type: application/json' \  -d '{"model":"<id>","messages":[{"role":"user","content":"hi"}],"stream":false}'openclaw infer model run --model <provider/model> --prompt "hi" --jsonopenclaw logs --follow

Sprawdź:

• bezpośrednie małe wywołania się udają, ale uruchomienia OpenClaw zawodzą tylko przy większych promptach
• błędy model_not_found lub 404, mimo że bezpośrednie /v1/chat/completions działa z tym samym prostym identyfikatorem modelu
• błędy backendu o tym, że messages[].content oczekuje ciągu znaków
• sporadyczne ostrzeżenia incomplete turn detected ... stopReason=stop payloads=0 z lokalnym backendem zgodnym z OpenAI
• awarie backendu, które pojawiają się tylko przy większej liczbie tokenów promptu lub pełnych promptach środowiska uruchomieniowego agenta

Powiązane:

• Konfiguracja
• Modele lokalne
• Endpointy zgodne z OpenAI

Brak odpowiedzi

Jeśli kanały działają, ale nic nie odpowiada, przed ponownym łączeniem czegokolwiek sprawdź routing i zasady.

openclaw statusopenclaw channels status --probeopenclaw pairing list --channel <channel> [--account <id>]openclaw config get channelsopenclaw logs --follow

Zwróć uwagę na:

• Oczekujące parowanie dla nadawców DM.
• Bramkowanie wzmianek w grupie (requireMention, mentionPatterns).
• Niezgodności listy dozwolonych kanałów/grup.

Typowe sygnatury:

• drop guild message (mention required → wiadomość grupowa ignorowana do czasu wzmianki.
• pairing request → nadawca wymaga zatwierdzenia.
• blocked / allowlist → nadawca/kanał został odfiltrowany przez zasady.

Powiązane:

• Rozwiązywanie problemów z kanałami
• Grupy
• Parowanie

Łączność interfejsu sterowania panelu

Gdy panel/interfejs sterowania nie chce się połączyć, sprawdź URL, tryb uwierzytelniania i założenia dotyczące bezpiecznego kontekstu.

openclaw gateway statusopenclaw statusopenclaw logs --followopenclaw doctoropenclaw gateway status --json

Zwróć uwagę na:

• Poprawny URL sondy i URL panelu.
• Niezgodność trybu/tokena uwierzytelniania między klientem a gatewayem.
• Użycie HTTP tam, gdzie wymagana jest tożsamość urządzenia.

Jeśli lokalna przeglądarka nie może połączyć się z 127.0.0.1:18789 po aktualizacji, najpierw przywróć lokalną usługę Gateway i potwierdź, że serwuje panel:

openclaw gateway restartlsof -i :18789curl http://127.0.0.1:18789

Jeśli curl zwraca HTML OpenClaw, Gateway działa, a pozostały problem to prawdopodobnie pamięć podręczna przeglądarki, stary głęboki link albo nieaktualny stan karty. Otwórz http://127.0.0.1:18789 bezpośrednio i przejdź dalej z panelu. Jeśli restart nie zostawia usługi uruchomionej, uruchom openclaw gateway start i ponownie sprawdź openclaw gateway status.

Szybka mapa kodów szczegółów uwierzytelniania

Użyj error.details.code z nieudanego wyniku connect, aby wybrać następną czynność:

Kontrola migracji uwierzytelniania urządzeń v2:

openclaw --versionopenclaw doctoropenclaw gateway status

Jeśli logi pokazują błędy nonce/podpisu, zaktualizuj łączącego się klienta i go zweryfikuj:

Jeśli openclaw devices rotate / revoke / remove zostaje nieoczekiwanie odrzucone:

• sesje tokenów sparowanych urządzeń mogą zarządzać tylko własnym urządzeniem, chyba że wywołujący ma też operator.admin
• openclaw devices rotate --scope ... może żądać tylko zakresów operatora, które sesja wywołującego już posiada

Powiązane:

• Konfiguracja (tryby uwierzytelniania gatewaya)
• Control UI
• Urządzenia
• Dostęp zdalny
• Uwierzytelnianie zaufanego proxy

Usługa Gateway nie działa

Użyj tego, gdy usługa jest zainstalowana, ale proces nie pozostaje uruchomiony.

openclaw gateway statusopenclaw statusopenclaw logs --followopenclaw doctoropenclaw gateway status --deep   # also scan system-level services

Zwróć uwagę na:

• Runtime: stopped ze wskazówkami wyjścia.
• Niezgodność konfiguracji usługi (Config (cli) vs Config (service)).
• Konflikty portu/listenera.
• Dodatkowe instalacje launchd/systemd/schtasks przy użyciu --deep.
• Wskazówki czyszczenia Other gateway-like services detected (best effort).

Powiązane:

• Wykonywanie w tle i narzędzie procesów
• Konfiguracja
• Doctor

Gateway na macOS po cichu przestaje odpowiadać, a potem wznawia działanie, gdy dotkniesz panelu

Użyj tego, gdy kanały (Telegram, WhatsApp itd.) na hoście macOS milkną na minuty lub godziny naraz, a gateway wydaje się wracać w chwili, gdy otworzysz Control UI, połączysz się przez SSH albo w inny sposób wejdziesz w interakcję z hostem. Zwykle nie ma oczywistego objawu w openclaw status, ponieważ zanim sprawdzisz, gateway znów działa.

ls ~/.openclaw/logs/stability/ | tail -5openclaw gateway stability --bundle latestpmset -g log | grep -iE "sleep|wake|maintenance" | tail -50launchctl print gui/$UID/ai.openclaw.gateway | grep -E "state|last exit|runs"

Szukaj:

• Jednego lub więcej pakietów *-uncaught_exception.json w ~/.openclaw/logs/stability/ z error.code ustawionym na przejściowy kod sieciowy, taki jak ENETDOWN, ENETUNREACH, EHOSTUNREACH lub ECONNREFUSED.
• Wierszy pmset -g log, takich jak Entering Sleep state due to 'Maintenance Sleep' lub en0 driver is slow (msg: WillChangeState to 0), zbieżnych ze znacznikami czasu awarii. Power Nap / Maintenance Sleep na krótko przełącza sterownik Wi-Fi w stan 0; każde wychodzące connect(), które trafi w to okno, może zakończyć się błędem ENETDOWN nawet na hoście, który poza tym ma pełną łączność sieciową.
• Wyniku launchctl print pokazującego state = not running z wieloma niedawnymi runs i kodem wyjścia, zwłaszcza gdy odstęp między awarią a następnym uruchomieniem jest rzędu godziny, a nie sekund. macOS launchd stosuje nieudokumentowaną bramkę ochrony przed ponownym uruchamianiem po serii awarii, która może przestać respektować KeepAlive=true, dopóki zewnętrzny wyzwalacz, taki jak interaktywne logowanie, połączenie z dashboardem lub launchctl kickstart, nie uzbroi jej ponownie.

Typowe sygnatury:

• Pakiet stabilności, którego error.code to ENETDOWN lub pokrewny kod, ze stosem wywołań wskazującym na Node net lookupAndConnect / Socket.connect. OpenClaw 2026.5.26 i nowsze klasyfikują je jako niegroźne przejściowe błędy sieciowe, więc nie propagują się już do najwyższego poziomu obsługi nieprzechwyconych wyjątków; jeśli używasz starszego wydania, najpierw zaktualizuj.
• Długie ciche okresy, które kończą się dokładnie w chwili połączenia z Control UI lub SSH do hosta: widoczna dla użytkownika aktywność ponownie uzbraja bramkę ponownego uruchamiania launchd, a nie jakiekolwiek działanie dashboardu wobec Gateway.
• Licznik runs rosnący w ciągu dnia bez odpowiadającego mu wiersza received SIG*; shutting down w ~/Library/Logs/openclaw/gateway.log: czyste zamknięcia zapisują sygnał w logu; przejściowe awarie nie.

Co zrobić:

1. Zaktualizuj Gateway, jeśli używasz wydania sprzed 2026.5.26. Po aktualizacji przyszłe błędy ENETDOWN będą logowane jako ostrzeżenia zamiast kończyć proces.

2. Ogranicz aktywność Maintenance Sleep na hostach Mac mini / desktop, które mają działać jako stale włączone serwery:

   sudo pmset -a sleep 0 disksleep 0 standby 0 powernap 0

   To znacząco ogranicza, ale nie eliminuje całkowicie, bazowego przełączenia sterownika. System nadal może wykonywać niektóre uśpienia konserwacyjne na potrzeby TCP keepalive i utrzymania mDNS niezależnie od tych flag.

3. Dodaj watchdog żywotności, aby przyszła seria awarii zatrzymana przez launchd została szybko wykryta:

   # Example launchd-aware liveness check, suitable for a 5-minute cron or LaunchAgentstate=$(launchctl print gui/$UID/ai.openclaw.gateway 2>/dev/null | awk -F'= ' '/state =/ {print $2; exit}')if [ "$state" != "running" ]; then  launchctl kickstart -k gui/$UID/ai.openclaw.gatewayfi

   Celem jest zewnętrzne ponowne uzbrojenie bramki ponownego uruchamiania; samo KeepAlive=true nie wystarcza w macOS po serii awarii.

Powiązane:

• Uwagi dotyczące platformy macOS
• Logowanie
• Doctor

Gateway kończy działanie podczas wysokiego użycia pamięci

Użyj tego, gdy Gateway znika pod obciążeniem, nadzorca zgłasza ponowne uruchomienie w stylu OOM albo logi wspominają critical memory pressure bundle written.

openclaw gateway status --deepopenclaw logs --followopenclaw gateway stability --bundle latestopenclaw gateway diagnostics export

Szukaj:

• Reason: diagnostic.memory.pressure.critical w najnowszym pakiecie stabilności.
• Memory pressure: z critical/rss_threshold, critical/heap_threshold lub critical/rss_growth.
• Wartości V8 heap: bliskich limitu sterty.
• Wpisów Largest session files:, takich jak agents/<agent>/sessions/<session>.jsonl lub sessions/<session>.jsonl.
• Liczników pamięci cgroup Linuksa, gdy gateway działa w kontenerze lub usłudze z limitem pamięci.

Typowe sygnatury:

• critical memory pressure bundle written pojawia się krótko przed ponownym uruchomieniem → OpenClaw przechwycił pakiet stabilności sprzed OOM. Sprawdź go poleceniem openclaw gateway stability --bundle latest.
• memory pressure: level=critical ... memoryPressureSnapshot=disabled pojawia się w logach gatewaya → OpenClaw wykrył krytyczną presję pamięci, ale migawka stabilności sprzed OOM jest wyłączona.
• Largest session files: wskazuje na bardzo dużą zredagowaną ścieżkę transkrypcji → ogranicz zachowywaną historię sesji, sprawdź wzrost sesji albo przenieś stare transkrypcje poza aktywny magazyn przed ponownym uruchomieniem.
• Użyte bajty V8 heap: są blisko limitu sterty → zmniejsz presję promptów/sesji, ogranicz współbieżną pracę albo zwiększ limit sterty Node dopiero po potwierdzeniu, że obciążenie jest oczekiwane.
• Memory pressure: critical/rss_growth → pamięć szybko wzrosła w jednym oknie próbkowania. Sprawdź najnowsze logi pod kątem dużego importu, niekontrolowanego wyjścia narzędzia, powtarzanych ponowień lub partii zakolejkowanej pracy agenta.
• Krytyczna presja pamięci pojawia się w logach, ale nie istnieje żaden pakiet → to ustawienie domyślne. Ustaw diagnostics.memoryPressureSnapshot: true, aby przy przyszłych krytycznych zdarzeniach presji pamięci przechwytywać pakiet stabilności sprzed OOM.

Pakiet stabilności nie zawiera payloadów. Obejmuje operacyjne dowody pamięci i zredagowane względne ścieżki plików, a nie tekst wiadomości, treści webhooków, poświadczenia, tokeny, cookies ani surowe identyfikatory sesji. Dołącz eksport diagnostyki do zgłoszeń błędów zamiast kopiować surowe logi.

Powiązane:

• Kondycja Gateway
• Eksport diagnostyki
• Sesje

Gateway odrzucił nieprawidłową konfigurację

Użyj tego, gdy uruchomienie Gateway kończy się błędem Invalid config albo logi hot reload mówią, że pominięto nieprawidłową edycję.

openclaw logs --followopenclaw config fileopenclaw config validateopenclaw doctor

Szukaj:

• Invalid config at ...
• config reload skipped (invalid config): ...
• Config write rejected: ...
• Pliku openclaw.json.rejected.* ze znacznikiem czasu obok aktywnej konfiguracji
• Pliku openclaw.json.clobbered.* ze znacznikiem czasu, jeśli doctor --fix naprawił uszkodzoną bezpośrednią edycję
• OpenClaw zachowuje najnowsze 32 pliki .clobbered.* dla każdej ścieżki konfiguracji i rotuje starsze

CONFIG="$(openclaw config file)"ls -lt "$CONFIG".clobbered.* "$CONFIG".rejected.* 2>/dev/null | headdiff -u "$CONFIG" "$(ls -t "$CONFIG".clobbered.* 2>/dev/null | head -n 1)"openclaw config validateopenclaw doctor

Powiązane:

• Konfiguracja
• Konfiguracja: hot reload
• Konfiguracja: ścisła walidacja
• Doctor

Ostrzeżenia sondy Gateway

Użyj tego, gdy openclaw gateway probe dociera do czegoś, ale nadal wypisuje blok ostrzeżeń.

openclaw gateway probeopenclaw gateway probe --jsonopenclaw gateway probe --ssh user@gateway-host

Szukaj:

• warnings[].code i primaryTargetId w wyniku JSON.
• Czy ostrzeżenie dotyczy fallbacku SSH, wielu gatewayów, brakujących zakresów czy nierozwiązanych odwołań auth.

Typowe sygnatury:

• SSH tunnel failed to start; falling back to direct probes. → konfiguracja SSH nie powiodła się, ale polecenie nadal próbowało bezpośrednich skonfigurowanych/celów loopback.
• multiple reachable gateway identities detected → odpowiedziały różne gatewaye albo OpenClaw nie mógł udowodnić, że osiągalne cele są tym samym gatewayem. Tunel SSH, URL proxy lub skonfigurowany zdalny URL do tego samego gatewaya jest traktowany jako jeden gateway z wieloma transportami, nawet gdy porty transportu się różnią.
• Read-probe diagnostics are limited by gateway scopes (missing operator.read) → połączenie zadziałało, ale szczegółowe RPC jest ograniczone zakresem; sparuj tożsamość urządzenia albo użyj poświadczeń z operator.read.
• Gateway accepted the WebSocket connection, but follow-up read diagnostics failed → połączenie zadziałało, ale pełny zestaw diagnostycznych RPC przekroczył limit czasu lub nie powiódł się. Traktuj to jako osiągalny Gateway z pogorszoną diagnostyką; porównaj connect.ok i connect.rpcOk w wyniku --json.
• Capability: pairing-pending lub gateway closed (1008): pairing required → gateway odpowiedział, ale ten klient nadal wymaga parowania/zatwierdzenia przed normalnym dostępem operatora.
• nierozwiązany tekst ostrzeżenia gateway.auth.* / gateway.remote.* SecretRef → materiał auth był niedostępny w tej ścieżce polecenia dla nieudanego celu.

Powiązane:

• Gateway
• Wiele gatewayów na tym samym hoście
• Dostęp zdalny

Kanał połączony, wiadomości nie przepływają

Jeśli stan kanału to połączony, ale przepływ wiadomości nie działa, skup się na polityce, uprawnieniach i regułach dostarczania specyficznych dla kanału.

openclaw channels status --probeopenclaw pairing list --channel <channel> [--account <id>]openclaw status --deepopenclaw logs --followopenclaw config get channels

Szukaj:

• Polityki DM (pairing, allowlist, open, disabled).
• Listy dozwolonych grup i wymagań dotyczących wzmianek.
• Brakujących uprawnień/zakresów API kanału.

Typowe sygnatury:

• mention required → wiadomość zignorowana przez politykę wzmianek w grupie.
• Ślady pairing / oczekującego zatwierdzenia → nadawca nie jest zatwierdzony.
• missing_scope, not_in_channel, Forbidden, 401/403 → problem z auth/uprawnieniami kanału.

Powiązane:

• Rozwiązywanie problemów z kanałami
• Discord
• Telegram
• WhatsApp

Dostarczanie Cron i Heartbeat

Jeśli cron lub heartbeat nie uruchomił się albo nie dostarczył wiadomości, najpierw zweryfikuj stan harmonogramu, a potem cel dostarczania.

openclaw cron statusopenclaw cron listopenclaw cron runs --id <jobId> --limit 20openclaw system heartbeat lastopenclaw logs --follow

Sprawdź:

• Cron jest włączony i obecny jest następny czas wybudzenia.
• Status historii uruchomień zadań (ok, skipped, error).
• Powody pominięcia Heartbeat (quiet-hours, requests-in-flight, cron-in-progress, lanes-busy, alerts-disabled, empty-heartbeat-file, no-tasks-due).

Powiązane:

• Heartbeat
• Zaplanowane zadania
• Zaplanowane zadania: rozwiązywanie problemów

Node sparowany, narzędzie zawodzi

Jeśli node jest sparowany, ale narzędzia zawodzą, odizoluj stan pierwszego planu, uprawnień i zatwierdzeń.

openclaw nodes statusopenclaw nodes describe --node <idOrNameOrIp>openclaw approvals get --node <idOrNameOrIp>openclaw logs --followopenclaw status

Sprawdź:

• Node jest online z oczekiwanymi możliwościami.
• Nadania uprawnień systemu operacyjnego do kamery, mikrofonu, lokalizacji i ekranu.
• Stan zatwierdzeń exec i listy dozwolonych.

Typowe sygnatury:

• NODE_BACKGROUND_UNAVAILABLE → aplikacja node musi być na pierwszym planie.
• *_PERMISSION_REQUIRED / LOCATION_PERMISSION_REQUIRED → brakuje uprawnienia systemu operacyjnego.
• SYSTEM_RUN_DENIED: approval required → oczekuje zatwierdzenie exec.
• SYSTEM_RUN_DENIED: allowlist miss → polecenie zablokowane przez listę dozwolonych.

Powiązane:

• Zatwierdzenia exec
• Rozwiązywanie problemów z Node
• Nodes

Narzędzie przeglądarki zawodzi

Użyj tego, gdy akcje narzędzia przeglądarki zawodzą, mimo że sam Gateway jest zdrowy.

openclaw browser statusopenclaw browser start --browser-profile openclawopenclaw browser profilesopenclaw logs --followopenclaw doctor

Sprawdź:

• Czy plugins.allow jest ustawione i zawiera browser.
• Prawidłową ścieżkę do pliku wykonywalnego przeglądarki.
• Osiągalność profilu CDP.
• Dostępność lokalnego Chrome dla profili existing-session / user.

Powiązane:

• Przeglądarka (zarządzana przez OpenClaw)
• Rozwiązywanie problemów z przeglądarką

Jeśli po aktualizacji coś nagle przestało działać

Większość awarii po aktualizacji to dryf konfiguracji albo egzekwowanie bardziej rygorystycznych wartości domyślnych.

openclaw gateway statusopenclaw config get gateway.modeopenclaw config get gateway.remote.urlopenclaw config get gateway.auth.mode

openclaw config get gateway.bindopenclaw config get gateway.auth.modeopenclaw config get gateway.auth.tokenopenclaw gateway statusopenclaw logs --follow

openclaw devices listopenclaw pairing list --channel <channel> [--account <id>]openclaw logs --followopenclaw doctor

Jeśli konfiguracja usługi i runtime nadal się nie zgadzają po sprawdzeniach, zainstaluj ponownie metadane usługi z tego samego katalogu profilu/stanu:

openclaw gateway install --forceopenclaw gateway restart

Powiązane:

• Uwierzytelnianie
• Exec w tle i narzędzie procesu
• Parowanie zarządzane przez Gateway

Powiązane

• Doctor
• FAQ
• Runbook Gateway