Dépannage
Solutions aux problèmes les plus courants lors de la configuration et de l’utilisation quotidienne.
Commencez par ceci : relancez la commande avec la sortie de débogage activée. Les détails supplémentaires indiquent généralement ce qui ne va pas.
OFFICECLAWS_DEBUG=1 officeclaws <command>Compte et abonnement
This account has no active subscription
Exécutez officeclaws subscribe et finalisez le paiement. Attendez une minute, puis relancez officeclaws onboard. Si vous avez payé sur le site web avec une autre adresse e-mail, contactez le support afin que nous associions le paiement à votre compte.
not logged in — run: officeclaws login
Exécutez officeclaws login.
Contabo
contabo: … après la saisie des identifiants
L’une des quatre valeurs est incorrecte. L’erreur la plus fréquente consiste à utiliser le mot de passe du site au lieu de l’API password distinct. Voir l’étape 4.
no VPSes found on your account
Le serveur n’a pas encore été livré, ou les identifiants appartiennent à un autre compte Contabo. Vérifiez que le serveur apparaît comme actif sur my.contabo.com.
La configuration reste bloquée sur « Waiting for the VPS » depuis longtemps Pendant la configuration, Office Claws installe sa clé SSH via Contabo, puis Contabo redémarre le serveur. Cela peut prendre jusqu’à 30 minutes. Ne l’interrompez pas. Si vous l’arrêtez en cours de route, Contabo peut verrouiller le serveur pendant 5 à 15 minutes supplémentaires.
Tailscale
Tailscale daemon is not running
Ouvrez l’application Tailscale et connectez-vous, puis réessayez.
Erreurs de clé d’authentification (invalid key, API key does not exist)
La clé a expiré, a été révoquée, ou était à usage unique et a déjà été utilisée. Créez une nouvelle clé réutilisable et exécutez officeclaws onboard --tailscale-authkey tskey-auth-….
L’agent apparaît offline ou la discussion indique qu’elle ne peut pas se connecter
- Vérifiez que Tailscale est connecté sur votre ordinateur :
tailscale status. - Vérifiez que le serveur de l’agent apparaît dans votre tailnet. Il est listé sur login.tailscale.com/admin/machines.
- Votre ordinateur et l’agent doivent se trouver dans le même tailnet.
- Vérifiez dans le panneau Contabo que le VPS est en fonctionnement.
- Cela fonctionnait depuis des mois puis s’est arrêté ? La clé Tailscale du serveur a probablement expiré. Connectez-vous au VPS via la console VNC de Contabo en tant que
root, avec le mot de passe root défini lors de la commande du serveur (l’utilisateuropenclawne peut pas y utilisersudo), et exécuteztailscale up. Ou repartez d’un serveur vierge, voir Gérer les agents. Pour éviter que cela se reproduise, désactivez l’expiration de la clé.
Agent et discussion
L’agent ne répond pas, ou vous voyez rpc final event had no text ou des déconnexions
Vous avez très probablement atteint la limite d’utilisation Codex de votre offre ChatGPT. Attendez sa réinitialisation ou passez à une offre ChatGPT supérieure. Si le message indique que l’agent n’est connecté à aucun modèle, exécutez officeclaws connect-codex.
1008 pairing required
Exécutez officeclaws pairing repair.
La connexion Codex expire
Terminez la connexion en moins de 5 minutes, dans un navigateur sur le même ordinateur. Puis exécutez à nouveau officeclaws connect-codex.
Le bot Telegram ne répond pas
- Exécutez
officeclaws telegram showet vérifiez qu’il afficheenabled : true. - Avec le mode
pairing, vous devez d’abord approuver votre compte. Voir Telegram. - Assurez-vous qu’aucun autre programme n’utilise le même token de bot.
Toujours bloqué ?
- Rassemblez les journaux :
- Votre agent :
officeclaws logs --lines 500 - La configuration : le fichier le plus récent dans
~/.openclaw/logssur votre ordinateur
- Votre agent :
- Écrivez-nous sur Telegram : t.me/getfrontendeddm. Indiquez la commande exécutée, l’erreur et les journaux. Retirez d’abord toutes les clés, tous les tokens et tous les mots de passe.