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.
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. Copiez un ID exact depuis le catalogue actuel.
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
openclaw doctor
openclaw models list
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.
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 guide des agents de programmation couvre les autres outils.