ai2saveai2save

Guida alla configurazione di OpenClaw

OpenClaw aggiunge fornitori di modelli personalizzati attraverso models.providers. ai2save utilizza l'interfaccia compatibile OpenAI e l'URL di base deve essere riempito in https://ai2save.com/v1.

1. Prepara OpenClaw e la chiave API

Se OpenClaw è già installato, è possibile saltare l'installazione:

npm install -g openclaw@latest
openclaw --version
  1. Aprite!https://ai2save.com/keys](https://ai2save.com/keys).
  2. Creare una chiave API appartenente al gruppo modello OpenAI / GPT.
  3. Copiare il completo sk-... Chiave.

2. Modifica il file di configurazione di OpenClaw

Il file di configurazione predefinito per OpenClaw è:

~/.openclaw/openclaw.json

Windows solitamente supporta JSON5 nel %USERPROFILE%\.openclaw\openclaw.json. file, che può essere fuso nella configurazione esistente in base alla struttura sottostante:

{
  env: {
    vars: {
      AI2SAVE_API_KEY: "sk-your-api-key",
    },
  },
  agents: {
    defaults: {
      model: {
        primary: "ai2save/gpt-5.5",
      },
    },
  },
  models: {
    mode: "merge",
    providers: {
      ai2save: {
        baseUrl: "https://ai2save.com/v1",
        apiKey: "${AI2SAVE_API_KEY}",
        api: "openai-completions",
        timeoutSeconds: 300,
        models: [
          {
            id: "gpt-5.5",
            name: "GPT 5.5",
            reasoning: true,
            input: ["text"],
            contextWindow: 200000,
          },
        ],
      },
    },
  },
}

Key Field Descrizione:

  • models.providers.ai2save.baseUrl: Deve includere /v1.
  • api: "openai-completions": Il tipo di interfaccia utilizzato da OpenClaw per proxy OpenAI Compatibile.
  • models[].id: Deve essere esattamente coerente con il modello ID aperto nella console ai2save.
  • agents.defaults.model.primary: Formato è provider-id/model-id.
  • apiKey può scrivere direttamente "sk-..."; quando si fa riferimento ${AI2SAVE_API_KEY}, deve essere definito env.vars.

Se si desidera aggiungere più modelli, continuare a appending nel models array e cambiamento primary a ai2save/model-id si desidera utilizzare per impostazione predefinita.

3. Applica e verifica la configurazione

OpenClaw Gateway ascolterà le modifiche dei file di configurazione e li applicherà automaticamente:

openclaw gateway restart

Quindi verificare se il modello è già apparso in OpenClaw:

openclaw models list --provider ai2save

Passare il modello predefinito a ai2save:

openclaw models set ai2save/gpt-5.5

Se il modello non appare, eseguire la diagnostica e controllare gli errori di configurazione:

openclaw doctor

4. Verifica della richiesta

  1. Aprire l'interfaccia di chat o WebChat per OpenClaw.
  2. Avviare una nuova conversazione e inviare "Ciao, si prega di segnalare il nome attuale del modello."
  3. Confermare che il percorso del modello mostra come ai2save/gpt-5.5.
  4. Per la prima volta, verifica solo con le attività di testo. Una volta riusciti, abilitare strumenti più complessi come il file handling, browser e lungo contesto.

OpenClaw gestirà automaticamente la compatibilità per i proxy OpenAI non ufficiali, quindi non c'è bisogno di abilitare manualmente developer role. Se c'è un'eccezione con le chiamate degli strumenti, prima confermare che il modello ID supporta le chiamate di strumento, quindi aumentare il timeout.

5. Errori comuni

  • 401 / invalid_api_key: AI2SAVE_API_KEY non è definita, la chiave non è completamente copiata, o il raggruppamento di chiavi non corrisponde.
  • 404 - Categoria non trovata: models[].id, primary, o il nome del modello richiesto non corrisponde.
  • Connessione non riuscita / risposta vuota: Verificare se baseUrl è https://ai2save.com/v1, e non scrivere l'indirizzo root.
  • L'elenco dei modelli è vuoto: Conferma models.mode: "merge", e garantire che models.providers.ai2save.models[] contiene almeno un modello.
  • La configurazione non ha effetto dopo il salvataggio: Ripetizione openclaw doctor, e se necessario, riavviare OpenClaw e Gateway.