Guide de configuration

Tous les paramètres d'OpenClaw sont regroupés dans un seul fichier de configuration. Voyons comment le personnaliser.

📄 Emplacement du fichier de configuration

Le fichier de configuration principal d'OpenClaw se trouve ici :

~/.openclaw/openclaw.json

Le ~ représente ton répertoire personnel. Par exemple, sur macOS, le chemin complet est généralement /Users/ton_nom_utilisateur/.openclaw/openclaw.json.

💡 Petit conseil : .openclaw est un dossier caché (les dossiers dont le nom commence par un point sont invisibles par défaut). Dans le Finder de macOS, appuie sur Command + Shift + . pour afficher les fichiers cachés. Sous Linux, utilise la commande ls -a.

⚙️ Paramètres clés

Voici les paramètres les plus couramment utilisés dans le fichier de configuration :

Choix du modèle IA

Définis le modèle IA par défaut :

{
  "model": {
    "provider": "anthropic",
    "name": "claude-sonnet-4-20250514",
    "api_key": "sk-ant-..."
  }
}

Tu peux changer provider en "openai", "deepseek" ou "google", puis ajouter le nom du modèle et la clé API correspondants.

Gestion des sessions

Contrôle le comportement des conversations IA :

{
  "session": {
    "max_history": 50,
    "timeout_minutes": 30,
    "system_prompt": "Tu es un assistant IA utile..."
  }
}

max_history — Nombre maximum de messages à conserver dans l'historique de chaque conversation
timeout_minutes — Durée d'inactivité (en minutes) avant de démarrer automatiquement une nouvelle conversation
system_prompt — Le « rôle » de l'IA, tu peux personnaliser sa personnalité

Configuration des canaux

Configure les informations de connexion de chaque plateforme de chat :

{
  "channels": {
    "telegram": {
      "enabled": true,
      "bot_token": "123456:ABC-DEF..."
    },
    "discord": {
      "enabled": true,
      "bot_token": "MTIz..."
    }
  }
}

🔄 Rechargement à chaud

OpenClaw supporte le rechargement à chaud (Hot Reload), ce qui signifie qu'après avoir modifié le fichier de configuration, tu n'as pas besoin de redémarrer OpenClaw : il détecte automatiquement les changements et applique les nouveaux paramètres.

En gros : il te suffit de modifier et sauvegarder le fichier de configuration, et OpenClaw utilisera automatiquement les nouveaux paramètres. Très pratique !

ℹ️ Attention : certains paramètres fondamentaux (comme le numéro de port) peuvent quand même nécessiter un redémarrage manuel. Mais la plupart (changement de modèle, configuration des canaux) se rechargent à chaud.