L'agent ne répond pas

Symptômes#

Vous envoyez un message dans le chat et vous n'avez pas de réponse, vous voyez une erreur, ou le chat est désactivé.

Message "Démarrage de l'agent..."#

Votre bureau est encore en train de démarrer, et l'en-tête du chat affiche "Démarrage de l'agent..." jusqu'à ce que son agent soit prêt. L'agent IA est le dernier service à se lancer.

Pourquoi#

Le démarrage se fait en plusieurs phases. Votre bureau peut afficher running et même avoir un affichage VNC fonctionnel, mais l'agent n'est disponible qu'une fois son initialisation terminée. Un nouveau bureau tourne en général, agent compris, environ 2 minutes après sa création, bien après que le VNC et le terminal soient déjà là.

Le processus d'initialisation diffère selon le type d'agent, mais chacun (OpenClaw, Claude Code, Hermes Agent, Codex et Grok) doit être complètement démarré avant que le chat soit disponible.

Quoi faire#

Patientez. C'est normal jusqu'à environ 2 minutes après la création du bureau. Le chat s'active automatiquement quand l'agent est prêt. Vers 3 minutes, la barre d'outils peut afficher "Le démarrage prend plus de temps que prévu." Ce message seul ne justifie pas de relancer votre bureau. Si l'agent n'est toujours pas prêt 4 minutes après la création, arrêtez et relancez votre bureau.

Un bureau Grok fait exception : il attend que vous vous connectiez avec votre compte xAI, et son chat affiche une carte "Connectez-vous à Grok" au lieu de ce message. Connectez-vous depuis cette carte, sans relancer votre bureau : un redémarrage ramène la même carte.

Message "L'agent n'a pas démarré"#

Votre bureau tourne, mais son agent n'a pas fini de démarrer : il ne peut pas vous répondre. La barre d'outils et le panneau de chat affichent "L'agent n'a pas démarré", et une carte au-dessus de la zone de saisie du chat en donne la cause.

Ce que dit la carte#

• "Aucun compte connecté" : l'agent n'a aucun compte pour fonctionner. Connectez-en un avec le bouton de la carte, ou dans les Paramètres.
• "Aucune clé API" : votre bureau fonctionne avec votre propre clé API de fournisseur, et il n'en a aucune. Une clé se fournit à la création d'un bureau : créez un nouveau bureau avec votre clé.
• "Compte refusé" : le fournisseur a refusé le compte utilisé au démarrage de l'agent. Reconnectez-le, ou passez à un autre.
• "Clé API refusée" : le fournisseur a refusé la clé API fournie à la création de votre bureau. Une clé ne peut pas être changée sur un bureau lancé : créez un nouveau bureau avec une clé valide.
• "Quota du compte atteint" : le compte n'a plus de requêtes disponibles chez son fournisseur. Changez de compte, ou redémarrez votre bureau une fois le quota réinitialisé.
• "Quota de la clé API atteint" : la clé API n'a plus de requêtes disponibles chez son fournisseur. Redémarrez votre bureau une fois le quota réinitialisé, ou créez un nouveau bureau avec une autre clé.
• "Quota xAI atteint" : le compte xAI utilisé par votre bureau n'a plus de requêtes disponibles. Redémarrez votre bureau une fois son quota réinitialisé, ou créez un nouveau bureau et connectez-vous-y avec un autre compte xAI.
• "L'agent n'a pas pu démarrer" : le texte de la carte précise le cas. Si votre compte est valide et que l'agent n'a pas pu joindre de modèle, la panne est de notre côté. Si la cause ne peut pas être identifiée d'ici, vérifiez auprès de votre fournisseur le compte ou la clé API utilisés par votre bureau ; sur un bureau Grok, redémarrez votre bureau, puis créez un nouveau bureau si la carte revient. Si la page ne reconnaît pas la raison, rechargez la page.

Quoi faire#

1. Faites ce que la liste ci-dessus indique pour votre carte. Si la carte affiche un bouton, utilisez-le.
2. Si la carte indique que la panne est de notre côté, ou si la même carte revient après que vous avez agi, écrivez à contact@spinestudio.dev.

Une erreur à la place de la réponse#

L'agent a démarré, mais quelque chose a échoué pendant qu'il traitait votre message. Le chat affiche ce qui s'est passé, en rouge, à la place de la réponse. Par exemple :

• "The agent on this desktop can't connect to its AI provider, and the API key is likely missing, wrong or expired. Reconnect the account in Settings, or create a new desktop with a valid key."
• "The AI provider has no credits. Please add credits to your API key or contact your admin."

Faites ce que dit le message. Si votre bureau fonctionne avec un compte que vous avez connecté, reconnectez ce compte dans les paramètres. Une clé API de fournisseur donnée à un bureau à sa création ne peut pas être changée sur un bureau lancé : une clé incorrecte demande donc un nouveau bureau.

Quand l'erreur vous dit de vérifier avant de renvoyer le message, faites-le d'abord. L'agent avait déjà commencé à traiter votre message : une partie du travail est peut-être faite, et le renvoyer pourrait l'exécuter deux fois.

Les messages n'obtiennent aucune réponse#

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

Causes possibles#

Si vous avez envoyé beaucoup de messages d'un coup, le provider limite peut-être vos requêtes. C'est fréquent avec les clés API gratuites.

Certaines tâches (opérations sur les fichiers, navigation web, raisonnement complexe) peuvent prendre 30 secondes ou plus. L'agent travaille peut-être encore.

Le processus agent peut aussi avoir planté silencieusement. Ça arrive quand la VM manque de mémoire.

Quoi faire#

1. Attendez 30 secondes. L'agent est peut-être encore en train de traiter.
2. Envoyez un message court comme "bonjour" pour vérifier si l'agent répond.
3. Ouvrez le terminal et cherchez des erreurs du processus agent.
4. Arrêtez et relancez votre bureau pour obtenir un processus agent neuf.

Dépannage par type d'agent#

OpenClaw#

• Si l'agent se comporte de manière inattendue, le soul file peut contenir des instructions qui entrent en conflit avec votre demande. Vous pouvez le consulter et le modifier depuis le terminal.
• Vérifiez que votre clé API est valide et qu'il reste des crédits sur le tableau de bord de votre provider.

Claude Code#

• Si l'agent ne répond pas, vérifiez le compte Claude ou la clé API Anthropic qu'il utilise.
• Claude Code fonctionne uniquement avec Anthropic. Il ne fonctionne pas avec OpenAI ou OpenRouter.

Hermes Agent#

• Si l'agent ne répond pas, vérifiez que votre clé API est valide et qu'il reste des crédits.
• Hermes Agent est auto-améliorant et peut prendre plus de temps sur les premières tâches pendant qu'il construit son contexte.

Codex#

• Si l'agent ne répond pas, vérifiez le compte ChatGPT ou la clé API OpenAI qu'il utilise.
• Quand son compte ChatGPT est hors quota, le chat affiche "Compte Codex hors quota". "Changer de compte ChatGPT" passe votre bureau sur un autre compte ; vous pouvez aussi attendre la réinitialisation du quota.

Grok#

• Un nouveau bureau Grok vous demande de vous connecter avant de pouvoir répondre : lancez la connexion depuis la carte "Connectez-vous à Grok" du chat et approuvez-la avec votre compte xAI.

Éviter les problèmes d'agent#

• Testez votre clé API sur le site du provider avant de l'utiliser dans SpineOS
• Gardez votre clé alimentée en crédits. La plupart des échecs viennent de crédits épuisés.
• Commencez avec un modèle fiable (Claude Sonnet, GPT-4o) avant d'en essayer d'autres
• Laissez environ 2 minutes au bureau après sa création avant d'utiliser le chat