Providers
GitHub Copilot
GitHub Copilot è l'assistente di codifica AI di GitHub. Fornisce accesso ai modelli Copilot per il tuo account e piano GitHub. OpenClaw può usare Copilot come provider di modelli in due modi diversi.
Due modi per usare Copilot in OpenClaw
Provider integrato (github-copilot)
Usa il flusso nativo di accesso tramite dispositivo per ottenere un token GitHub, quindi scambialo con token API Copilot quando OpenClaw viene eseguito. Questo è il percorso predefinito e più semplice perché non richiede VS Code.
Esegui il comando di accesso
openclaw models auth login-github-copilot
Ti verrà chiesto di visitare un URL e inserire un codice monouso. Tieni il terminale aperto fino al completamento.
Imposta un modello predefinito
openclaw models set github-copilot/claude-opus-4.7
Oppure nella configurazione:
{
agents: {
defaults: { model: { primary: "github-copilot/claude-opus-4.7" } },
},
}
Plugin Copilot Proxy (copilot-proxy)
Usa l'estensione VS Code Copilot Proxy come bridge locale. OpenClaw comunica con
l'endpoint /v1 del proxy e usa l'elenco dei modelli che configuri lì.
Flag opzionali
| Flag | Descrizione |
|---|---|
--yes |
Salta la richiesta di conferma |
--set-default |
Applica anche il modello predefinito consigliato dal provider |
# Skip confirmation
openclaw models auth login-github-copilot --yes
# Login and set the default model in one step
openclaw models auth login --provider github-copilot --method device --set-default
Onboarding non interattivo
Se hai già un token di accesso OAuth GitHub per Copilot, importalo durante la
configurazione headless con openclaw onboard --non-interactive:
openclaw onboard --non-interactive --accept-risk \
--auth-choice github-copilot \
--github-copilot-token "$COPILOT_GITHUB_TOKEN" \
--skip-channels --skip-health
Puoi anche omettere --auth-choice; passando --github-copilot-token viene dedotta la
scelta di autenticazione del provider GitHub Copilot. Se il flag viene omesso, l'onboarding torna
a COPILOT_GITHUB_TOKEN, GH_TOKEN, quindi GITHUB_TOKEN. Usa
--secret-input-mode ref con COPILOT_GITHUB_TOKEN impostato per archiviare un
tokenRef basato su variabile d'ambiente invece di testo in chiaro in auth-profiles.json.
TTY interattivo richiesto
Il flusso di accesso tramite dispositivo richiede un TTY interattivo. Eseguilo direttamente in un terminale, non in uno script non interattivo o in una pipeline CI.
La disponibilità dei modelli dipende dal tuo piano
La disponibilità dei modelli Copilot dipende dal tuo piano GitHub. Se un modello viene
rifiutato, prova un altro ID (per esempio github-copilot/gpt-4.1).
Selezione del trasporto
Gli ID dei modelli Claude usano automaticamente il trasporto Anthropic Messages. I modelli GPT, o-series e Gemini mantengono il trasporto OpenAI Responses. OpenClaw seleziona il trasporto corretto in base al riferimento del modello.
Compatibilità delle richieste
OpenClaw invia intestazioni di richiesta in stile IDE Copilot sui trasporti Copilot, inclusi turni successivi con Compaction integrata, risultati degli strumenti e immagini. Non abilita la continuazione Responses a livello di provider per Copilot a meno che tale comportamento non sia stato verificato rispetto all'API di Copilot.
Ordine di risoluzione delle variabili d'ambiente
OpenClaw risolve l'autenticazione Copilot dalle variabili d'ambiente nel seguente ordine di priorità:
| Priorità | Variabile | Note |
|---|---|---|
| 1 | COPILOT_GITHUB_TOKEN |
Priorità massima, specifica per Copilot |
| 2 | GH_TOKEN |
Token GitHub CLI (fallback) |
| 3 | GITHUB_TOKEN |
Token GitHub standard (minima) |
Quando sono impostate più variabili, OpenClaw usa quella con priorità più alta.
Il flusso di accesso tramite dispositivo (openclaw models auth login-github-copilot) archivia
il suo token nell'archivio dei profili di autenticazione e ha precedenza su tutte le variabili
d'ambiente.
Archiviazione dei token
L'accesso archivia un token GitHub nell'archivio dei profili di autenticazione e lo scambia con un token API Copilot quando OpenClaw viene eseguito. Non è necessario gestire il token manualmente.
Embedding per la ricerca in memoria
GitHub Copilot può anche fungere da provider di embedding per la ricerca in memoria. Se hai un abbonamento Copilot e hai effettuato l'accesso, OpenClaw può usarlo per gli embedding senza una chiave API separata.
Rilevamento automatico
Quando memorySearch.provider è "auto" (il valore predefinito), GitHub Copilot viene provato
con priorità 15 -- dopo gli embedding locali ma prima di OpenAI e altri
provider a pagamento. Se è disponibile un token GitHub, OpenClaw scopre i
modelli di embedding disponibili dall'API Copilot e sceglie automaticamente quello migliore.
Configurazione esplicita
{
agents: {
defaults: {
memorySearch: {
provider: "github-copilot",
// Optional: override the auto-discovered model
model: "text-embedding-3-small",
},
},
},
}
Come funziona
- OpenClaw risolve il tuo token GitHub (da variabili d'ambiente o profilo di autenticazione).
- Lo scambia con un token API Copilot a breve durata.
- Interroga l'endpoint Copilot
/modelsper scoprire i modelli di embedding disponibili. - Sceglie il modello migliore (preferisce
text-embedding-3-small). - Invia richieste di embedding all'endpoint Copilot
/embeddings.
La disponibilità dei modelli dipende dal tuo piano GitHub. Se non sono disponibili modelli di embedding, OpenClaw salta Copilot e prova il provider successivo.