OpenClaw Config Edit : Guide d'installation complet (2026)
Guide complet de modification de la configuration OpenClaw pour WhatsApp, Discord, Telegram et Ollama. Commandes copier-coller pour configurer les canaux, modèles et fournisseurs. Erreurs de configuration courantes corrigées.
TL;DR
Référence rapide pour les commandes de configuration OpenClaw les plus courantes :
# Ouvrir l'éditeur de configuration
openclaw config edit
# Définir une valeur spécifique
openclaw config set channels.whatsapp.enabled true
openclaw config set model.provider openai
openclaw config set model.name gpt-4o
# Afficher la configuration actuelle
openclaw config show
# Valider et corriger les problèmes de configuration
openclaw doctor
openclaw doctor --fix
# Réinitialiser aux valeurs par défaut
openclaw config reset
Qu'est-ce qu'OpenClaw ?
OpenClaw est un framework d'assistant IA open-source qui connecte de grands modèles de langage à des canaux de messagerie comme WhatsApp, Discord, Telegram et Slack. Il prend en charge plusieurs fournisseurs de modèles — OpenAI, Anthropic, Ollama (modèles locaux), Google, et plus encore — et peut être étendu avec des compétences et des plugins personnalisés.
Le cœur d'OpenClaw est son système de configuration. Presque tout — quels canaux sont actifs, quel modèle utiliser, quelles compétences sont chargées — est contrôlé via des fichiers de configuration. Maîtriser openclaw config edit est la clé pour faire fonctionner OpenClaw comme vous le souhaitez.
openclaw config edit : Les bases
Ouverture de l'éditeur de configuration
La commande principale pour configurer OpenClaw est :
openclaw config edit
Cela ouvre votre fichier de configuration dans votre éditeur de terminal par défaut (généralement nano, vim, ou tout ce qui est défini dans $EDITOR). Le fichier de configuration se trouve généralement dans ~/.openclaw/config.yaml ou ~/.config/openclaw/config.yaml selon votre installation.
Structure du fichier de configuration
Le fichier de configuration OpenClaw est au format YAML et organisé en sections :
# Model configuration
model:
provider: openai # openai, anthropic, ollama, google
name: gpt-4o # model identifier string
temperature: 0.7
max_tokens: 4096
# Channel configuration
channels:
whatsapp:
enabled: false
phone_number_id: ""
access_token: ""
discord:
enabled: false
bot_token: ""
telegram:
enabled: false
bot_token: ""
slack:
enabled: false
bot_token: ""
app_token: ""
# Skills and plugins
skills:
- web_search
- calculator
- weather
# Speech-to-text
stt:
provider: whisper
model: whisper-1
# System prompt
system_prompt: "You are a helpful assistant."
Définition de valeurs individuelles
Au lieu de modifier le fichier complet, vous pouvez définir des valeurs de configuration individuelles depuis la ligne de commande :
openclaw config set model.provider anthropic
openclaw config set model.name claude-sonnet-4-6
openclaw config set model.temperature 0.5
Ceci est utile pour le scripting ou les changements rapides sans ouvrir d'éditeur.
Configuration des canaux
L'intégration WhatsApp nécessite un compte Meta Business et un accès à l'API WhatsApp Business.
# Activer le canal WhatsApp
openclaw config set channels.whatsapp.enabled true
openclaw config set channels.whatsapp.phone_number_id "YOUR_PHONE_NUMBER_ID"
openclaw config set channels.whatsapp.access_token "YOUR_ACCESS_TOKEN"
openclaw config set channels.whatsapp.verify_token "YOUR_VERIFY_TOKEN"
# Définir l'URL du webhook
openclaw config set channels.whatsapp.webhook_url "https://your-domain.com/webhook/whatsapp"
Discord
La configuration de Discord est plus simple — vous avez juste besoin d'un token de bot provenant du Discord Developer Portal.
openclaw config set channels.discord.enabled true
openclaw config set channels.discord.bot_token "YOUR_DISCORD_BOT_TOKEN"
Telegram
Telegram nécessite un token de bot provenant de @BotFather :
openclaw config set channels.telegram.enabled true
openclaw config set channels.telegram.bot_token "YOUR_TELEGRAM_BOT_TOKEN"
Telegram prend en charge les modes polling et webhook. Le polling est plus facile pour le développement (aucune URL publique requise) :
openclaw config set channels.telegram.mode polling
Pour la production, utilisez le mode webhook :
openclaw config set channels.telegram.mode webhook
openclaw config set channels.telegram.webhook_url "https://your-domain.com/webhook/telegram"
Slack
L'intégration Slack utilise le Socket Mode (recommandé) ou l'API Events :
openclaw config set channels.slack.enabled true
openclaw config set channels.slack.bot_token "xoxb-YOUR-BOT-TOKEN"
openclaw config set channels.slack.app_token "xapp-YOUR-APP-TOKEN"
Le Socket Mode est recommandé car il ne nécessite pas d'URL publique.
Configuration des fournisseurs de modèles
OpenAI
openclaw config set model.provider openai
openclaw config set model.name gpt-4o
Définissez votre clé API comme variable d'environnement (ne la mettez pas dans le fichier de configuration) :
export OPENAI_API_KEY="sk-..."
Anthropic (Claude)
openclaw config set model.provider anthropic
openclaw config set model.name claude-sonnet-4-6
export ANTHROPIC_API_KEY="sk-ant-..."
Ollama (Modèles locaux)
C'est ici qu'OpenClaw se distingue pour les utilisateurs soucieux de la confidentialité. Ollama vous permet d'exécuter des modèles localement sans clés API et sans que les données ne quittent votre machine.
# Installer Ollama d'abord
# https://ollama.ai
# Télécharger un modèle
ollama pull llama3.3
# Configurer OpenClaw pour utiliser Ollama
openclaw config set model.provider ollama
openclaw config set model.name llama3.3
openclaw config set model.base_url "http://localhost:11434"
ollama serve) et que l'URL de base correspond. Le port par défaut d'Ollama est 11434.
Google (Gemini)
openclaw config set model.provider google
openclaw config set model.name gemini-2.5-pro
export GOOGLE_API_KEY="..."
xAI (Grok)
openclaw config set model.provider openai # xAI utilise une API compatible OpenAI
openclaw config set model.name grok-4.1
openclaw config set model.base_url "https://api.x.ai/v1"
export OPENAI_API_KEY="xai-..." # Utilisez la clé xAI avec le fournisseur OpenAI
Erreurs de configuration courantes et corrections
Erreur : "Unknown config key"
Error: Unknown config key 'chanels.whatsapp.enabled'
Cela signifie généralement une faute de frappe dans la clé de configuration. Vérifiez l'orthographe. Erreurs courantes :
chanels→channelsprovidr→providertelgram→telegram
Lancez
openclaw config show pour voir toutes les clés valides.
Erreur : "Channel auto-enabled without credentials"
Certaines versions d'OpenClaw activent automatiquement les canaux lorsque vous définissez des identifiants, même si vous ne les avez pas explicitement activés. Cela peut provoquer des échecs au démarrage si les identifiants sont incomplets.
Correction :# Désactiver explicitement les canaux que vous n'utilisez pas
openclaw config set channels.whatsapp.enabled false
openclaw config set channels.discord.enabled false
openclaw config set channels.slack.enabled false
Erreur : "Model provider not configured"
Error: Model provider 'anthropic' requires ANTHROPIC_API_KEY
Vous devez définir la variable d'environnement correspondante. OpenClaw ne stocke intentionnellement pas les clés API dans le fichier de configuration pour des raisons de sécurité.
Correction : Ajoutez la clé API à votre profil shell (~/.bashrc, ~/.zshrc) ou utilisez un fichier .env :
echo 'export ANTHROPIC_API_KEY="sk-ant-..."' >> ~/.zshrc
source ~/.zshrc
Utilisation d'openclaw doctor
La commande openclaw doctor valide l'ensemble de votre configuration et signale les problèmes :
openclaw doctor
Exemple de sortie :
Checking configuration...
✓ Config file found
✓ Model provider configured
✗ WhatsApp: enabled but missing access_token
✗ Discord: bot token invalid format
✓ Telegram: configured correctly
✓ Ollama: connection successful
2 issues found. Run 'openclaw doctor --fix' to attempt auto-fix.
Le drapeau --fix tente de résoudre les problèmes automatiquement :
openclaw doctor --fix
Cela désactivera les canaux avec des identifiants manquants, corrigera les problèmes de formatage connus et suggérera des corrections manuelles pour les problèmes qu'il ne peut pas résoudre automatiquement.
Configuration avancée
Compétences personnalisées (Skills)
OpenClaw prend en charge des compétences personnalisées (plugins) qui étendent les capacités de l'assistant :
skills:
- web_search
- calculator
- weather
- custom_skill:
path: ./my-skills/custom_tool.py
config:
api_key_env: CUSTOM_API_KEY
Ou via la ligne de commande :
openclaw skills add web_search
openclaw skills add ./my-skills/custom_tool.py
openclaw skills list
openclaw skills remove calculator
Configuration Speech-to-Text (STT)
Pour le support des messages vocaux sur WhatsApp et Telegram :
stt:
provider: whisper # whisper, deepgram, google
model: whisper-1
language: auto # auto-détection ou spécifier "en", "fr", etc.
openclaw config set stt.provider whisper
openclaw config set stt.model whisper-1
Intégration Tuya Smart Home
OpenClaw peut contrôler des appareils domotiques compatibles Tuya :
tuya:
enabled: true
access_id: "YOUR_TUYA_ACCESS_ID"
access_key: "YOUR_TUYA_ACCESS_KEY"
endpoint: "https://openapi.tuyaus.com"
Cela vous permet de contrôler les lumières, les interrupteurs, les thermostats et d'autres appareils Tuya via des commandes en langage naturel dans n'importe quel canal connecté.
Configurations de modèles multiples
Vous pouvez définir des préréglages de modèles et basculer entre eux :
models:
default:
provider: openai
name: gpt-4o
fast:
provider: ollama
name: llama3.3
reasoning:
provider: anthropic
name: claude-opus-4-6
openclaw config set model.active default
# ou changer au moment de l'exécution
openclaw --model fast
Foire Aux Questions (FAQ)
Où est stocké le fichier de configuration OpenClaw ?
L'emplacement par défaut est ~/.openclaw/config.yaml. Sur certaines installations, il peut se trouver dans ~/.config/openclaw/config.yaml. Lancez openclaw config show --path pour voir l'emplacement exact.
Puis-je utiliser OpenClaw sans aucune API cloud ?
Oui. Configurez Ollama comme fournisseur de modèle et utilisez Telegram en mode polling. Cela vous donne un assistant IA entièrement local et privé, aucune donnée ne quittant votre machine.
Comment mettre à jour OpenClaw ?
pip install --upgrade openclaw
# ou
npm update -g openclaw
Après la mise à jour, lancez openclaw doctor pour vérifier tout changement de format de configuration.
Puis-je exécuter plusieurs canaux simultanément ?
Oui. Activez autant de canaux que vous le souhaitez — OpenClaw les gère simultanément. Chaque canal partage la même configuration de modèle et de compétences.
Comment réinitialiser ma configuration aux valeurs par défaut ?
openclaw config reset
Cela écrase votre fichier de configuration avec le modèle par défaut. Sauvegardez votre configuration existante au préalable si nécessaire.
Vous voulez quelque chose de plus simple ?
OpenClaw est puissant mais nécessite une aisance avec le terminal et une configuration manuelle. Si vous souhaitez créer et lancer des produits basés sur l'IA sans gérer vous-même les fichiers de configuration, les fournisseurs de modèles et les intégrations de canaux :
Y Build gère l'ensemble de la pile — déploiement, vidéos de produits, SEO par IA et analyses. Pas de fichiers de config. Pas de terminal. Créez et lancez tout simplement. Démarrer gratuitement →Sources :