Tre modi per usare Copilot in OpenClaw
- Provider integrato (github-copilot)
- Plugin harness Copilot SDK (copilot)
- Plugin Copilot Proxy (copilot-proxy)
Usa il flusso nativo di accesso 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.
Flag facoltativi
| Flag | Descrizione |
|---|---|
--yes | Salta la richiesta di conferma |
--set-default | Applica anche il modello predefinito consigliato dal provider |
Onboarding non interattivo
Se hai già un token di accesso GitHub OAuth per Copilot, importalo durante la configurazione headless conopenclaw onboard --non-interactive:
--auth-choice; passando --github-copilot-token viene dedotta la
scelta di autenticazione del provider GitHub Copilot. Se il flag viene omesso, l’onboarding
ripiega su COPILOT_GITHUB_TOKEN, GH_TOKEN, quindi GITHUB_TOKEN. Usa
--secret-input-mode ref con COPILOT_GITHUB_TOKEN impostato per archiviare un
tokenRef basato su env invece del testo in chiaro in auth-profiles.json.
TTY interattivo richiesto
TTY interattivo richiesto
Il flusso di accesso 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 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-5.5). Consulta
i modelli supportati per piano Copilot
di GitHub per l’elenco aggiornato dei modelli.Aggiornamento live del catalogo dall'API Copilot
Aggiornamento live del catalogo dall'API Copilot
Quando il percorso di autenticazione tramite accesso dispositivo (o variabile env) ha risolto un token GitHub,
OpenClaw aggiorna il catalogo dei modelli su richiesta da
${baseUrl}/models
(lo stesso endpoint usato da VS Code Copilot), così il runtime tiene traccia
dei diritti per account e delle finestre di contesto accurate senza modifiche al manifest.
I modelli Copilot appena pubblicati diventano visibili senza un aggiornamento di OpenClaw
e le finestre di contesto riflettono i limiti reali per modello
(per es. 400k per la serie gpt-5.x, 1M per le varianti interne
claude-opus-*-1m).Il catalogo statico incluso rimane il fallback visibile quando la discovery
è disabilitata, l’utente non ha un profilo di autenticazione GitHub, lo scambio del token
fallisce o la chiamata HTTPS a /models genera un errore. Per disattivare e fare affidamento interamente
sul catalogo del manifest statico (scenari offline / air-gapped):Selezione del trasporto
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
Compatibilità delle richieste
OpenClaw invia header di richiesta in stile IDE Copilot sui trasporti Copilot,
inclusi i turni successivi per Compaction integrata, risultati degli strumenti e immagini. Non
abilita la continuazione Responses a livello di provider per Copilot, a meno che
quel comportamento non sia stato verificato rispetto all’API di Copilot.
Ordine di risoluzione delle variabili di ambiente
Ordine di risoluzione delle variabili di ambiente
OpenClaw risolve l’autenticazione Copilot dalle variabili di ambiente nel seguente
ordine di priorità:
Quando sono impostate più variabili, OpenClaw usa quella con priorità più alta.
Il flusso di accesso dispositivo (
| 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) |
openclaw models auth login-github-copilot) archivia
il suo token nello store dei profili di autenticazione e ha precedenza su tutte le variabili
di ambiente.Archiviazione dei token
Archiviazione dei token
L’accesso archivia un token GitHub nello store dei profili di autenticazione e lo scambia
con un token API Copilot quando OpenClaw viene eseguito. Non devi gestire il
token manualmente.
Embedding per la ricerca in memoria
GitHub Copilot può anche servire come 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.Configurazione
Imposta esplicitamentememorySearch.provider per usare gli embedding GitHub Copilot. Se è
disponibile un token GitHub, OpenClaw scopre i modelli di embedding disponibili dall’API
Copilot e sceglie automaticamente il migliore.
Come funziona
- OpenClaw risolve il tuo token GitHub (da variabili env o profilo di autenticazione).
- Lo scambia con un token API Copilot di breve durata.
- Interroga l’endpoint
/modelsdi Copilot per scoprire i modelli di embedding disponibili. - Sceglie il modello migliore (preferisce
text-embedding-3-small). - Invia richieste di embedding all’endpoint
/embeddingsdi Copilot.
Correlati
Selezione del modello
Scelta dei provider, dei riferimenti dei modelli e del comportamento di failover.
OAuth e autenticazione
Dettagli di autenticazione e regole di riutilizzo delle credenziali.