Questions fréquentes sur les clés API
Problème : Ma clé API ne fonctionne plus soudainement, comment appeler le modèle ?
Une clé API OpenClaw peut devenir invalide en raison d'une expiration, d'une révocation manuelle ou de limitations de sécurité. Connectez-vous d'abord à la console OpenClaw et vérifiez l'état de la clé dans la page « API Keys ». Si elle affiche « Inactive », générez une nouvelle clé et remplacez l'ancienne. Attention : chaque compte peut créer jusqu'à 5 clés valides. Pensez à supprimer les anciennes clés inutilisées lors des rotations fréquentes.
Problème : Comment diagnostiquer une erreur 401 lors de l'appel à l'API ?
Une erreur 401 indique un échec d'authentification. Assurez-vous que le champ « Authorization » de l'en-tête de la requête est au format « Bearer » et que la clé ne contient pas d'espaces superflus. Si vous stockez la clé dans une variable d'environnement, vérifiez l'orthographe du nom de la variable. De plus, les clés des comptes d'essai gratuit peuvent être automatiquement désactivées après la fin de la période d'essai ; vous devrez passer à un plan payant pour continuer à les utiliser.
Facturation et gestion des relevés
Problème : Pourquoi le montant de ma facture est-il plus élevé que prévu ?
OpenClaw facture par token, et les prix varient selon les modèles. Un dépassement peut provenir de : 1) l'utilisation d'un modèle haute précision (comme Claw-4) sans avoir vérifié son tarif unitaire ; 2) des requêtes contenant de nombreux system prompts ou historiques de conversation, ce qui augmente le nombre de tokens consommés. Nous vous recommandons de définir une limite « max_tokens » dans vos appels API et de consulter le détail de la consommation quotidienne/horaire dans la section « Usage » de la console. Si vous constatez un pic anormal, vérifiez que votre code ne contient pas de boucle erronée.
Problème : Comment demander une facture fiscale après un abonnement ?
Dans les paramètres de votre compte OpenClaw, accédez à la section « Billing », cliquez sur « Invoice History » et sélectionnez la facture concernée. Vous pouvez y renseigner le nom de votre entreprise, votre numéro de TVA et votre adresse de facturation. Notez que les comptes personnels ne peuvent générer que des factures individuelles ; après certification de l'entreprise, vous pouvez choisir des factures professionnelles. La facture est généralement envoyée à votre adresse e-mail sous 3 à 5 jours ouvrés après la demande.
Sécurité du compte et gestion des droits
Problème : Comment empêcher une utilisation abusive de ma clé API ?
OpenClaw propose une fonction de « liste blanche d'IP » : dans l'interface « Security », vous pouvez définir la plage d'adresses IP autorisées à appeler l'API. Si vous n'êtes pas sûr de votre IP, utilisez le mécanisme de « clé temporaire » en fixant une durée de validité (par exemple 1 heure). Par ailleurs, évitez d'écrire directement la clé API dans le code front-end ; préférez un proxy côté serveur. Consultez régulièrement les « API Logs » dans la console pour détecter des appels anormaux.
Problème : Comment débloquer mon compte après un verrouillage ?
Un verrouillage de compte survient généralement après plusieurs échecs de connexion ou un dépassement de la limite de fréquence des appels API. Essayez les étapes suivantes : 1) attendez 15 à 30 minutes pour un déverrouillage automatique (verrouillage temporaire) ; 2) réinitialisez votre mot de passe puis reconnectez-vous ; 3) si le compte affiche « Suspendu », contactez le support OpenClaw en fournissant votre adresse e-mail d'inscription et expliquez la situation. Attention : la violation des conditions d'utilisation (inscriptions en masse, scraping malveillant, etc.) peut entraîner un bannissement permanent sans possibilité de recours.
