Skip to Content

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

macOS / Linux
curl -sSL https://openclaw.ai/install.sh | bash
Windows (PowerShell)
& ([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 onboard

Dans l’assistant, sélectionnez Custom Provider et saisissez les informations suivantes :

ChampValeur
Provider Typeanthropic-messages
Base URLhttps://api.ofox.ai/anthropic
API KeyVotre clé API OfoxAI
Modelanthropic/claude-sonnet-4.5

3. Vérifier le démarrage

openclaw start

Envoyez 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é :

~/.openclaw/openclaw.json
{ "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 :

Lineup complet Claude — Recherche la capacité maximale, idéal pour les scénarios exigeants.

openclaw.json — models.providers
{ "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èleRôleCas d’utilisation
anthropic/claude-sonnet-4.5Modèle principalConversation quotidienne, exécution de tâches, génération de code
anthropic/claude-opus-4.6Raisonnement profondAnalyse complexe, raisonnement en chaîne, tâches de recherche
anthropic/claude-haiku-4.5Réponse rapideRequê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 :

openclaw.json — section agents
{ "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" } } ] } }
AgentModèleUsage
mainclaude-sonnet-4.5 (hérité de defaults)Agent par défaut, toutes les tâches quotidiennes
researchclaude-opus-4.6Recherche approfondie, raisonnement complexe, analyse de textes longs
quickclaude-haiku-4.5Questions 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 :

  1. Utiliser claude-haiku-4.5 ou des modèles économiques pour les tâches quotidiennes
  2. Ne passer à l’Agent research (utilisant claude-opus-4.6) que pour les tâches complexes
  3. 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).

Last updated on