---
read_when:
    - OpenClaw werkt niet en u hebt de snelste weg naar een oplossing nodig
    - Je wilt een triageproces voordat je in uitgebreide draaiboeken duikt
summary: Symptoomgerichte probleemoplossingshub voor OpenClaw
title: Algemene probleemoplossing
x-i18n:
    generated_at: "2026-05-06T09:18:01Z"
    model: gpt-5.5
    provider: openai
    source_hash: 624fa34cda3b440fa9cc636beb3fe6e3608a77a332933fa593097ebc556ac745
    source_path: help/troubleshooting.md
    workflow: 16
---

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

## Eerste 60 seconden

Voer deze exacte ladder op volgorde uit:

```bash
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](/nl/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](/nl/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:

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

Referentie: [Pluginarchitectuur](/nl/plugins/architecture)

## Plugin aanwezig maar geblokkeerd door verdachte eigendom

Als `openclaw doctor`, setup of opstartwaarschuwingen dit tonen:

```text
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:

```bash
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:

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

Diepere documentatie:

- [Eigendom van Plugin-pad](/nl/tools/plugin#blocked-plugin-path-ownership)
- [Docker-machtigingen](/nl/install/docker#permissions-and-eacces)

## Beslisboom

```mermaid
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/]
```

<AccordionGroup>
  <Accordion title="No replies">
    ```bash
    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:

    - [/gateway/troubleshooting#no-replies](/nl/gateway/troubleshooting#no-replies)
    - [/channels/troubleshooting](/nl/channels/troubleshooting)
    - [/channels/pairing](/nl/channels/pairing)

  </Accordion>

  <Accordion title="Dashboard or Control UI will not connect">
    ```bash
    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/troubleshooting#dashboard-control-ui-connectivity](/nl/gateway/troubleshooting#dashboard-control-ui-connectivity)
    - [/web/control-ui](/nl/web/control-ui)
    - [/gateway/authentication](/nl/gateway/authentication)

  </Accordion>

  <Accordion title="Gateway will not start or service installed but not running">
    ```bash
    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:

    - [/gateway/troubleshooting#gateway-service-not-running](/nl/gateway/troubleshooting#gateway-service-not-running)
    - [/gateway/background-process](/nl/gateway/background-process)
    - [/gateway/configuration](/nl/gateway/configuration)

  </Accordion>

  <Accordion title="Channel connects but messages do not flow">
    ```bash
    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:

    - [/gateway/troubleshooting#channel-connected-messages-not-flowing](/nl/gateway/troubleshooting#channel-connected-messages-not-flowing)
    - [/channels/troubleshooting](/nl/channels/troubleshooting)

  </Accordion>

  <Accordion title="Cron or heartbeat did not fire or did not deliver">
    ```bash
    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:

    - [/gateway/troubleshooting#cron-and-heartbeat-delivery](/nl/gateway/troubleshooting#cron-and-heartbeat-delivery)
    - [/automation/cron-jobs#troubleshooting](/nl/automation/cron-jobs#troubleshooting)
    - [/gateway/heartbeat](/nl/gateway/heartbeat)

  </Accordion>

  <Accordion title="Node is paired but tool fails camera canvas screen exec">
    ```bash
    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:

    - [/gateway/troubleshooting#node-paired-tool-fails](/nl/gateway/troubleshooting#node-paired-tool-fails)
    - [/nodes/troubleshooting](/nl/nodes/troubleshooting)
    - [/tools/exec-approvals](/nl/tools/exec-approvals)

  </Accordion>

  <Accordion title="Exec vraagt plots om goedkeuring">
    ```bash
    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:

    ```bash
    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:

    - [/tools/exec](/nl/tools/exec)
    - [/tools/exec-approvals](/nl/tools/exec-approvals)
    - [/gateway/security#what-the-audit-checks-high-level](/nl/gateway/security#what-the-audit-checks-high-level)

  </Accordion>

  <Accordion title="Browsertool faalt">
    ```bash
    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:

    - [/gateway/troubleshooting#browser-tool-fails](/nl/gateway/troubleshooting#browser-tool-fails)
    - [/tools/browser#missing-browser-command-or-tool](/nl/tools/browser#missing-browser-command-or-tool)
    - [/tools/browser-linux-troubleshooting](/nl/tools/browser-linux-troubleshooting)
    - [/tools/browser-wsl2-windows-remote-cdp-troubleshooting](/nl/tools/browser-wsl2-windows-remote-cdp-troubleshooting)

  </Accordion>

</AccordionGroup>

## Gerelateerd

- [FAQ](/nl/help/faq) — veelgestelde vragen
- [Gateway-probleemoplossing](/nl/gateway/troubleshooting) — Gateway-specifieke problemen
- [Doctor](/nl/gateway/doctor) — geautomatiseerde gezondheidscontroles en reparaties
- [Kanaalprobleemoplossing](/nl/channels/troubleshooting) — problemen met kanaalconnectiviteit
- [Automatiseringsprobleemoplossing](/nl/automation/cron-jobs#troubleshooting) — problemen met cron en Heartbeat