Probleemoplossing

Deze pagina is het diepgaande runbook. Begin bij /help/troubleshooting als je eerst de snelle triageflow wilt.

Commandoladder

Voer deze eerst uit, in deze volgorde:

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

Verwachte gezonde signalen:

• openclaw gateway status toont Runtime: running, Connectivity probe: ok en een regel Capability: ....
• openclaw doctor meldt geen blokkerende configuratie- of serviceproblemen.
• openclaw channels status --probe toont live transportstatus per account en, waar ondersteund, probe-/auditresultaten zoals works of audit ok.

Na een update

Gebruik dit wanneer een update is voltooid maar de Gateway offline is, kanalen leeg zijn, of modelaanroepen beginnen te mislukken met 401's.

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

Let op:

• Update restart in openclaw status / openclaw status --all. Wachtende of mislukte overdrachten bevatten de volgende opdracht om uit te voeren.
• plugin load failed: dependency tree corrupted; run openclaw doctor --fix onder Kanalen. Dat betekent dat de kanaalconfiguratie nog bestaat, maar dat de Plugin- registratie mislukte voordat het kanaal kon laden.
• provider-401's na opnieuw authenticeren. openclaw doctor --fix controleert op verouderde OAuth-authschaduwen per agent en verwijdert de oude kopieën zodat alle agents het huidige gedeelde profiel gebruiken.

Split-braininstallaties en nieuwere configuratiebeveiliging

Gebruik dit wanneer een Gateway-service onverwacht stopt na een update, of logs tonen dat één openclaw-binary ouder is dan de versie die voor het laatst openclaw.json heeft geschreven.

OpenClaw markeert configuratieschrijfacties met meta.lastTouchedVersion. Alleen-lezen-opdrachten kunnen nog steeds een configuratie inspecteren die door een nieuwere OpenClaw is geschreven, maar proces- en servicemutaties weigeren door te gaan vanaf een oudere binary. Geblokkeerde acties omvatten het starten, stoppen, herstarten en verwijderen van de Gateway-service, geforceerde serviceherinstallatie, Gateway-start in servicemodus en gateway --force-poortopschoning.

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

openclaw gateway install --forceopenclaw gateway restart

Protocolmismatch na rollback

Gebruik dit wanneer logs protocol mismatch blijven afdrukken nadat je OpenClaw hebt gedowngraded of teruggedraaid. Dit betekent dat een oudere Gateway draait, maar dat een nieuwer lokaal clientproces nog steeds probeert opnieuw verbinding te maken met een protocolbereik dat de oudere Gateway niet ondersteunt.

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

Let op:

• protocol mismatch ... client=... v<version> min=<n> max=<n> expected=<n> in Gateway-logs.
• Established clients: in openclaw gateway status --deep of Gateway clients in openclaw doctor --deep. Dit toont actieve TCP-clients die verbonden zijn met de Gateway-poort, inclusief PID's en opdrachtregels wanneer het besturingssysteem dat toestaat.
• Een clientproces waarvan de opdrachtregel wijst naar de nieuwere OpenClaw-installatie of wrapper waarvan je bent teruggedraaid.

Oplossing:

1. Stop of herstart het verouderde OpenClaw-clientproces dat door gateway status --deep wordt getoond.
2. Herstart apps of wrappers die OpenClaw insluiten, zoals lokale dashboards, editors, app-serverhelpers of langlopende openclaw logs --follow-shells.
3. Voer openclaw gateway status --deep of openclaw doctor --deep opnieuw uit en bevestig dat de verouderde client-PID verdwenen is.

Laat een oudere Gateway geen nieuwer incompatibel protocol accepteren. Protocolverhogingen beschermen het wire-contract; rollbackherstel is een proces-/versieopschoningsprobleem.

Skills-symlink overgeslagen als padontsnapping

Gebruik dit wanneer logs het volgende bevatten:

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

OpenClaw behandelt elke Skills-root als een containmentgrens. Een symlink onder ~/.agents/skills, <workspace>/.agents/skills, <workspace>/skills of ~/.openclaw/skills wordt overgeslagen wanneer het echte doel buiten die root uitkomt, tenzij het doel expliciet vertrouwd is.

Inspecteer de link:

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

Als het doel bedoeld is, configureer dan zowel de directe Skills-root als het toegestane symlinkdoel:

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

Start daarna een nieuwe sessie of wacht tot de Skills-watcher ververst. Herstart de Gateway als het draaiende proces van vóór de configuratiewijziging is.

Gebruik geen brede doelen zoals ~, / of een volledige gesynchroniseerde projectmap. Houd allowSymlinkTargets beperkt tot de echte Skills-root die vertrouwde SKILL.md-mappen bevat.

Als Skill Workshop apply ook door die vertrouwde gesymlinkte workspace-Skills-paden moet schrijven, schakel dan skills.workshop.allowSymlinkTargetWrites in. Houd dit uitgeschakeld voor alleen-lezen gedeelde Skills-roots.

Gerelateerd:

• Skills-configuratie
• Configuratievoorbeelden

Anthropic 429 extra gebruik vereist voor lange context

Gebruik dit wanneer logs/fouten bevatten: HTTP 429: rate_limit_error: Extra usage is required for long context requests.

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

Let op:

• Geselecteerd Anthropic-model is een GA-geschikt 1M Claude 4.x-model, of het model heeft legacy params.context1m: true.
• Huidige Anthropic-referentie is niet geschikt voor gebruik met lange context.
• Verzoeken mislukken alleen bij lange sessies/modelruns die het 1M-contextpad nodig hebben.

Oplossingsopties:

Gerelateerd:

• Anthropic
• Tokengebruik en kosten
• Waarom zie ik HTTP 429 van Anthropic?

Upstream 403-geblokkeerde reacties

Gebruik dit wanneer een upstream LLM-provider een generieke 403 retourneert, zoals Your request was blocked.

Ga er niet van uit dat dit altijd een configuratieprobleem van OpenClaw is. De reactie kan komen van een upstream beveiligingslaag zoals een CDN, WAF, botbeheerregel of reverse proxy vóór een OpenAI-compatibel endpoint.

openclaw statusopenclaw gateway statusopenclaw logs --follow

Let op:

• meerdere modellen onder dezelfde provider falen op dezelfde manier
• HTML of generieke beveiligingstekst in plaats van een normale provider-API-fout
• beveiligingsgebeurtenissen aan providerzijde voor hetzelfde verzoekmoment
• een kleine directe curl-probe slaagt terwijl normale SDK-vormige verzoeken mislukken

Los eerst de filtering aan providerzijde op wanneer het bewijs wijst op een WAF/CDN- blokkade. Geef de voorkeur aan een nauw afgebakende allow- of skipregel voor het API-pad dat OpenClaw gebruikt, en vermijd het uitschakelen van bescherming voor de hele site.

Gerelateerd:

• OpenAI-compatibele endpoints
• Providerconfiguratie
• Logs

Lokale OpenAI-compatibele backend slaagt voor directe probes maar agentruns mislukken

Gebruik dit wanneer:

• curl ... /v1/models werkt
• kleine directe /v1/chat/completions-aanroepen werken
• OpenClaw-modelruns alleen mislukken bij normale agentbeurten

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

Let op:

• directe kleine aanroepen slagen, maar OpenClaw-runs mislukken alleen bij grotere prompts
• model_not_found- of 404-fouten ook al werkt directe /v1/chat/completions met dezelfde kale model-id
• backendfouten over messages[].content die een string verwachten
• intermitterende waarschuwingen incomplete turn detected ... stopReason=stop payloads=0 met een OpenAI-compatibele lokale backend
• backendcrashes die alleen verschijnen bij grotere prompt-tokenaantallen of volledige agent-runtimeprompts

Gerelateerd:

• Configuratie
• Lokale modellen
• OpenAI-compatibele endpoints

Geen antwoorden

Als kanalen actief zijn maar niets antwoordt, controleer dan routing en beleid voordat je iets opnieuw verbindt.

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

Let op:

• Koppeling in behandeling voor DM-afzenders.
• Groepsvermelding-gating (requireMention, mentionPatterns).
• Mismatches in de allowlist voor kanaal/groep.

Veelvoorkomende kenmerken:

• drop guild message (mention required → groepsbericht genegeerd tot vermelding.
• pairing request → afzender heeft goedkeuring nodig.
• blocked / allowlist → afzender/kanaal is door beleid gefilterd.

Gerelateerd:

• Kanaalprobleemoplossing
• Groepen
• Koppeling

Connectiviteit van dashboard/control-UI

Wanneer de dashboard/control-UI geen verbinding maakt, valideer dan de URL, auth-modus en aannames over de veilige context.

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

Let op:

• Juiste probe-URL en dashboard-URL.
• Mismatch in auth-modus/token tussen client en gateway.
• HTTP-gebruik waar apparaatidentiteit vereist is.

Als een lokale browser na een update geen verbinding kan maken met 127.0.0.1:18789, herstel dan eerst de lokale Gateway-service en bevestig dat deze het dashboard serveert:

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

Als curl OpenClaw-HTML teruggeeft, werkt de Gateway en is het resterende probleem waarschijnlijk browsercache, een oude dieplink of verouderde tabbladstatus. Open http://127.0.0.1:18789 rechtstreeks en navigeer vanaf het dashboard. Als herstarten de service niet actief laat, voer dan openclaw gateway start uit en controleer openclaw gateway status opnieuw.

Snelle kaart voor auth-detailcodes

Gebruik error.details.code uit de mislukte connect-respons om de volgende actie te kiezen:

Migratiecontrole voor apparaatauthenticatie v2:

openclaw --versionopenclaw doctoropenclaw gateway status

Als logs nonce-/handtekeningfouten tonen, werk dan de verbindende client bij en verifieer deze:

Als openclaw devices rotate / revoke / remove onverwacht wordt geweigerd:

• gekoppelde-apparaattokensessies kunnen alleen hun eigen apparaat beheren, tenzij de aanroeper ook operator.admin heeft
• openclaw devices rotate --scope ... kan alleen operatorscopes aanvragen die de aanroepersessie al heeft

Gerelateerd:

• Configuratie (Gateway-auth-modi)
• Control UI
• Apparaten
• Externe toegang
• Vertrouwde-proxy-auth

Gateway-service draait niet

Gebruik dit wanneer de service is geïnstalleerd maar het proces niet actief blijft.

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

Let op:

• Runtime: stopped met exithints.
• Mismatch in serviceconfiguratie (Config (cli) vs Config (service)).
• Poort-/listenerconflicten.
• Extra launchd/systemd/schtasks-installaties wanneer --deep wordt gebruikt.
• Opruimhints voor Other gateway-like services detected (best effort).

Gerelateerd:

• Achtergrondexec en procestool
• Configuratie
• Doctor

macOS-gateway reageert stilzwijgend niet meer en hervat daarna wanneer je het dashboard aanraakt

Gebruik dit wanneer kanalen (Telegram, WhatsApp, enz.) op een macOS-host minuten tot uren tegelijk stilvallen, en de gateway lijkt terug te komen zodra je de Control UI opent, via SSH inlogt of anderszins met de host interageert. Er is meestal geen duidelijk symptoom in openclaw status, omdat de gateway tegen de tijd dat je kijkt alweer leeft.

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"

Let op:

• Een of meer *-uncaught_exception.json-bundels in ~/.openclaw/logs/stability/ waarbij error.code is ingesteld op een tijdelijke netwerkcode zoals ENETDOWN, ENETUNREACH, EHOSTUNREACH of ECONNREFUSED.
• pmset -g log-regels zoals Entering Sleep state due to 'Maintenance Sleep' of en0 driver is slow (msg: WillChangeState to 0) die samenvallen met de crashtijdstempels. Power Nap / Maintenance Sleep zet het wifi-stuurprogramma kort in status 0; elke uitgaande connect() die in dat venster valt, kan mislukken met ENETDOWN, zelfs op een host die verder volledige netwerkconnectiviteit heeft.
• launchctl print-uitvoer met state = not running, meerdere recente runs en een exitcode, vooral wanneer de periode tussen de crash en de volgende start eerder rond een uur ligt dan rond seconden. macOS launchd past na een crashreeks een niet-gedocumenteerde herstartbeveiliging toe die KeepAlive=true kan blijven negeren totdat een externe trigger, zoals interactief inloggen, een dashboardverbinding of launchctl kickstart, deze opnieuw activeert.

Veelvoorkomende signalen:

• Een stabiliteitsbundel waarvan error.code ENETDOWN of een verwante code is, met een callstack die wijst naar Node net lookupAndConnect / Socket.connect. OpenClaw 2026.5.26 en nieuwer classificeren deze als onschuldige tijdelijke netwerkfouten, zodat ze niet langer doorlopen naar de uncaught handler op topniveau; als je een oudere release gebruikt, upgrade dan eerst.
• Lange stille perioden die precies eindigen zodra je verbinding maakt met de Control UI of via SSH inlogt op de host: de gebruikerszichtbare activiteit is wat de herstartbeveiliging van launchd opnieuw activeert, niet iets wat het dashboard met de gateway doet.
• Een runs-aantal dat gedurende de dag oploopt zonder overeenkomstige regel received SIG*; shutting down in ~/Library/Logs/openclaw/gateway.log: schone afsluitingen loggen een signaal; tijdelijke crashes doen dat niet.

Wat te doen:

1. Upgrade de gateway als je een release vóór 2026.5.26 gebruikt. Na de upgrade worden toekomstige ENETDOWN-fouten als waarschuwingen gelogd in plaats van het proces te beëindigen.

2. Verminder onderhoudsslaapactiviteit op Mac mini- / desktophosts die bedoeld zijn om als altijd-aan-servers te draaien:

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

   Dit vermindert de onderliggende driverflap aanzienlijk, maar elimineert deze niet volledig. Het systeem kan nog steeds bepaalde onderhoudsslaapstanden uitvoeren voor TCP-keepalive en mDNS-onderhoud, ongeacht deze vlaggen.

3. Voeg een liveness-watchdog toe, zodat een toekomstige crashreeks die door launchd wordt geparkeerd snel wordt opgemerkt:

   # 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

   Het doel is om de herstartbeveiliging extern opnieuw te activeren; KeepAlive=true alleen is op macOS na een crashreeks niet voldoende.

Gerelateerd:

• macOS-platformnotities
• Logboekregistratie
• Doctor

Gateway sluit af bij hoog geheugengebruik

Gebruik dit wanneer de Gateway onder belasting verdwijnt, de supervisor een OOM-achtige herstart meldt, of logs critical memory pressure bundle written vermelden.

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

Let op:

• Reason: diagnostic.memory.pressure.critical in de nieuwste stabiliteitsbundel.
• Memory pressure: met critical/rss_threshold, critical/heap_threshold of critical/rss_growth.
• V8 heap:-waarden dicht bij de heaplimiet.
• Largest session files:-items zoals agents/<agent>/sessions/<session>.jsonl of sessions/<session>.jsonl.
• Linux cgroup-geheugentellers wanneer de gateway in een container of service met geheugenlimiet draait.

Veelvoorkomende signalen:

• critical memory pressure bundle written verschijnt kort voor de herstart → OpenClaw heeft een pre-OOM-stabiliteitsbundel vastgelegd. Inspecteer deze met openclaw gateway stability --bundle latest.
• memory pressure: level=critical ... memoryPressureSnapshot=disabled verschijnt in gatewaylogs → OpenClaw heeft kritieke geheugendruk gedetecteerd, maar de pre-OOM-stabiliteitssnapshot staat uit.
• Largest session files: wijst naar een zeer groot geredigeerd transcriptpad → verminder de bewaarde sessiegeschiedenis, inspecteer sessiegroei, of verplaats oude transcripties uit de actieve opslag voordat je opnieuw start.
• Gebruikte bytes bij V8 heap: liggen dicht bij de heaplimiet → verlaag prompt-/sessiedruk, verminder gelijktijdig werk, of verhoog de Node-heaplimiet pas nadat je hebt bevestigd dat de workload verwacht is.
• Memory pressure: critical/rss_growth → geheugen groeide snel binnen één samplingvenster. Controleer de nieuwste logs op een grote import, ontspoorde tooluitvoer, herhaalde retries of een batch wachtrijwerk van agents.
• Kritieke geheugendruk verschijnt in logs maar er bestaat geen bundel → dit is de standaardinstelling. Stel diagnostics.memoryPressureSnapshot: true in om de pre-OOM-stabiliteitsbundel vast te leggen bij toekomstige kritieke geheugendrukgebeurtenissen.

De stabiliteitsbundel bevat geen payload. Deze bevat operationeel geheugenbewijs en geredigeerde relatieve bestandspaden, geen berichttekst, webhook-bodies, referenties, tokens, cookies of ruwe sessie-id's. Voeg de diagnostiekexport toe aan bugrapporten in plaats van ruwe logs te kopiëren.

Gerelateerd:

• Gateway-gezondheid
• Diagnostiekexport
• Sessies

Gateway heeft ongeldige configuratie geweigerd

Gebruik dit wanneer het opstarten van de Gateway mislukt met Invalid config of hot-reloadlogs zeggen dat een ongeldige bewerking is overgeslagen.

openclaw logs --followopenclaw config fileopenclaw config validateopenclaw doctor

Let op:

• Invalid config at ...
• config reload skipped (invalid config): ...
• Config write rejected: ...
• Een getijdstempeld bestand openclaw.json.rejected.* naast de actieve configuratie
• Een getijdstempeld bestand openclaw.json.clobbered.* als doctor --fix een kapotte directe bewerking heeft gerepareerd
• OpenClaw bewaart de nieuwste 32 .clobbered.*-bestanden voor elk configuratiepad en roteert oudere bestanden

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

Gerelateerd:

• Configuratie
• Configuratie: hot reload
• Configuratie: strikte validatie
• Doctor

Gateway-probewaarschuwingen

Gebruik dit wanneer openclaw gateway probe iets bereikt, maar toch een waarschuwingsblok afdrukt.

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

Let op:

• warnings[].code en primaryTargetId in JSON-uitvoer.
• Of de waarschuwing gaat over SSH-fallback, meerdere gateways, ontbrekende scopes of onopgeloste auth-refs.

Veelvoorkomende signalen:

• SSH tunnel failed to start; falling back to direct probes. → SSH-configuratie faalde, maar de opdracht probeerde nog steeds directe geconfigureerde/local loopback-doelen.
• multiple reachable gateway identities detected → verschillende gateways hebben geantwoord, of OpenClaw kon niet bewijzen dat bereikbare doelen dezelfde gateway zijn. Een SSH-tunnel, proxy-URL of geconfigureerde externe URL naar dezelfde gateway wordt behandeld als één gateway met meerdere transports, zelfs wanneer transportpoorten verschillen.
• Read-probe diagnostics are limited by gateway scopes (missing operator.read) → verbinden werkte, maar detail-RPC is beperkt door scopes; koppel apparaatidentiteit of gebruik referenties met operator.read.
• Gateway accepted the WebSocket connection, but follow-up read diagnostics failed → verbinden werkte, maar de volledige set diagnostische RPC's kreeg een timeout of faalde. Behandel dit als een bereikbare Gateway met gedegradeerde diagnostiek; vergelijk connect.ok en connect.rpcOk in --json-uitvoer.
• Capability: pairing-pending of gateway closed (1008): pairing required → de gateway antwoordde, maar deze client moet nog worden gekoppeld/goedgekeurd vóór normale operatortoegang.
• onopgeloste waarschuwingstekst voor gateway.auth.* / gateway.remote.* SecretRef → auth-materiaal was in dit opdrachtpad niet beschikbaar voor het mislukte doel.

Gerelateerd:

• Gateway
• Meerdere gateways op dezelfde host
• Externe toegang

Kanaal verbonden, berichten stromen niet

Als de kanaalstatus verbonden is maar de berichtenstroom dood is, focus dan op beleid, machtigingen en kanaalspecifieke bezorgregels.

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

Let op:

• DM-beleid (pairing, allowlist, open, disabled).
• Groepsallowlist en vermeldingsvereisten.
• Ontbrekende kanaal-API-machtigingen/scopes.

Veelvoorkomende signalen:

• mention required → bericht genegeerd door groepsvermeldingsbeleid.
• pairing / sporen van wachtende goedkeuring → afzender is niet goedgekeurd.
• missing_scope, not_in_channel, Forbidden, 401/403 → probleem met kanaalauthenticatie/-machtigingen.

Gerelateerd:

• Kanaalprobleemoplossing
• Discord
• Telegram
• WhatsApp

Cron- en Heartbeat-bezorging

Als cron of heartbeat niet heeft gedraaid of niet is bezorgd, verifieer dan eerst de schedulerstatus en daarna het bezorgdoel.

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

Let op:

• Cron ingeschakeld en volgende activering aanwezig.
• Status van taakuitvoeringsgeschiedenis (ok, skipped, error).
• Redenen voor overgeslagen Heartbeat (quiet-hours, requests-in-flight, cron-in-progress, lanes-busy, alerts-disabled, empty-heartbeat-file, no-tasks-due).

Gerelateerd:

• Heartbeat
• Geplande taken
• Geplande taken: probleemoplossing

Node gekoppeld, tool mislukt

Als een Node gekoppeld is maar tools mislukken, isoleer dan voorgrond-, toestemmings- en goedkeuringsstatus.

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

Let op:

• Node online met verwachte mogelijkheden.
• OS-toestemmingen voor camera/microfoon/locatie/scherm.
• Exec-goedkeuringen en allowlist-status.

Veelvoorkomende signalen:

• NODE_BACKGROUND_UNAVAILABLE → Node-app moet op de voorgrond staan.
• *_PERMISSION_REQUIRED / LOCATION_PERMISSION_REQUIRED → ontbrekende OS-toestemming.
• SYSTEM_RUN_DENIED: approval required → exec-goedkeuring in behandeling.
• SYSTEM_RUN_DENIED: allowlist miss → opdracht geblokkeerd door allowlist.

Gerelateerd:

• Exec-goedkeuringen
• Node-probleemoplossing
• Nodes

Browsertool mislukt

Gebruik dit wanneer acties van de browsertool mislukken, ook al is de Gateway zelf gezond.

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

Let op:

• Of plugins.allow is ingesteld en browser bevat.
• Geldig pad naar browseruitvoerbaar bestand.
• Bereikbaarheid van CDP-profiel.
• Beschikbaarheid van lokale Chrome voor existing-session- / user-profielen.

Gerelateerd:

• Browser (beheerd door OpenClaw)
• Browser-probleemoplossing

Als je hebt geüpgraded en er plotseling iets stukging

De meeste breuken na een upgrade zijn configuratiedrift of strengere defaults die nu worden afgedwongen.

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

Als serviceconfiguratie en runtime na controles nog steeds niet overeenkomen, installeer dan servicemetadata opnieuw vanuit dezelfde profiel-/statusmap:

openclaw gateway install --forceopenclaw gateway restart

Gerelateerd:

• Authenticatie
• Achtergrond-exec en procestool
• Gateway-beheerde koppeling

Gerelateerd

• Doctor
• FAQ
• Gateway-runbook