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
- Aprite!https://ai2save.com/keys](https://ai2save.com/keys).
- Creare una chiave API appartenente al gruppo modello OpenAI / GPT.
- 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.apiKeypuò scrivere direttamente"sk-..."; quando si fa riferimento${AI2SAVE_API_KEY}, deve essere definitoenv.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
- Aprire l'interfaccia di chat o WebChat per OpenClaw.
- Avviare una nuova conversazione e inviare "Ciao, si prega di segnalare il nome attuale del modello."
- Confermare che il percorso del modello mostra come
ai2save/gpt-5.5. - 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_KEYnon è 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 chemodels.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.