dotsagent.io
Lingua:Italiano
Guida a OpenClaw · 4 passaggi

Collega i modelli a OpenClaw

Fornisci a OpenClaw una chiave API per un provider cloud e scegli il modello predefinito, oppure indirizzalo a un server locale come LM Studio o vLLM.

I provider cloud sono plugin ufficiali che leggono le chiavi dalle variabili d'ambiente. Sono supportati circa 30 altri provider, oltre a quelli elencati qui.

  1. Imposta la chiave del provider

    Esporta la chiave del provider, poi elenca i modelli che OpenClaw può usare con quella chiave. Lo stesso schema vale per OPENAI_API_KEY, GEMINI_API_KEY, OPENROUTER_API_KEY, XAI_API_KEY, MISTRAL_API_KEY, GROQ_API_KEY e DEEPSEEK_API_KEY.

    shell
    export ANTHROPIC_API_KEY=sk-ant-...
    openclaw models list
  2. Scegli il modello predefinito

    Copia un ID modello dall'elenco, nel formato provider/model, e impostalo come predefinito.

    shell
    openclaw models set <provider/model>
  3. Usa LM Studio in locale

    Avvia il server locale di LM Studio, poi aggiungilo in openclaw.json sotto models.providers.<id> con questo baseUrl e api impostato su openai-responses. È accettata una apiKey segnaposto, ad esempio ollama-local.

    Impostazioni
    Base URL: http://127.0.0.1:1234/v1
    API: openai-responses
  4. Usa vLLM, SGLang o MLX

    Questi server usano la porta 8000 per impostazione predefinita e richiedono che api sia impostato su openai-completions. Registrali allo stesso modo sotto models.providers.<id>. Ollama ha un provider dedicato, mentre llama.cpp è disponibile come plugin con un server locale gestito.

    Impostazioni
    Base URL: http://127.0.0.1:8000/v1
    API: openai-completions

I modelli locali richiedono molta più memoria del gateway. La configurazione minima per llama.cpp richiede da sola circa 8 GiB, quindi controlla la macchina prima di abbandonare un'API cloud.

Altre guide su OpenClaw

Fonti

  1. docs.openclaw.ai/concepts/model-providers/official-provider-plugins
  2. docs.openclaw.ai/gateway/local-models