# Configurer OpenClaw avec OmniaKey : Provider et liste autorisée > Ajoutez OmniaKey comme Provider OpenAI-compatible dans OpenClaw. Configurez openclaw.json, la liste des modèles autorisés, doctor et l'erreur model not allowed. - Canonical HTML: https://omniakey.com/fr/blog/openclaw-setup - Markdown: https://omniakey.com/fr/blog/openclaw-setup.md - Published: 2026-05-19 (updated 2026-10-30) - Author: Kiki, COO at OmniaKey - Language: fr - Category: Guide - Reading time: 5 min - All posts: https://omniakey.com/blog/llms.txt --- 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` : ```json { "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` : ```json { "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 ```bash 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`. > Ne modifiez pas manuellement `~/.openclaw/agents/main/agent/models.json` : le fichier est régénéré depuis `openclaw.json`. ## 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](https://docs.openclaw.ai/help/faq-models#why-do-i-see-model-is-not-allowed-and-then-no-reply)). - `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](https://docs.openclaw.ai/gateway/troubleshooting/skills-and-model-providers#local-openai-compatible-backend-passes-direct-checks-but-agent-runs-fail)). - 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](https://docs.openclaw.ai/gateway/troubleshooting/skills-and-model-providers#upstream-403-blocked-responses)). - `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](https://omniakey.com/fr/models) liste tous les ids autorisables, et [les tarifs](https://omniakey.com/fr/pricing) donnent le prix par token. - **OpenAI-compatible**: - **Anthropic-native**: - **Gemini-native**: Le [guide des agents de programmation](https://docs.omniakey.com/fr/coding) couvre les autres outils. Pour une configuration pas à pas, voir les guides [Configurer Hermes Agent](https://omniakey.com/fr/blog/hermes-setup), [Clé API personnalisée dans Cline](https://omniakey.com/fr/blog/cline-custom-api-key) et [Configurer Claude Code](https://omniakey.com/fr/blog/claude-code-setup). ## 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](https://docs.openclaw.ai/help/faq-models) - [OpenClaw : Skills et Providers de modèles](https://docs.openclaw.ai/gateway/troubleshooting/skills-and-model-providers)