OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

LiteLLM

LiteLLM è un gateway LLM open source con un'API unificata per oltre 100 provider di modelli. Instrada OpenClaw tramite LiteLLM per centralizzare il monitoraggio dei costi, la registrazione, le chiavi virtuali con limiti di spesa e il failover del backend senza modificare la configurazione di OpenClaw.

Avvio rapido

Configurazione iniziale (consigliata)

bash
openclaw onboard --auth-choice litellm-api-key

Per una configurazione non interattiva con un proxy remoto, specifica esplicitamente l'URL del proxy:

bash
openclaw onboard --non-interactive --accept-risk --auth-choice litellm-api-key \  --litellm-api-key "$LITELLM_API_KEY" --custom-base-url "https://litellm.example/v1"

Configurazione manuale

  • Avvia il proxy LiteLLM

    bash
    pip install 'litellm[proxy]'litellm --model claude-opus-4-6

  • Indirizza OpenClaw a LiteLLM

    bash
    export LITELLM_API_KEY="your-litellm-key"openclaw

    • Configurazione

    json5
    {  models: {    providers: {      litellm: {        baseUrl: "http://localhost:4000",        apiKey: "${LITELLM_API_KEY}",        api: "openai-completions",        models: [          {            id: "claude-opus-4-6",            name: "Claude Opus 4.6",            reasoning: true,            input: ["text", "image"],            contextWindow: 200000,            maxTokens: 64000,          },          {            id: "gpt-4o",            name: "GPT-4o",            reasoning: false,            input: ["text", "image"],            contextWindow: 128000,            maxTokens: 8192,          },        ],      },    },  },  agents: {    defaults: {      model: { primary: "litellm/claude-opus-4-6" },    },  },}

    Il modello predefinito scritto dalla configurazione iniziale è litellm/claude-opus-4-6.

    Generazione di immagini

    LiteLLM può supportare lo strumento image_generate tramite le route compatibili con OpenAI /images/generations e /images/edits. Il modello di immagini predefinito è gpt-image-2; configurane uno diverso in agents.defaults.imageGenerationModel:

    json5
    {  models: {    providers: {      litellm: {        baseUrl: "http://localhost:4000",        apiKey: "${LITELLM_API_KEY}",      },    },  },  agents: {    defaults: {      imageGenerationModel: {        primary: "litellm/gpt-image-2",        timeoutMs: 180_000,      },    },  },}

    Gli URL local loopback di LiteLLM (http://localhost:4000, 127.0.0.1, ::1, host.docker.internal) funzionano senza un'eccezione globale per la rete privata. Per un proxy ospitato sulla LAN, imposta models.providers.litellm.request.allowPrivateNetwork: true perché la chiave API viene inviata a tale host.

    Funzionalità avanzate

    Chiavi virtuali

    Crea una chiave dedicata per OpenClaw con limiti di spesa:

    bash
    curl -X POST "http://localhost:4000/key/generate" \  -H "Authorization: Bearer $LITELLM_MASTER_KEY" \  -H "Content-Type: application/json" \  -d '{    "key_alias": "openclaw",    "max_budget": 50.00,    "budget_duration": "monthly"  }'

    Usa la chiave generata come LITELLM_API_KEY.

    Instradamento dei modelli

    LiteLLM può instradare le richieste dei modelli verso backend diversi. Configuralo nel file config.yaml di LiteLLM:

    yaml
    model_list:  - model_name: claude-opus-4-6    litellm_params:      model: claude-opus-4-6      api_key: os.environ/ANTHROPIC_API_KEY   - model_name: gpt-4o    litellm_params:      model: gpt-4o      api_key: os.environ/OPENAI_API_KEY

    OpenClaw continua a richiedere claude-opus-4-6; LiteLLM gestisce l'instradamento.

    Visualizzazione dell'utilizzo
    bash
    # Informazioni sulla chiavecurl "http://localhost:4000/key/info" \  -H "Authorization: Bearer sk-litellm-key" # Registri di spesacurl "http://localhost:4000/spend/logs" \  -H "Authorization: Bearer $LITELLM_MASTER_KEY"
    Note sul comportamento del proxy
    • Per impostazione predefinita, LiteLLM viene eseguito su http://localhost:4000.
    • OpenClaw si connette tramite l'endpoint /v1 compatibile con OpenAI in stile proxy di LiteLLM.
    • La strutturazione delle richieste riservata agli endpoint OpenAI nativi non si applica quando si usa un URL di base LiteLLM configurato: niente service_tier, niente store di Responses, niente suggerimenti per la cache dei prompt, niente strutturazione del payload relativa all'intensità di ragionamento di OpenAI.
    • Le intestazioni nascoste di attribuzione di OpenClaw (originator, version, User-Agent) vengono inviate solo agli endpoint OpenAI nativi verificati, quindi non vengono inserite in un URL di base LiteLLM personalizzato.

    Contenuti correlati

    Documentazione di LiteLLM

    Documentazione ufficiale di LiteLLM e riferimento dell'API.
    Selezione del modello

    Panoramica di tutti i provider, dei riferimenti ai modelli e del comportamento di failover.
    Configurazione

    Riferimento completo della configurazione.
    Modelli

    Come scegliere e configurare i modelli.
    Was this useful?
    On this page

    On this page