OpenClaw

Copia la configurazione e sostituisci sk-... con la tua chiave dall’area personale Ailoot. È meglio conservarla nella variabile d’ambiente AILOOT_API_KEY, se l’applicazione lo supporta.

Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions, POST /v1/responses, POST /v1/messages, POST /v1beta/models/{model}:generateContent e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del 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
          }
        ]
      }
    }
  }
}

Questa configurazione legge la chiave dalla variabile AILOOT_API_KEY. Impostala prima di avviare l’applicazione:

export AILOOT_API_KEY="sk-..."   # aggiungi a ~/.zshrc o ~/.bashrc

setx AILOOT_API_KEY "sk-..."   # poi riavvia il terminale

Modello di esempio: claude-sonnet-5-5. Scegli qualsiasi altro modello dal catalogo — verifica che supporti il formato necessario.

• Per il formato OpenAI l’indirizzo è https://api.ailoot.ai/v1 (oppure il percorso completo, se l’applicazione chiede l’indirizzo completo).
• Per il formato Anthropic l’indirizzo è https://api.ailoot.ai senza /v1.
• Per il formato Gemini l’indirizzo è https://api.ailoot.ai — l’indirizzo radice dell’API. Nell’esempio sopra non è mostrata la configurazione completa di questo formato; verifica nella documentazione del client quale percorso indicare nel relativo campo. Il prefisso del percorso API è /v1beta.
• Fai una domanda breve. Se ricevi un errore, controlla codice e Request ID e consulta la pagina Errori e limiti.
• 404 subito dopo la configurazione indica quasi sempre un indirizzo errato: manca o è superfluo il segmento /v1.
• 402 — il saldo non basta per la riserva. Gli agenti riservano più di una chat: perché.

Documentazione dell’applicazione: https://docs.openclaw.ai/gateway/config-tools/custom-providers