Configurer OpenClaw avec OmniaKey : Provider et liste autorisée

Mis à jour le 30 octobre 2026 : quatre erreurs de configuration fréquentes d'OpenClaw avec OmniaKey sont détaillées plus bas, avec le symptôme, la cause et la solution donnée par la documentation OpenClaw.

Pour une recherche comme configurer OpenClaw API, il faut distinguer deux opérations : déclarer le Provider et autoriser les modèles. OpenClaw fournit la boucle de l'agent et les outils ; le Provider fournit le modèle qui répond.

Ajouter OmniaKey comme Provider

La configuration se trouve dans ~/.openclaw/openclaw.json. Ajoutez OmniaKey sous models.providers :

{
  "models": {
    "mode": "merge",
    "providers": {
      "omniakey": {
        "baseUrl": "https://api.omniakey.com/v1",
        "apiKey": "your-omniakey-api-key",
        "api": "openai-completions",
        "models": [
          { "id": "claude-opus-4-8" },
          { "id": "gpt-5.5" },
          { "id": "gemini-3.1-pro-preview" },
          { "id": "grok-4.5" }
        ]
      }
    }
  }
}

mode: merge ajoute le Provider sans remplacer la configuration existante. Utilisez votre vraie clé, mais ne la commitez pas et ne la partagez pas. Un seul Provider OpenAI-compatible couvre quatre familles de modèles : OmniaKey cherche le modèle par son ID, donc claude-opus-4-8, gpt-5.5, gemini-3.1-pro-preview et grok-4.5 passent tous par la même entrée.

L'étape souvent oubliée : autoriser le modèle

La définition du Provider ne suffit pas. OpenClaw exige aussi une liste autorisée. Dans le même fichier, ajoutez agents au même niveau que models :

{
  "agents": {
    "defaults": {
      "models": ["omniakey/claude-opus-4-8", "omniakey/gpt-5.5", "omniakey/gemini-3.1-pro-preview", "omniakey/grok-4.5"],
      "model": "omniakey/claude-opus-4-8"
    }
  }
}

Le corps de la requête utilise l'ID du modèle ; provider/model-id est la référence interne d'OpenClaw. Les deux entrées sont nécessaires. Sans allowlist, vous pouvez obtenir model not allowed malgré une clé correcte.

Vérifier la configuration OpenClaw avec OmniaKey

openclaw doctor

doctor vérifie le fichier, le Provider, le format de la clé, la connexion et l'accès au modèle. Vous pouvez ensuite choisir omniakey/gpt-5.5 dans agents.defaults.

Erreurs de configuration fréquentes

• Model override "provider/model" is not allowed by agents.defaults.modelPolicy.allow. La référence choisie manque dans une liste agents.defaults.modelPolicy.allow non vide, et c'est cette liste qu'OpenClaw vérifie pour /model, les changements de modèle en session et --model. Ajoutez la référence exacte ou un joker de Provider comme omniakey/*, videz la liste, ou prenez un modèle dans /model list (FAQ modèles d'OpenClaw).

• model_not_found ou un 404, alors qu'un appel direct avec le même ID de modèle fonctionne. Une entrée personnalisée n'est résolue que si baseUrl se termine par /v1, si api vaut "openai-completions" et si le catalogue garde l'ID sans préfixe pendant que vous le sélectionnez avec le préfixe du Provider. Vérifiez ces trois points, sélectionnez le modèle une fois avec son préfixe, puis relancez la même requête (dépannage d'un backend local).

• Un 403 sec avec "Your request was blocked" dans le corps de la réponse. Ce texte vient en général d'une couche de sécurité devant l'endpoint — CDN, WAF, règle anti-bot ou proxy inverse — et non de openclaw.json ; openclaw logs --follow montre si plusieurs modèles du même Provider échouent de la même façon. Corrigez d'abord le côté Provider avec une règle d'autorisation qui ne couvre que le chemin appelé par OpenClaw, et laissez la protection active sur le reste du site (dépannage du 403 en amont).

• messages[...].content: invalid type: sequence, expected a string à chaque exécution de l'agent. Le backend refuse les parties de contenu structurées façon OpenAI. Mettez compat.requiresStringContent: true sur l'entrée de ce modèle, puis relancez la même requête.

Pourquoi utiliser OmniaKey

Une clé et un solde pour Claude, GPT, Gemini et Grok, avec une facturation au token. L'ID autorisé est celui qui s'exécute ; aucun remplacement silencieux par un modèle « équivalent ». Le catalogue de modèles liste tous les ids autorisables, et les tarifs donnent le prix par token.

Le guide des agents de programmation couvre les autres outils. Pour une configuration pas à pas, voir les guides Configurer Hermes Agent, Clé API personnalisée dans Cline et Configurer Claude Code.

Questions fréquentes

Où placer le bloc Provider d'OmniaKey ?

Dans ~/.openclaw/openclaw.json, sous models.providers. Gardez "mode": "merge" pour que le bloc s'ajoute à vos Providers existants au lieu de les remplacer.

Pourquoi OpenClaw dit-il qu'un modèle n'est pas autorisé ?

Le Provider est défini, mais la référence du modèle n'est pas dans la liste autorisée d'OpenClaw : l'exécution échoue même avec une clé correcte. Ajoutez la référence complète omniakey/model-id, puis lancez openclaw doctor.

Une seule clé OmniaKey peut-elle faire tourner Claude, GPT, Gemini et Grok dans OpenClaw ?

Oui. Une seule entrée de Provider avec api: "openai-completions" atteint les quatre familles, et l'ID de modèle de la requête décide laquelle s'exécute.

Comment vérifier qu'OpenClaw joint OmniaKey ?

openclaw doctor vérifie le fichier de configuration d'OpenClaw pour OmniaKey, le Provider, le format de la clé, une connexion en direct et l'accès au modèle. Ensuite, openclaw models list affiche les modèles OmniaKey que vous avez autorisés.

Faut-il modifier ~/.openclaw/agents/main/agent/models.json ?

Non. Ce fichier est régénéré depuis openclaw.json : faites vos changements de Provider et de liste autorisée dans openclaw.json.

Sources vérifiées

• OpenClaw : FAQ modèles et authentification
• OpenClaw : Skills et Providers de modèles