Providers
GitHub Copilot
GitHub Copilot is de AI-codeerassistent van GitHub. Deze biedt toegang tot Copilot- modellen voor je GitHub-account en -abonnement. OpenClaw kan Copilot op drie verschillende manieren gebruiken als modelprovider of agentruntime.
Drie manieren om Copilot in OpenClaw te gebruiken
Ingebouwde provider (github-copilot)
Gebruik de ingebouwde aanmeldingsflow voor apparaten om een GitHub-token te verkrijgen en wissel dit vervolgens in voor Copilot-API-tokens wanneer OpenClaw wordt uitgevoerd. Dit is het standaardpad en het eenvoudigste pad, omdat VS Code niet vereist is.
Voer de aanmeldingsopdracht uit
openclaw models auth login-github-copilotJe wordt gevraagd een URL te bezoeken en een eenmalige code in te voeren. Houd de terminal open totdat het proces is voltooid.
Stel een standaardmodel in
openclaw models set github-copilot/claude-opus-4.7Of in de configuratie:
{ agents: { defaults: { model: { primary: "github-copilot/claude-opus-4.7" } }, },}Copilot SDK-harnasplugin (copilot)
Installeer de externe @openclaw/copilot-plugin wanneer je wilt dat de Copilot CLI
en SDK van GitHub de agentlus op laag niveau beheren voor geselecteerde
github-copilot/*-modellen.
openclaw plugins install @openclaw/copilotLaat vervolgens een model of provider de runtime gebruiken:
{ agents: { defaults: { model: "github-copilot/gpt-5.5", models: { "github-copilot/gpt-5.5": { agentRuntime: { id: "copilot" }, }, }, }, },}Kies dit wanneer je systeemeigen Copilot CLI-sessies, door de SDK beheerde threadstatus
en door Copilot beheerde Compaction voor die agentbeurten wilt. Zonder de
expliciete agentRuntime-inschakeling blijven github-copilot/*-modellen de
ingebouwde provider gebruiken. Zie Copilot SDK-harnas voor het volledige
runtimecontract.
Copilot Proxy-plugin (copilot-proxy)
Gebruik de VS Code-extensie Copilot Proxy als lokale brug. OpenClaw communiceert met
het /v1-eindpunt van de proxy (standaard http://localhost:3000/v1) en gebruikt de
door jou geconfigureerde modellenlijst.
De copilot-proxy-plugin wordt met OpenClaw meegeleverd en is standaard ingeschakeld.
Configureer de basis-URL en model-id's met:
openclaw models auth login --provider copilot-proxy --set-defaultGitHub Enterprise (gegevensresidentie)
Als je organisatie een GitHub Enterprise-tenant met gegevensresidentie gebruikt (een
*.ghe.com-host zoals your-org.ghe.com), bevindt Copilot zich op tenantlokale
eindpunten in plaats van op de openbare github.com. OpenClaw biedt dit aan als een
volwaardige authenticatiekeuze, zodat je URL's niet handmatig hoeft te bewerken.
Kies de Enterprise-authenticatieoptie
Kies tijdens de onboarding of in openclaw models auth
GitHub Copilot (Enterprise / data residency). Je wordt gevraagd naar
je Enterprise-domein (bijvoorbeeld your-org.ghe.com), waarna de apparaataanmelding
voor die tenant wordt uitgevoerd.
Voer alleen de tenantroot in (your-org.ghe.com). Afgeleide servicehosts zoals
api.your-org.ghe.com of copilot-api.your-org.ghe.com worden niet geaccepteerd;
OpenClaw leidt die eindpunten automatisch af van de tenantroot.
openclaw models auth login --provider github-copilot --method device-enterpriseHet domein wordt opgeslagen in de configuratie
De gekozen host wordt opgeslagen onder de providerparameters, zodat latere tokenvernieuwingen en voltooiingen automatisch op de tenant worden gericht:
{ models: { providers: { "github-copilot": { params: { githubDomain: "your-org.ghe.com" } }, }, },}De apparaatflow, tokenuitwisseling en voltooiingen worden respectievelijk omgezet naar
https://your-org.ghe.com/login/device/code,
https://api.your-org.ghe.com/copilot_internal/v2/token en
https://copilot-api.your-org.ghe.com. Tokens voor gegevensresidentie bevatten
een tenantstempel en geen proxyhint, waardoor de basis-URL voor voltooiingen terugvalt op de
Copilot-host van de tenant in plaats van op het openbare eindpunt.
Optionele vlaggen
| Opdracht | Vlag | Beschrijving |
|---|---|---|
openclaw models auth login-github-copilot |
--yes |
Overschrijf een bestaand authenticatieprofiel zonder bevestiging te vragen |
openclaw models auth login --provider github-copilot --method device |
--set-default |
Pas ook het aanbevolen standaardmodel van de provider toe |
# Sla de bevestiging voor opnieuw aanmelden overopenclaw models auth login-github-copilot --yes # Meld je aan en stel het standaardmodel in één stap inopenclaw models auth login --provider github-copilot --method device --set-defaultNiet-interactieve onboarding
De apparaataanmeldingsflow vereist een interactieve TTY. Importeer voor een headless configuratie
een bestaand GitHub OAuth-toegangstoken met openclaw onboard --non-interactive:
openclaw onboard --non-interactive --accept-risk \ --auth-choice github-copilot \ --github-copilot-token "$COPILOT_GITHUB_TOKEN" \ --skip-channels --skip-healthJe kunt --auth-choice ook weglaten; door --github-copilot-token door te geven, wordt de
GitHub Copilot-provider als authenticatiekeuze afgeleid. Als de vlag wordt weggelaten, valt onboarding
terug op COPILOT_GITHUB_TOKEN, GH_TOKEN en vervolgens GITHUB_TOKEN. Gebruik
--secret-input-mode ref terwijl COPILOT_GITHUB_TOKEN is ingesteld om een door een omgevingsvariabele ondersteunde
tokenRef op te slaan in plaats van platte tekst in auth-profiles.json.
Interactieve TTY vereist
De apparaataanmeldingsflow vereist een interactieve TTY. Voer deze rechtstreeks uit in een terminal, niet in een niet-interactief script of een CI-pijplijn.
De beschikbaarheid van modellen hangt af van je abonnement
De beschikbaarheid van Copilot-modellen hangt af van je GitHub-abonnement. Als een model wordt
geweigerd, probeer dan een andere ID (bijvoorbeeld github-copilot/gpt-5.5). Zie
de ondersteunde modellen per Copilot-abonnement van GitHub
voor de actuele modellenlijst.
Live catalogusvernieuwing vanuit de Copilot API
Zodra het authenticatiepad via apparaataanmelding (of omgevingsvariabele) een GitHub-token heeft verkregen,
vernieuwt OpenClaw de modelcatalogus op verzoek vanuit ${baseUrl}/models
(hetzelfde eindpunt dat VS Code Copilot gebruikt), zodat de runtime
de rechten per account en nauwkeurige contextvensters volgt zonder
wijzigingen aan het manifest. Nieuw gepubliceerde Copilot-modellen worden zichtbaar zonder een OpenClaw-
upgrade en contextvensters weerspiegelen de werkelijke limieten per model
(bijvoorbeeld 400k voor de gpt-5.x-serie, 1M voor de interne
claude-opus-*-1m-varianten).
De meegeleverde statische catalogus blijft de zichtbare terugvaloptie wanneer detectie
is uitgeschakeld, de gebruiker geen GitHub-authenticatieprofiel heeft, de tokenuitwisseling
mislukt of de HTTPS-aanroep naar /models een fout oplevert. Om dit uit te schakelen en volledig
te vertrouwen op de statische manifestcatalogus (offline-/air-gappedscenario's):
{ plugins: { entries: { "github-copilot": { config: { discovery: { enabled: false } }, }, }, },}Transportselectie
Claude-model-id's gebruiken automatisch het Anthropic Messages-transport. Gemini-modellen gebruiken het OpenAI Chat Completions-transport; GPT- en o-serie- modellen blijven het OpenAI Responses-transport gebruiken. OpenClaw selecteert het juiste transport op basis van de modelverwijzing.
Compatibiliteit van aanvragen
OpenClaw verzendt aanvraagheaders in Copilot IDE-stijl via Copilot-transporten
(versies van de VS Code-editor/plugin en de vscode-chat-integratie-id),
markeert vervolgbeurten met toolresultaten als door de agent geïnitieerd en stelt de Copilot-
vision-header in wanneer een beurt afbeeldingsinvoer bevat.
Volgorde voor het omzetten van omgevingsvariabelen
OpenClaw haalt Copilot-authenticatie uit omgevingsvariabelen op in de volgende prioriteitsvolgorde:
| Prioriteit | Variabele | Opmerkingen |
|---|---|---|
| 1 | COPILOT_GITHUB_TOKEN |
Hoogste prioriteit, specifiek voor Copilot |
| 2 | GH_TOKEN |
GitHub CLI-token (terugvaloptie) |
| 3 | GITHUB_TOKEN |
Standaard GitHub-token (laagste prioriteit) |
Wanneer meerdere variabelen zijn ingesteld, gebruikt OpenClaw de variabele met de hoogste prioriteit.
De apparaataanmeldingsflow (openclaw models auth login-github-copilot) slaat
het token op in de authenticatieprofielopslag en krijgt voorrang op alle omgevingsvariabelen.
Tokenopslag
De aanmelding slaat een GitHub-token op in de authenticatieprofielopslag (profiel-id
github-copilot:github) en wisselt dit in voor een kortlevend Copilot API-
token wanneer OpenClaw wordt uitgevoerd. Je hoeft het token niet handmatig te beheren.
Embeddings voor geheugenzoekopdrachten
GitHub Copilot kan ook fungeren als embeddingprovider voor geheugenzoekopdrachten. Als je een Copilot-abonnement hebt en bent aangemeld, kan OpenClaw dit zonder afzonderlijke API-sleutel gebruiken voor embeddings.
Configuratie
Stel memory.search.provider expliciet in om GitHub Copilot-embeddings te gebruiken. Als een
GitHub-token beschikbaar is, detecteert OpenClaw beschikbare embeddingmodellen via
de Copilot API en kiest het automatisch het beste model.
{ memory: { search: { provider: "github-copilot", // Optioneel: overschrijf het automatisch gedetecteerde model model: "text-embedding-3-small", }, },}Hoe het werkt
- OpenClaw haalt je GitHub-token op (uit omgevingsvariabelen of het authenticatieprofiel).
- Wisselt het in voor een kortlevend Copilot API-token.
- Vraagt het Copilot-eindpunt
/modelsop om beschikbare embeddingmodellen te detecteren. - Kiest het beste model (voorkeursvolgorde:
text-embedding-3-small,text-embedding-3-large,text-embedding-ada-002). - Verzendt embeddingaanvragen naar het Copilot-eindpunt
/embeddings.
De beschikbaarheid van modellen hangt af van je GitHub-abonnement. Als er geen embeddingmodellen beschikbaar zijn, slaat OpenClaw Copilot over en probeert het de volgende provider.
