English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Start here

Algemene probleemoplossing

Als u maar 2 minuten hebt, gebruik deze pagina dan als triage-ingang.

Eerste 60 seconden

Voer deze exacte ladder op volgorde uit:

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

Goede uitvoer in één regel:

  • openclaw status → toont geconfigureerde kanalen en geen duidelijke verificatiefouten.
  • openclaw status --all → volledig rapport is aanwezig en deelbaar.
  • openclaw gateway probe → het verwachte gatewaydoel is bereikbaar (Reachable: yes). Capability: ... vertelt welk verificatieniveau de probe kon aantonen, en Read probe: limited - missing scope: operator.read is beperkte diagnostiek, geen verbindingsfout.
  • openclaw gateway status → Runtime: running, Connectivity probe: ok, en een plausibele Capability: ...-regel. Gebruik --require-rpc als u ook RPC-bewijs met lees-scope nodig hebt.
  • openclaw doctor → geen blokkerende configuratie- of servicefouten.
  • openclaw channels status --probe → bereikbare Gateway retourneert live transportstatus per account plus probe-/auditresultaten zoals works of audit ok; als de Gateway onbereikbaar is, valt de opdracht terug op alleen-configuratie-samenvattingen.
  • openclaw logs --follow → stabiele activiteit, geen herhalende fatale fouten.

Anthropic lange context 429

Als u dit ziet: HTTP 429: rate_limit_error: Extra usage is required for long context requests, ga naar /gateway/troubleshooting#anthropic-429-extra-usage-required-for-long-context.

Lokale OpenAI-compatibele backend werkt rechtstreeks maar faalt in OpenClaw

Als uw lokale of zelfgehoste /v1-backend kleine directe /v1/chat/completions-probes beantwoordt maar faalt bij openclaw infer model run of normale agentbeurten:

  1. Als de fout meldt dat messages[].content een tekenreeks verwacht, stel dan models.providers.<provider>.models[].compat.requiresStringContent: true in.
  2. Als de backend nog steeds alleen bij OpenClaw-agentbeurten faalt, stel dan models.providers.<provider>.models[].compat.supportsTools: false in en probeer opnieuw.
  3. Als kleine directe aanroepen nog steeds werken maar grotere OpenClaw-prompts de backend laten crashen, behandel het resterende probleem dan als een beperking van het upstream model/de upstream server en ga verder in het diepgaande runbook: /gateway/troubleshooting#local-openai-compatible-backend-passes-direct-probes-but-agent-runs-fail

Plugininstallatie faalt door ontbrekende openclaw-extensies

Als installatie faalt met package.json missing openclaw.extensions, gebruikt het pluginpakket een oude vorm die OpenClaw niet meer accepteert.

Los dit op in het pluginpakket:

  1. Voeg openclaw.extensions toe aan package.json.
  2. Laat vermeldingen verwijzen naar gebouwde runtimebestanden (meestal ./dist/index.js).
  3. Publiceer de Plugin opnieuw en voer openclaw plugins install <package> opnieuw uit.

Voorbeeld:

{
  "name": "@openclaw/my-plugin",
  "version": "1.2.3",
  "openclaw": {
    "extensions": ["./dist/index.js"]
  }
}

Referentie: Pluginarchitectuur

Plugin aanwezig maar geblokkeerd door verdachte eigendom

Als openclaw doctor, setup of opstartwaarschuwingen dit tonen:

blocked plugin candidate: suspicious ownership (... uid=1000, expected uid=0 or root)
plugin present but blocked

zijn de pluginbestanden eigendom van een andere Unix-gebruiker dan het proces dat ze laadt. Verwijder de pluginconfiguratie niet. Herstel het bestandseigendom of voer OpenClaw uit als dezelfde gebruiker die eigenaar is van de statusmap.

Docker-installaties draaien normaal als node (uid 1000). Herstel voor de standaard Docker- setup de host-bindmounts:

sudo chown -R 1000:1000 /path/to/openclaw-config /path/to/openclaw-workspace
openclaw doctor --fix

Als u OpenClaw bewust als root uitvoert, herstel dan in plaats daarvan de beheerde pluginroot naar root-eigendom:

sudo chown -R root:root /path/to/openclaw-config/npm
openclaw doctor --fix

Diepere documentatie:

Beslisboom

flowchart TD
  A[OpenClaw werkt niet] --> B{Wat gaat als eerste mis}
  B --> C[Geen antwoorden]
  B --> D[Dashboard of Control UI maakt geen verbinding]
  B --> E[Gateway start niet of service draait niet]
  B --> F[Kanaal maakt verbinding maar berichten stromen niet]
  B --> G[Cron of Heartbeat is niet geactiveerd of niet afgeleverd]
  B --> H[Node is gekoppeld maar camera canvas screen exec faalt]
  B --> I[Browsertool faalt]

  C --> C1[/Sectie Geen antwoorden/]
  D --> D1[/Sectie Control UI/]
  E --> E1[/Sectie Gateway/]
  F --> F1[/Sectie Kanaalstroom/]
  G --> G1[/Sectie Automatisering/]
  H --> H1[/Sectie Node-tools/]
  I --> I1[/Sectie Browser/]
No replies 
openclaw status
openclaw gateway status
openclaw channels status --probe
openclaw pairing list --channel <channel> [--account <id>]
openclaw logs --follow

Goede uitvoer ziet er als volgt uit:

  • Runtime: running
  • Connectivity probe: ok
  • Capability: read-only, write-capable, of admin-capable
  • Uw kanaal toont dat transport verbonden is en, waar ondersteund, works of audit ok in channels status --probe
  • Afzender lijkt goedgekeurd (of DM-beleid staat open/is een toestemmingslijst)

Veelvoorkomende logsignaturen:

  • drop guild message (mention required → mention-gating blokkeerde het bericht in Discord.
  • pairing request → afzender is niet goedgekeurd en wacht op goedkeuring voor DM-koppeling.
  • blocked / allowlist in kanaallogs → afzender, ruimte of groep wordt gefilterd.

Diepere pagina's:

Dashboard or Control UI will not connect 
openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe

Goede uitvoer ziet er als volgt uit:

  • Dashboard: http://... wordt getoond in openclaw gateway status
  • Connectivity probe: ok
  • Capability: read-only, write-capable, of admin-capable
  • Geen verificatielus in logs

Veelvoorkomende logsignaturen:

  • device identity required → HTTP/niet-beveiligde context kan apparaatverificatie niet voltooien.
  • origin not allowed → browser-Origin is niet toegestaan voor het Gatewaydoel van de Control UI.
  • AUTH_TOKEN_MISMATCH met retry-hints (canRetryWithDeviceToken=true) → één vertrouwde retry met apparaattoken kan automatisch plaatsvinden.
  • Die cached-token-retry hergebruikt de gecachte scope-set die bij het gekoppelde apparaattoken is opgeslagen. Aanroepers met expliciete deviceToken / expliciete scopes behouden in plaats daarvan hun aangevraagde scope-set.
  • Op het asynchrone Tailscale Serve Control UI-pad worden mislukte pogingen voor dezelfde {scope, ip} geserialiseerd voordat de limiter de fout registreert, waardoor een tweede gelijktijdige slechte retry al retry later kan tonen.
  • too many failed authentication attempts (retry later) vanaf een localhost- browserorigin → herhaalde fouten vanaf diezelfde Origin worden tijdelijk geblokkeerd; een andere localhost-origin gebruikt een aparte bucket.
  • herhaald unauthorized na die retry → verkeerd token/wachtwoord, mismatch in verificatiemodus of verouderd gekoppeld apparaattoken.
  • gateway connect failed: → UI richt zich op de verkeerde URL/poort of een onbereikbare Gateway.

Diepere pagina's:

Gateway will not start or service installed but not running 
openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe

Goede uitvoer ziet er als volgt uit:

  • Service: ... (loaded)
  • Runtime: running
  • Connectivity probe: ok
  • Capability: read-only, write-capable, of admin-capable

Veelvoorkomende logsignaturen:

  • Gateway start blocked: set gateway.mode=local of existing config is missing gateway.mode → gatewaymodus is remote, of het configuratiebestand mist de local-mode-stempel en moet worden hersteld.
  • refusing to bind gateway ... without auth → non-loopback-bind zonder geldig Gateway-verificatiepad (token/wachtwoord, of trusted-proxy waar geconfigureerd).
  • another gateway instance is already listening of EADDRINUSE → poort is al in gebruik.

Diepere pagina's:

Channel connects but messages do not flow 
openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe

Goede uitvoer ziet er als volgt uit:

  • Kanaaltransport is verbonden.
  • Koppelings-/allowlist-controles slagen.
  • Vermeldingen worden gedetecteerd waar vereist.

Veelvoorkomende logsignaturen:

  • mention required → groepsmention-gating blokkeerde verwerking.
  • pairing / pending → DM-afzender is nog niet goedgekeurd.
  • not_in_channel, missing_scope, Forbidden, 401/403 → probleem met kanaalmachtigingstoken.

Diepere pagina's:

Cron or heartbeat did not fire or did not deliver 
openclaw status
openclaw gateway status
openclaw cron status
openclaw cron list
openclaw cron runs --id <jobId> --limit 20
openclaw logs --follow

Goede uitvoer ziet er als volgt uit:

  • cron.status toont ingeschakeld met een volgende wake.
  • cron runs toont recente ok-vermeldingen.
  • Heartbeat is ingeschakeld en valt niet buiten actieve uren.

Veelvoorkomende logsignaturen:

  • cron: scheduler disabled; jobs will not run automatically → Cron is uitgeschakeld.
  • heartbeat skipped met reason=quiet-hours → buiten geconfigureerde actieve uren.
  • heartbeat skipped met reason=empty-heartbeat-file → HEARTBEAT.md bestaat maar bevat alleen lege/header-only scaffolding.
  • heartbeat skipped met reason=no-tasks-due → taakmodus van HEARTBEAT.md is actief, maar geen van de taakintervallen is al aan de beurt.
  • heartbeat skipped met reason=alerts-disabled → alle Heartbeat-zichtbaarheid is uitgeschakeld (showOk, showAlerts en useIndicator staan allemaal uit).
  • requests-in-flight → hoofdlane bezig; Heartbeat-wake is uitgesteld.
  • unknown accountId → doelaccount voor Heartbeat-aflevering bestaat niet.

Diepere pagina's:

Node is paired but tool fails camera canvas screen exec 
openclaw status
openclaw gateway status
openclaw nodes status
openclaw nodes describe --node <idOrNameOrIp>
openclaw logs --follow

Goede uitvoer ziet er als volgt uit:

  • Node wordt vermeld als verbonden en gekoppeld voor rol node.
  • Capability bestaat voor de opdracht die u aanroept.
  • Machtigingsstatus is verleend voor de tool.

Veelvoorkomende logsignaturen:

  • NODE_BACKGROUND_UNAVAILABLE → breng de Node-app naar de voorgrond.
  • *_PERMISSION_REQUIRED → OS-toestemming is geweigerd of ontbreekt.
  • SYSTEM_RUN_DENIED: approval required → exec-goedkeuring is in behandeling.
  • SYSTEM_RUN_DENIED: allowlist miss → opdracht staat niet op de exec-allowlist.

Diepgaande pagina's:

Exec vraagt plots om goedkeuring 
openclaw config get tools.exec.host
openclaw config get tools.exec.security
openclaw config get tools.exec.ask
openclaw gateway restart

Wat is gewijzigd:

  • Als tools.exec.host niet is ingesteld, is de standaardwaarde auto.
  • host=auto wordt omgezet naar sandbox wanneer een sandboxruntime actief is, anders naar gateway.
  • host=auto bepaalt alleen de routering; het promptloze "YOLO"-gedrag komt van security=full plus ask=off op gateway/node.
  • Op gateway en node gebruikt een niet-ingestelde tools.exec.security standaard full.
  • Een niet-ingestelde tools.exec.ask gebruikt standaard off.
  • Resultaat: als je goedkeuringen ziet, heeft een host-lokaal of sessiespecifiek beleid exec aangescherpt ten opzichte van de huidige standaardwaarden.

Herstel het huidige standaardgedrag zonder goedkeuring:

openclaw config set tools.exec.host gateway
openclaw config set tools.exec.security full
openclaw config set tools.exec.ask off
openclaw gateway restart

Veiligere alternatieven:

  • Stel alleen tools.exec.host=gateway in als je alleen stabiele hostroutering wilt.
  • Gebruik security=allowlist met ask=on-miss als je host-exec wilt maar nog steeds beoordeling wilt bij allowlist-misses.
  • Schakel sandboxmodus in als je wilt dat host=auto weer naar sandbox wordt omgezet.

Veelvoorkomende logsignaturen:

  • Approval required. → opdracht wacht op /approve ....
  • SYSTEM_RUN_DENIED: approval required → node-host exec-goedkeuring is in behandeling.
  • exec host=sandbox requires a sandbox runtime for this session → impliciete/expliciete sandboxselectie, maar sandboxmodus staat uit.

Diepgaande pagina's:

Browsertool faalt 
openclaw status
openclaw gateway status
openclaw browser status
openclaw logs --follow
openclaw doctor

Goede uitvoer ziet er zo uit:

  • Browserstatus toont running: true en een gekozen browser/profiel.
  • openclaw start, of user kan lokale Chrome-tabbladen zien.

Veelvoorkomende logsignaturen:

  • unknown command "browser" of unknown command 'browser' → plugins.allow is ingesteld en bevat browser niet.
  • Failed to start Chrome CDP on port → lokale browserstart is mislukt.
  • browser.executablePath not found → geconfigureerd binair pad is onjuist.
  • browser.cdpUrl must be http(s) or ws(s) → de geconfigureerde CDP-URL gebruikt een niet-ondersteund schema.
  • browser.cdpUrl has invalid port → de geconfigureerde CDP-URL heeft een ongeldige poort of een poort buiten het toegestane bereik.
  • No Chrome tabs found for profile="user" → het Chrome MCP-koppelprofiel heeft geen geopende lokale Chrome-tabbladen.
  • Remote CDP for profile "<name>" is not reachable → het geconfigureerde externe CDP-eindpunt is niet bereikbaar vanaf deze host.
  • Browser attachOnly is enabled ... not reachable of Browser attachOnly is enabled and CDP websocket ... is not reachable → attach-only-profiel heeft geen actief CDP-doel.
  • verouderde viewport-/dark-mode-/locale-/offline-overschrijvingen op attach-only- of externe CDP-profielen → voer openclaw browser stop --browser-profile <name> uit om de actieve besturingssessie te sluiten en de emulatiestatus vrij te geven zonder de gateway opnieuw te starten.

Diepgaande pagina's:

Gerelateerd