Aide

Dépannage

Si vous n'avez que 2 minutes, utilisez cette page comme porte d'entrée de triage.

Premières 60 secondes

Exécutez cette échelle exacte dans l'ordre :

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

Un bon résultat en une ligne :

  • openclaw status → affiche les canaux configurés et aucune erreur d'authentification évidente.
  • openclaw status --all → le rapport complet est présent et partageable.
  • openclaw gateway probe → la cible de la passerelle attendue est joignable.
  • openclaw gateway status → Runtime: running et RPC probe: ok.
  • openclaw doctor → aucune erreur de configuration/service bloquante.
  • openclaw channels status --probe → les canaux rapportent connected ou ready.
  • openclaw logs --follow → activité régulière, pas d'erreurs fatales répétées.

Contexte long Anthropic 429

Si vous voyez : HTTP 429: rate_limit_error: Extra usage is required for long context requests, allez à /gateway/troubleshooting#anthropic-429-extra-usage-required-for-long-context.

L'installation du plugin échoue avec des extensions openclaw manquantes

Si l'installation échoue avec package.json missing openclaw.extensions, le package du plugin utilise un format ancien qu'OpenClaw n'accepte plus. Corrigez dans le package du plugin :

  1. Ajoutez openclaw.extensions au package.json.
  2. Pointez les entrées vers les fichiers d'exécution compilés (généralement ./dist/index.js).
  3. Republiez le plugin et exécutez openclaw plugins install <npm-spec> à nouveau.

Exemple :

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

Référence : /tools/plugin#distribution-npm

Arbre de décision

AideFAQ