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.

Configurez plus rapidement avec Ofox Desktop. Sur un Mac Apple silicon, Desktop détecte cet outil, sauvegarde sa configuration actuelle et applique une clé API Ofox et un modèle compatible. Ouvrir Ofox Desktop .

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 :

Champ	Valeur
Provider Type	`anthropic-messages`
Base URL	`https://api.ofox.io/anthropic`
API Key	Votre clé API OfoxAI
Model	`anthropic/claude-sonnet-5.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.io/anthropic",
        "apiKey": "${OFOXAI_API_KEY}",
        "api": "anthropic-messages",
        "models": []
      },
      "ofoxai-openai": {
        "baseUrl": "https://api.ofox.io/v1",
        "apiKey": "${OFOXAI_API_KEY}",
        "api": "openai-responses",
        "models": []
      },
      "ofoxai-gemini": {
        "baseUrl": "https://api.ofox.io/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.

openclaw.json — models.providers


{
  "models": {
    "providers": {
      "ofoxai-anthropic": {
        "baseUrl": "https://api.ofox.io/anthropic",
        "apiKey": "${OFOXAI_API_KEY}",
        "api": "anthropic-messages",
        "models": [
          {
            "id": "anthropic/claude-sonnet-5.5",
            "name": "Claude Sonnet 5.5",
            "input": ["text", "image", "file"],
            "contextWindow": 1000000,
            "maxTokens": 128000
          },
          {
            "id": "anthropic/claude-opus-5.5",
            "name": "Claude Opus 5.5",
            "reasoning": true,
            "input": ["text", "image", "file"],
            "contextWindow": 1000000,
            "maxTokens": 128000
          },
          {
            "id": "anthropic/claude-haiku-5.5",
            "name": "Claude Haiku 5.5",
            "input": ["text", "image", "file"],
            "contextWindow": 1000000,
            "maxTokens": 128000
          }
        ]
      }
    }
  }
}

Modèle	Rôle	Cas d’utilisation
`anthropic/claude-sonnet-5.5`	Modèle principal	Conversation quotidienne, exécution de tâches, génération de code
`anthropic/claude-opus-5.5`	Raisonnement profond	Analyse complexe, raisonnement en chaîne, tâches de recherche
`anthropic/claude-haiku-5.5`	Réponse rapide	Requêtes simples, réponses rapides, tâches légères

Combinaison équilibrée

Combinaison OpenAI Codex — Capacité de code exceptionnelle, équilibre pour les tâches générales.

openclaw.json — models.providers


{
  "models": {
    "providers": {
      "ofoxai-openai": {
        "baseUrl": "https://api.ofox.io/v1",
        "apiKey": "${OFOXAI_API_KEY}",
        "api": "openai-responses",
        "models": [
          {
            "id": "openai/gpt-5.3-codex",
            "name": "GPT 5.3 Codex",
            "reasoning": true,
            "input": ["text", "image", "audio", "file"],
            "contextWindow": 512000,
            "maxTokens": 128000
          },
          {
            "id": "openai/gpt-5.1-codex-mini",
            "name": "GPT 5.1 Codex Mini",
            "input": ["text", "image", "audio", "file"],
            "contextWindow": 256000,
            "maxTokens": 65536
          }
        ]
      }
    }
  }
}

Modèle	Rôle	Cas d’utilisation
`openai/gpt-5.3-codex`	Principal + raisonnement	Conversation quotidienne, tâches complexes, refactorisation de code
`openai/gpt-5.1-codex-mini`	Réponse rapide	Tâches légères, complétion de code, questions rapides

Les modèles OpenAI se connectent via le Provider ofoxai-openai, utilisant le protocole openai-responses.

Meilleur rapport qualité-prix

Meilleur rapport qualité-prix — Prix par token bas, idéal pour une utilisation quotidienne intensive.

openclaw.json — models.providers


{
  "models": {
    "providers": {
      "ofoxai-openai": {
        "baseUrl": "https://api.ofox.io/v1",
        "apiKey": "${OFOXAI_API_KEY}",
        "api": "openai-responses",
        "models": [
          {
            "id": "qwen/qwen3.7-plus",
            "name": "Qwen3.7 Plus",
            "input": ["text", "image"],
            "contextWindow": 1000000,
            "maxTokens": 64000
          },
          {
            "id": "volcengine/doubao-seed-2.0-code",
            "name": "Doubao Seed 2.0 Code",
            "input": ["text", "image"],
            "contextWindow": 256000,
            "maxTokens": 128000
          }
        ]
      }
    }
  }
}

Modèle	Rôle	Cas d’utilisation
`qwen/qwen3.7-plus`	Principal + raisonnement	Conversation quotidienne, tâches générales, optimisé pour le chinois
`volcengine/doubao-seed-2.0-code`	Code + rapide	Génération de code, débogage, réponses rapides

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-5.5",
        "fallbacks": ["ofoxai-anthropic/anthropic/claude-haiku-5.5"]
      },
      "models": {
        "ofoxai-anthropic/anthropic/claude-opus-5.5": { "alias": "opus" },
        "ofoxai-anthropic/anthropic/claude-sonnet-5.5": { "alias": "sonnet" },
        "ofoxai-anthropic/anthropic/claude-haiku-5.5": { "alias": "haiku" }
      },
      "thinkingDefault": "low",
      "timeoutSeconds": 600,
      "maxConcurrent": 3
    },
    "list": [
      { "id": "main", "default": true },
      { "id": "research", "model": { "primary": "ofoxai-anthropic/anthropic/claude-opus-5.5" } },
      { "id": "quick", "model": { "primary": "ofoxai-anthropic/anthropic/claude-haiku-5.5" } }
    ]
  }
}

Agent	Modèle	Usage
main	`claude-sonnet-5.5` (hérité de defaults)	Agent par défaut, toutes les tâches quotidiennes
research	`claude-opus-5.5`	Recherche approfondie, raisonnement complexe, analyse de textes longs
quick	`claude-haiku-5.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-5.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.

Exemple de configuration complète

Voici un fichier openclaw.json complet, qui réunit les configurations Provider, Models et Agents (configuration la plus performante) :

~/.openclaw/openclaw.json


{
  "models": {
    "providers": {
      "ofoxai-anthropic": {
        "baseUrl": "https://api.ofox.io/anthropic",
        "apiKey": "${OFOXAI_API_KEY}",
        "api": "anthropic-messages",
        "models": [
          {
            "id": "anthropic/claude-sonnet-5.5",
            "name": "Claude Sonnet 5.5",
            "input": ["text", "image", "file"],
            "contextWindow": 1000000,
            "maxTokens": 128000
          },
          {
            "id": "anthropic/claude-opus-5.5",
            "name": "Claude Opus 5.5",
            "reasoning": true,
            "input": ["text", "image", "file"],
            "contextWindow": 1000000,
            "maxTokens": 128000
          },
          {
            "id": "anthropic/claude-haiku-5.5",
            "name": "Claude Haiku 5.5",
            "input": ["text", "image", "file"],
            "contextWindow": 1000000,
            "maxTokens": 128000
          }
        ]
      },
      "ofoxai-gemini": {
        "baseUrl": "https://api.ofox.io/gemini",
        "apiKey": "${OFOXAI_API_KEY}",
        "api": "google-generative-ai",
        "models": [
          {
            "id": "models/google/gemini-3.8-flash",
            "name": "Gemini 3.8 Flash",
            "reasoning": true,
            "input": ["text", "image"],
            "contextWindow": 1000000,
            "maxTokens": 64000
          },
          {
            "id": "models/google/gemini-3.1-pro-preview",
            "name": "Gemini 3.1 Pro",
            "reasoning": true,
            "input": ["text", "image"],
            "contextWindow": 1000000,
            "maxTokens": 64000
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "ofoxai-anthropic/anthropic/claude-sonnet-5.5",
        "fallbacks": ["ofoxai-anthropic/anthropic/claude-haiku-5.5"]
      },
      "models": {
        "ofoxai-anthropic/anthropic/claude-opus-5.5": { "alias": "opus" },
        "ofoxai-anthropic/anthropic/claude-sonnet-5.5": { "alias": "sonnet" },
        "ofoxai-anthropic/anthropic/claude-haiku-5.5": { "alias": "haiku" }
      },
      "thinkingDefault": "low",
      "timeoutSeconds": 600,
      "maxConcurrent": 3
    },
    "list": [
      {
        "id": "main",
        "default": true
      },
      {
        "id": "research",
        "model": {
          "primary": "ofoxai-anthropic/anthropic/claude-opus-5.5"
        }
      },
      {
        "id": "quick",
        "model": {
          "primary": "ofoxai-anthropic/anthropic/claude-haiku-5.5"
        }
      }
    ]
  }
}

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.io/anthropic
Protocole OpenAI-Response : https://api.ofox.io/v1
Protocole Gemini : https://api.ofox.io/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-5.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-5.5.

Consommation excessive de tokens

OpenClaw consomme beaucoup par tâche, il est recommandé de :

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