L'agent ne repond pas

Symptomes#

Vous envoyez un message dans le chat et vous n'avez pas de reponse, vous voyez une erreur, ou le chat est desactive.

Message "Agent not ready"#

Votre bureau est encore en train de demarrer. L'agent IA est le dernier service a se lancer.

Pourquoi#

Le demarrage se fait en plusieurs phases. Votre bureau peut afficher running et meme avoir un affichage VNC fonctionnel, mais l'agent n'est disponible qu'une fois que le gateway OpenClaw a fini de demarrer sur le port 18789. Ca prend environ 60 secondes apres la creation de la VM, bien apres que le VNC et le terminal soient deja la.

Quoi faire#

Patientez. C'est le comportement normal pendant les 60 premieres secondes. Le chat s'active automatiquement quand l'agent est pret. Si ca fait plus de deux minutes, arretez et relancez le bureau.

Erreur "Gateway agent failed; falling back"#

Le processus gateway OpenClaw a plante ou n'a jamais demarre.

Causes possibles#

La cause la plus frequente est une cle API invalide. Si la cle fournie a la creation du bureau est invalide, expiree ou n'a pas les bonnes permissions, le gateway ne peut pas s'authentifier aupres du provider.

Si vous avez choisi un modele indisponible chez votre provider, ou si l'identifiant du modele est incorrect, le gateway ne peut pas non plus demarrer de conversation.

Une panne du provider (Anthropic, OpenAI, OpenRouter) provoque aussi cette erreur.

Quoi faire#

1. Verifiez votre cle API sur le tableau de bord du provider. Confirmez qu'elle est active et qu'il reste des credits.
2. Consultez la page de statut du provider pour les incidents en cours.
3. Essayez le modele par defaut pour ecarter un probleme de disponibilite.
4. Si la cle etait incorrecte a la creation, supprimez le bureau et recreez-en un avec une cle valide. La configuration du provider est injectee au demarrage et ne peut pas etre modifiee apres.

Les messages n'obtiennent aucune reponse#

Vous envoyez un message, il s'affiche dans le chat, mais rien ne revient. Pas d'erreur, pas de reponse.

Causes possibles#

Si vous avez envoye beaucoup de messages d'un coup, le provider limite peut-etre vos requetes. C'est frequent avec les cles API gratuites.

Certaines taches (operations sur les fichiers, navigation web, raisonnement complexe) peuvent prendre 30 secondes ou plus. L'agent travaille peut-etre encore.

Le processus OpenClaw peut aussi avoir plante silencieusement. Ca arrive quand la VM manque de memoire.

Quoi faire#

1. Attendez 30 secondes. L'agent est peut-etre encore en train de traiter.
2. Envoyez un message court comme "bonjour" pour verifier si l'agent repond.
3. Ouvrez le terminal et cherchez des erreurs du processus agent.
4. Arretez et relancez le bureau pour obtenir un processus agent neuf.

Configuration du provider requise#

Aucune cle API n'a ete definie a la creation du bureau.

Quoi faire#

On ne peut pas ajouter une cle API a un bureau deja lance. Supprimez-le et recreez-en un avec :

1. Un provider AI selectionne (Anthropic, OpenAI ou OpenRouter)
2. Une cle API valide
3. Un modele choisi

Les trois sont obligatoires.

Eviter les problemes d'agent#

• Testez votre cle API sur le site du provider avant de l'utiliser dans Le Bureau
• Gardez votre cle alimentee en credits. La plupart des echecs viennent de credits epuises.
• Commencez avec un modele fiable (Claude Sonnet, GPT-4o) avant d'en essayer d'autres
• Laissez 60 secondes au bureau apres sa creation avant d'utiliser le chat