OpenClaw

Copiez la configuration et remplacez sk-... par votre clé de l’espace client Ailoot. Il est préférable de conserver la clé dans la variable d’environnement AILOOT_API_KEY, si l’application le permet.

Avant de démarrer, appelez GET /v1/models avec votre clé Ailoot. Choisissez un identifiant exact de modèle dont les méthodes incluent POST /v1/chat/completions, POST /v1/responses, POST /v1/messages, POST /v1beta/models/{model}:generateContent, puis utilisez-le dans la configuration. Pour les agents, vérifiez aussi les outils et les fonctions nécessaires à votre version du client.

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "ailoot/claude-sonnet-5-5"
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "ailoot": {
        "baseUrl": "https://api.ailoot.ai/v1",
        "apiKey": "${AILOOT_API_KEY}",
        "api": "openai-completions",
        "models": [
          {
            "id": "claude-sonnet-5-5",
            "name": "Claude Sonnet 5.5",
            "reasoning": true,
            "input": [
              "text"
            ],
            "contextWindow": 1000000,
            "maxTokens": 128000
          },
          {
            "id": "deepseek-v4-pro",
            "name": "DeepSeek V4 Pro",
            "reasoning": true,
            "input": [
              "text"
            ],
            "contextWindow": 1000000,
            "maxTokens": 131072
          }
        ]
      },
      "ailoot-claude": {
        "baseUrl": "https://api.ailoot.ai",
        "apiKey": "${AILOOT_API_KEY}",
        "api": "anthropic-messages",
        "models": [
          {
            "id": "claude-opus-5-5",
            "name": "Claude Opus 5.5",
            "reasoning": true,
            "input": [
              "text"
            ],
            "contextWindow": 1000000,
            "maxTokens": 131072
          }
        ]
      }
    }
  }
}

Cette configuration lit la clé dans la variable AILOOT_API_KEY. Définissez-la avant de lancer l’application :

export AILOOT_API_KEY="sk-..."   # Ajoutez à ~/.zshrc ou ~/.bashrc

setx AILOOT_API_KEY "sk-..."   # Puis redémarrez le terminal

Exemple de modèle : claude-sonnet-5-5. Choisissez tout autre modèle dans le catalogue — vérifiez qu’il prend en charge le format requis.

• Pour le format OpenAI, l’adresse est https://api.ailoot.ai/v1 (ou le chemin complet si l’application demande une adresse complète).
• Pour le format Anthropic, l’adresse est https://api.ailoot.ai sans /v1.
• Pour le format Gemini, l’adresse est https://api.ailoot.ai — l’adresse racine de l’API. La configuration complète de ce format n’est pas présentée dans l’exemple ci-dessus ; consultez la documentation du client pour vérifier le chemin à saisir dans son champ. Le préfixe de la route API est — /v1beta.
• Posez une question courte. En cas d’erreur, consultez le code et le Request ID, puis reportez-vous à la page Erreurs et limites.
• Une erreur 404 immédiatement après la configuration indique presque toujours une adresse incorrecte : la présence superflue ou l’absence de /v1.
• Une erreur 402 signifie que le solde ne couvre pas la réservation. Les agents réservent plus qu’un chat : explication.

Documentation de l’application : https://docs.openclaw.ai/gateway/config-tools/custom-providers