OpenClaw
OpenClaw est un assistant IA local open source qui interagit avec vous via WhatsApp, Telegram, Slack et d’autres applications de messagerie, capable d’exécuter des actions réelles — gérer les e-mails, le calendrier, l’enregistrement de vols, la navigation web et plus encore. Il fonctionne entièrement en local, les données ne quittent pas votre appareil.
Pourquoi le combiner avec OfoxAI ?
- Accès unifié à plus de 100 modèles — Une seule clé API pour accéder à Claude, GPT, Gemini, Qwen, Doubao et tous les modèles principaux
- Stratégie d’Agent flexible — Assignez différents modèles à différents Agents : Sonnet pour les tâches principales, Opus pour le raisonnement, Haiku pour les tâches légères
- 99.9% SLA — Redondance multi-nœuds, basculement automatique en cas de panne
- Coûts maîtrisés — Panneau de facturation unifié, surveillance en temps réel de la consommation de tokens
OpenClaw en tant qu’assistant IA agentique consomme une quantité importante de tokens par tâche (généralement 10K-100K+ tokens). Il est recommandé de choisir le modèle selon la complexité de la tâche pour éviter des coûts inutiles. Cet article propose trois schémas de configuration.
Installation
curl -sSL https://openclaw.ai/install.sh | bash& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1)))Démarrage rapide
1. Obtenir une clé API
Rendez-vous sur la console OfoxAI pour créer une clé API.
2. Exécuter l’assistant de configuration
OpenClaw propose un assistant interactif, exécutez la commande suivante pour terminer rapidement la configuration :
openclaw onboardDans l’assistant, sélectionnez Custom Provider et saisissez les informations suivantes :
| Champ | Valeur |
|---|---|
| Provider Type | anthropic-messages |
| Base URL | https://api.ofox.ai/anthropic |
| API Key | Votre clé API OfoxAI |
| Model | anthropic/claude-sonnet-4.5 |
3. Vérifier le démarrage
openclaw startEnvoyez un message à OpenClaw pour tester la connectivité. Si vous recevez une réponse normale, la configuration est réussie.
L’assistant génère automatiquement le fichier de configuration openclaw.json. Si vous avez besoin d’un contrôle plus granulaire, consultez la configuration complète ci-dessous.
Configuration complète
OpenClaw gère toute la configuration via ~/.openclaw/openclaw.json (supporte le format JSON5, autorise les commentaires).
Configuration du Provider
Les Providers sont définis dans models.providers, chaque Provider doit spécifier le type de protocole API, l’adresse et la clé :
{
"models": {
"providers": {
"ofoxai-anthropic": {
"baseUrl": "https://api.ofox.ai/anthropic",
"apiKey": "${OFOXAI_API_KEY}",
"api": "anthropic-messages",
"models": []
},
"ofoxai-openai": {
"baseUrl": "https://api.ofox.ai/v1",
"apiKey": "${OFOXAI_API_KEY}",
"api": "openai-responses",
"models": []
},
"ofoxai-gemini": {
"baseUrl": "https://api.ofox.ai/gemini",
"apiKey": "${OFOXAI_API_KEY}",
"api": "google-generative-ai",
"models": []
}
}
}
}apiKey supporte la syntaxe ${ENV_VAR} pour référencer les variables d’environnement, évitant d’écrire les clés en clair dans le fichier de configuration. Trois protocoles pour différentes familles de modèles : Claude utilise ofoxai-anthropic (anthropic-messages), OpenAI utilise ofoxai-openai (openai-responses), Gemini utilise ofoxai-gemini (google-generative-ai). Les autres modèles peuvent se connecter via ofoxai-openai.
Configuration des Models
Les modèles sont définis dans le tableau models du Provider correspondant. Nous proposons trois schémas selon vos besoins :
Configuration maximale
Lineup complet Claude — Recherche la capacité maximale, idéal pour les scénarios exigeants.
{
"models": {
"providers": {
"ofoxai-anthropic": {
"baseUrl": "https://api.ofox.ai/anthropic",
"apiKey": "${OFOXAI_API_KEY}",
"api": "anthropic-messages",
"models": [
{
"id": "anthropic/claude-sonnet-4.5",
"name": "Claude Sonnet 4.5",
"input": ["text", "image", "file"],
"contextWindow": 200000,
"maxTokens": 64000
},
{
"id": "anthropic/claude-opus-4.6",
"name": "Claude Opus 4.6",
"reasoning": true,
"input": ["text", "image", "file"],
"contextWindow": 200000,
"maxTokens": 128000
},
{
"id": "anthropic/claude-haiku-4.5",
"name": "Claude Haiku 4.5",
"input": ["text", "image", "file"],
"contextWindow": 200000,
"maxTokens": 64000
}
]
}
}
}
}| Modèle | Rôle | Cas d’utilisation |
|---|---|---|
anthropic/claude-sonnet-4.5 | Modèle principal | Conversation quotidienne, exécution de tâches, génération de code |
anthropic/claude-opus-4.6 | Raisonnement profond | Analyse complexe, raisonnement en chaîne, tâches de recherche |
anthropic/claude-haiku-4.5 | Réponse rapide | Requêtes simples, réponses rapides, tâches légères |
Configuration des Agents
OpenClaw utilise agents.defaults pour les valeurs par défaut globales et agents.list pour définir différents Agents, chacun pouvant remplacer la configuration par défaut :
{
"agents": {
"defaults": {
"model": {
"primary": "ofoxai-anthropic/anthropic/claude-sonnet-4.5",
"fallbacks": ["ofoxai-anthropic/anthropic/claude-haiku-4.5"]
},
"models": {
"ofoxai-anthropic/anthropic/claude-opus-4.6": { "alias": "opus" },
"ofoxai-anthropic/anthropic/claude-sonnet-4.5": { "alias": "sonnet" },
"ofoxai-anthropic/anthropic/claude-haiku-4.5": { "alias": "haiku" }
},
"thinkingDefault": "low",
"timeoutSeconds": 600,
"maxConcurrent": 3
},
"list": [
{ "id": "main", "default": true },
{ "id": "research", "model": { "primary": "ofoxai-anthropic/anthropic/claude-opus-4.6" } },
{ "id": "quick", "model": { "primary": "ofoxai-anthropic/anthropic/claude-haiku-4.5" } }
]
}
}| Agent | Modèle | Usage |
|---|---|---|
| main | claude-sonnet-4.5 (hérité de defaults) | Agent par défaut, toutes les tâches quotidiennes |
| research | claude-opus-4.6 | Recherche approfondie, raisonnement complexe, analyse de textes longs |
| quick | claude-haiku-4.5 | Questions simples, réponses rapides, faible coût |
Le format de référence du modèle est nom-provider/model-id (ex. ofoxai-anthropic/anthropic/claude-sonnet-4.5). Le champ models dans defaults définit des alias de modèles, permettant de changer rapidement dans la conversation avec /model opus. Les Agents dans list héritent de toute la configuration de defaults, il suffit de remplacer les champs à modifier.
Cas d’utilisation
Une fois configuré, envoyez des instructions à OpenClaw via les applications de messagerie :
- Gestion des e-mails — « Organise mes e-mails non lus d’aujourd’hui par priorité »
- Planning — « Programme une réunion d’équipe demain à 15h »
- Recherche d’informations — « Recherche des articles techniques récents sur les AI Agents et résume les points clés »
- Assistance au code — « Revois ce code Python et vérifie les problèmes de sécurité »
- Automatisation de flux — « Envoie le rapport quotidien de l’équipe sur le canal #general de Slack chaque matin à 9h »
Dépannage
Impossible de se connecter à OfoxAI
Confirmez que baseUrl est correctement configuré :
- Protocole Anthropic :
https://api.ofox.ai/anthropic - Protocole OpenAI-Response :
https://api.ofox.ai/v1 - Protocole Gemini :
https://api.ofox.ai/gemini
Le modèle n’existe pas
Confirmez que le format de l’ID du modèle est correct. Lors de la définition des modèles dans models.providers, l’id utilise l’ID complet renvoyé par OfoxAI (ex. anthropic/claude-sonnet-4.5). Lors du référencement des modèles dans agents, il faut ajouter le préfixe du nom du Provider : ofoxai-anthropic/anthropic/claude-sonnet-4.5.
Consommation excessive de tokens
OpenClaw consomme beaucoup par tâche, il est recommandé de :
- Utiliser
claude-haiku-4.5ou des modèles économiques pour les tâches quotidiennes - Ne passer à l’Agent
research(utilisantclaude-opus-4.6) que pour les tâches complexes - Surveiller la consommation dans la console OfoxAI
Comment changer de modèle rapidement
Dans la conversation, utilisez les alias pour changer : /model opus, /model sonnet, /model haiku (nécessite de configurer les alias dans agents.defaults.models).