#openclaw#configuration#debugging#advanced

Le système se comporte bizarrement ? Paramètres avancés et guide de débogage

3 min read

Si vous êtes arrivé jusqu'ici, vous avez déjà fait passer OpenClaw de zéro à fonctionnel. Bravo.

Ce dernier article rassemble les habitudes qui rendent votre installation plus stable et plus facile à maintenir.

Ce que vous allez apprendre

  • Trouver le fichier de config et comprendre les deux modes d'édition
  • Reconnaître la structure d'une config minimale fonctionnelle
  • Stocker les clés API en sécurité avec les variables d'environnement
  • Utiliser la commande de débogage la plus utile et lire les erreurs courantes
  • Choisir la bonne piste de release

Où se trouve le fichier de config ?

~/.openclaw/openclaw.json

Le format est JSON5 : commentaires et virgules finales autorisés. Bien plus agréable que du JSON brut.

Vous pouvez l'éditer de deux façons :

  • Mode formulaire dans l'interface de contrôle pour une approche débutant
  • Raw JSON pour précision et rapidité

Les deux modes éditent le même fichier et enregistrent au même chemin.

À quoi ressemble une config minimale fonctionnelle ?

{
  "agents": {
    "list": [
      { "id": "main", "workspace": "~/.openclaw/workspace-main", "default": true }
    ]
  },
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "votre token de bot"
    }
  },
  "bindings": [
    { "agentId": "main", "match": { "channel": "telegram" } }
  ]
}

Faites d'abord fonctionner la version simple. Puis ajoutez les fonctionnalités progressivement.

La bonne façon de stocker les clés API

Évitez d'enfouir les clés API en dur dans la config.

Les variables d'environnement sont plus sûres :

# Mettez ça dans .env ou dans l'environnement système
ANTHROPIC_API_KEY=sk-ant-xxxxx

⚠️ Si la Gateway tourne comme service système (ex. systemd), assurez-vous que le service charge votre .env. Sinon l'assistant peut échouer car il ne voit pas la clé API, avec des erreurs du type « Shell env off ».

L'outil de débogage universel

Quand quelque chose ne va pas, commencez par :

openclaw logs --follow

Les logs en temps réel répondent à un nombre surprenant de questions.

Erreurs courantes :

Message d'erreur Cause probable
HTTP 429 Trop de requêtes API, limite de débit atteinte
unauthorized Problème de token ou de gateway.bind
content tool_use input field required Problème de compatibilité modèle, consultez la doc
Contexte tronqué Démarrez une nouvelle session ou compactez le contexte comme recommandé

Quelle piste de release choisir ?

Piste Idéal pour
Stable Usage quotidien, option la plus sûre par défaut
Beta Tester de nouvelles fonctionnalités en acceptant quelques bugs
Dev Développeurs qui veulent les derniers changements en premier

💡 Avant une mise à jour majeure, sauvegardez ~/.openclaw pour pouvoir revenir en arrière.

Série terminée : que pouvez-vous faire maintenant ?

À travers ces articles, vous avez appris à :

  1. Comprendre l'idée centrale d'OpenClaw
  2. L'installer et le lancer pour la première fois
  3. Gérer l'authentification du tableau de bord
  4. Connecter Telegram et d'autres canaux
  5. Rendre l'assistant plus capable avec les Skills
  6. Gérer mémoire et espaces de travail
  7. Répartir le travail entre plusieurs assistants
  8. Déployer la Gateway sur un VPS
  9. Automatiser des tâches avec Cron
  10. Déboguer et configurer le système comme un pro

Pour aller plus loin, la doc officielle sur docs.openclaw.ai reste la référence.

Votre assistant IA est prêt. Faites-le travailler pour vous.

← Précédent : Planification et automatisation | Retour au premier article