Aide

FAQ

Réponses rapides plus un dépannage approfondi pour des configurations réelles (développement local, VPS, multi-agent, OAuth/clés API, basculement de modèle). Pour les diagnostics d'exécution, consultez Dépannage. Pour la référence complète de configuration, consultez Configuration.

Table des matières

Premières 60 secondes si quelque chose est cassé

  1. Statut rapide (première vérification)

    Copier

    openclaw status

    Résumé local rapide : OS + mise à jour, accessibilité du service/gateway, agents/sessions, configuration du fournisseur + problèmes d'exécution (quand la gateway est accessible).

  2. Rapport collable (sûr à partager)

    Copier

    openclaw status --all

    Diagnostic en lecture seule avec queue de journal (jetons masqués).

  3. État du démon + du port

    Copier

    openclaw gateway status

    Affiche l'exécution du superviseur vs l'accessibilité RPC, l'URL cible de la sonde, et quelle configuration le service a probablement utilisé.

  4. Sondes approfondies

    Copier

    openclaw status --deep

    Exécute les vérifications de santé de la gateway + les sondes des fournisseurs (nécessite une gateway accessible). Voir Santé.

  5. Suivre le dernier journal

    Copier

    openclaw logs --follow

    Si le RPC est hors service, revenez à :

    Copier

    tail -f "$(ls -t /tmp/openclaw/openclaw-*.log | head -1)"

    Les journaux de fichiers sont séparés des journaux du service ; voir Journalisation et Dépannage.

  6. Exécuter le docteur (réparations)

    Copier

    openclaw doctor

    Répare/migre la configuration/état + exécute les vérifications de santé. Voir Docteur.

  7. Instantané de la Gateway

    Copier

    openclaw health --json
openclaw health --verbose   # montre l'URL cible + le chemin de configuration en cas d'erreurs

    Demande à la gateway en cours d'exécution un instantané complet (WS uniquement). Voir Santé.

Démarrage rapide et configuration initiale

Je suis bloqué, quel est le moyen le plus rapide de me débloquer

Utilisez un agent d'IA local qui peut voir votre machine. C'est bien plus efficace que de demander sur Discord, car la plupart des cas "Je suis bloqué" sont des problèmes de configuration ou d'environnement locaux que les assistants à distance ne peuvent pas inspecter.

Ces outils peuvent lire le dépôt, exécuter des commandes, inspecter les journaux et aider à résoudre votre configuration au niveau de la machine (PATH, services, permissions, fichiers d'authentification). Donnez-leur le dépôt source complet via l'installation hackable (git) :

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git

Cela installe OpenClaw à partir d'un dépôt git, afin que l'agent puisse lire le code + la documentation et raisonner sur la version exacte que vous exécutez. Vous pouvez toujours revenir à la version stable plus tard en réexécutant l'installateur sans --install-method git. Astuce : demandez à l'agent de planifier et superviser la réparation (étape par étape), puis exécutez uniquement les commandes nécessaires. Cela garde les modifications petites et plus faciles à auditer. Si vous découvrez un vrai bug ou une correction, veuillez ouvrir un problème GitHub ou envoyer une PR : https://github.com/openclaw/openclaw/issues https://github.com/openclaw/openclaw/pulls Commencez par ces commandes (partagez les sorties lorsque vous demandez de l'aide) :

openclaw status
openclaw models status
openclaw doctor

Ce qu'elles font :

  • openclaw status : instantané rapide de la santé de la gateway/agent + configuration de base.
  • openclaw models status : vérifie l'authentification du fournisseur + la disponibilité des modèles.
  • openclaw doctor : valide et répare les problèmes courants de configuration/état.

Autres vérifications CLI utiles : openclaw status --all, openclaw logs --follow, openclaw gateway status, openclaw health --verbose. Boucle de débogage rapide : [Premières 60 secondes si quelque chose est cassé](#first-