Dépannage ClawHub

La plupart des pannes ClawHub deviennent lisibles dès qu’on sait laquelle d’une poignée de formes on regarde. Voici la liste complète, dans l’ordre où vous risquez de les rencontrer, avec le détail distinctif de chacune plutôt qu’un conseil de réessai générique.

Connexion et autorisation

• Si la connexion reste en attente, ouvrez l’URL de vérification imprimée par le CLI, connectez-vous avec GitHub et autorisez le code affiché. Un navigateur sur un autre appareil fonctionne, car aucun rappel localhost n’est en jeu.
• Si le code expire, relancez simplement la connexion ; pour un usage sans surveillance, créez un jeton d’API dans les réglages et passez-le directement à la connexion.
• Un 401 sur whoami ou publish veut dire se reconnecter, et si vous utilisez un chemin de configuration personnalisé, vérifiez qu’il pointe sur le fichier contenant votre jeton actuel.
• Un 401 qui survit à une reconnexion signifie en général que le jeton d’API a été révoqué dans l’interface web, ce que le CLI ne peut pas savoir avant d’essayer.

Si de nombreux utilisateurs partagent une même IP de sortie, les limites anonymes par IP peuvent être atteintes même si chacun n’envoie que quelques requêtes.

Le 429 que vous n’avez pas mérité

Cette citation décrit la panne la plus utile à reconnaître, parce que c’est celle où votre propre comportement n’est pas en cause. Derrière un réseau d’entreprise partagé, un VPN ou un parc d’exécuteurs d’intégration continue, tout le monde n’est qu’une seule IP du point de vue du limiteur anonyme, et quelques requêtes chacun finissent par former une limite que personne n’a déclenchée individuellement. La solution est de se connecter quand c’est possible, ce qui bascule vers un budget par utilisateur, et sinon de lire les en-têtes et d’attendre le délai annoncé.

Lire l’information de réessai

• Retry-After donne les secondes à attendre, et c’est la valeur à préférer quand elle est présente.
• RateLimit-Limit est la limite appliquée à cette requête, et RateLimit-Remaining votre budget restant exact quand l’en-tête est là, lequel vaut zéro sur un 429.
• RateLimit-Reset ou son jumeau préfixé porte le moment de réinitialisation, et les deux sont dans des unités différentes : lisez celui que vous analysez vraiment.

Une requête qui échoue derrière un proxy d’entreprise ne demande en général aucune correction propre à ClawHub : le CLI honore les variables de proxy standard dans leurs graphies majuscules comme minuscules, donc exporter la bonne est tout le changement. Pour les conventions que suivent ces en-têtes, voir L’API ClawHub, et pour le client qui émet ces requêtes, Le CLI ClawHub.

Absente de la recherche, ou rejetée à la publication

Une compétence absente de la recherche n’a pas forcément disparu. Vérifiez l’identifiant exact ou la page du propriétaire, puis confirmez que la publication est publique et non retenue par l’analyse ou la modération, car une retenue masque une fiche des surfaces de recherche et d’installation sans la supprimer. Si elle vous appartient, connectez-vous et inspectez-la : les diagnostics visibles du propriétaire expliquent l’état d’analyse, de porte de téléversement et de modération, qu’un appelant public ne voit jamais. Une publication rejetée pour métadonnées manquantes renvoie à l’en-tête, où les variables d’environnement et les outils requis doivent être déclarés pour que les utilisateurs comme les analyseurs comprennent le paquet. Voir Le format de compétence ClawHub et Modération et tenue de compte ClawHub.

Sur Diali

Sur Diali, la plupart de ces pannes ne vous atteignent jamais, car l’assistant est déjà connecté et tourne déjà. Chaque client fait tourner sa propre instance, la configuration d’exécution est générée depuis le tableau de bord et remplacée à chaque version, et l’état vit sur un volume persistant, avec des instantanés quotidiens et une restauration en un clic grâce à l’option Sauvegardes (incluse avec Max). Voir OpenClaw hébergé sur Diali pour ce que l’hébergement comprend et Tarifs Diali pour ce qu’il coûte.

• Un 429 sur un réseau partagé n’est en général pas votre trafic.
• Connectez-vous pour passer d’un budget par IP à un budget par utilisateur.
• Absente de la recherche veut souvent dire retenue, pas supprimée.