Vai al contenuto principale
Un assistente IA personale open source e self-hosted. Sito: https://openclaw.ai (docs: https://docs.openclaw.ai, repo: https://github.com/openclaw/openclaw).
Protocollo: compatibile con OpenAI
  • Base URL: https://api.orcarouter.ai/v1 (deve includere /v1)

​
Installazione

Richiede Node 22+. Installa il comando openclaw: 
npm install -g openclaw
Oppure su macOS/Linux: 
curl -fsSL https://openclaw.ai/install.sh | bash

​
Configurazione

Modifica ~/.openclaw/openclaw.json: 
{
  "models": {
    "mode": "merge",
    "providers": {
      "orcarouter": {
        "baseUrl": "https://api.orcarouter.ai/v1",
        "apiKey": "sk-orca-...",
        "api": "openai-completions",
        "models": [ { "id": "orcarouter/auto", "name": "OrcaRouter Auto" } ]
      }
    }
  },
  "agents": { "defaults": { "model": { "primary": "orcarouter/orcarouter/auto" } } },
  "gateway": { "mode": "local" }
}

​
Esecuzione

openclaw agent --local --agent main --session-id s1 -m "Reply with exactly: OK"
Aspettati la risposta OK.

​
Note

  • baseUrl deve trovarsi sotto models.providers.<name>, non all’interno di ciascuna voce del modello. Metterlo su un modello dà Unrecognized key: "baseUrl".
  • Il base URL mantiene il /v1 finale. I riferimenti ai modelli usano provider/model, quindi il router automatico è orcarouter/orcarouter/auto.
  • Il nome dell’agente di default è main (non default). Per esecuzioni non interattive usa --local con un --session-id.
  • I nomi dei modelli usano il formato vendor/model. Sostituisci orcarouter/auto con un modello specifico come anthropic/claude-opus-4.8 o google/gemini-2.5-flash (e aggiorna di conseguenza il riferimento primary).

​
Thinking / reasoning

OpenClaw comunica con OrcaRouter tramite l’API standard compatibile con OpenAI (api: "openai-completions"), quindi il reasoning segue il comportamento del modello stesso — scegli un modello capace di reasoning (ad es. un modello di reasoning anthropic/claude-*) e ragionerà come configurato a monte.