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 apparaat-aanmeldingsflow om een GitHub-token te verkrijgen en wissel dit vervolgens tijdens het uitvoeren van OpenClaw in voor Copilot API-tokens. 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 Plugin @openclaw/copilot 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/copilotSchakel vervolgens een model of provider in voor de runtime:
{ agents: { defaults: { model: "github-copilot/gpt-5.5", models: { "github-copilot/gpt-5.5": { agentRuntime: { id: "copilot" }, }, }, }, },}Kies dit wanneer je voor die agentbeurten ingebouwde Copilot CLI-sessies,
door de SDK beheerde threadstatus en door Copilot beheerde Compaction 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 modellenlijst die je configureert.
De Plugin copilot-proxy 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 (gegevenslocatie)
Als je organisatie een GitHub Enterprise-tenant met gegevenslocatie gebruikt
(een *.ghe.com-host, zoals your-org.ghe.com), bevindt Copilot zich op lokale
eindpunten van de tenant in plaats van op het openbare github.com. OpenClaw
biedt dit aan als volwaardige verificatiekeuze, zodat je URL's niet handmatig
hoeft te bewerken.
Kies de Enterprise-verificatieoptie
Kies tijdens de onboarding of in openclaw models auth
GitHub Copilot (Enterprise / data residency). Je wordt gevraagd om je
Enterprise-domein (bijvoorbeeld your-org.ghe.com), waarna de
apparaat-aanmelding 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 in de configuratie opgeslagen
De gekozen host wordt onder de providerparameters opgeslagen, 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 gegevenslocatie bevatten
een tenantstempel en geen proxyaanwijzing. Daardoor valt de basis-URL voor
voltooiingen terug 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 verificatieprofiel zonder bevestiging |
openclaw models auth login --provider github-copilot --method device |
--set-default |
Pas ook het aanbevolen standaardmodel van de provider toe |
# De bevestiging voor opnieuw aanmelden overslaanopenclaw models auth login-github-copilot --yes # Aanmelden en het standaardmodel in één stap instellenopenclaw models auth login --provider github-copilot --method device --set-defaultNiet-interactieve onboarding
Voor de apparaat-aanmeldingsflow is een interactieve TTY vereist. Importeer voor
een headless opstelling 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 providerverificatiekeuze voor GitHub Copilot afgeleid. Als de vlag
wordt weggelaten, valt de onboarding terug op COPILOT_GITHUB_TOKEN, daarna
GH_TOKEN en vervolgens GITHUB_TOKEN. Gebruik --secret-input-mode ref met
een ingestelde COPILOT_GITHUB_TOKEN om een door een omgevingsvariabele
ondersteunde tokenRef op te slaan in plaats van leesbare tekst in
auth-profiles.json.
Interactieve TTY vereist
Voor de apparaat-aanmeldingsflow is een interactieve TTY vereist. Voer deze rechtstreeks in een terminal uit, niet in een niet-interactief script of een CI-pijplijn.
Modelbeschikbaarheid is afhankelijk van je abonnement
De beschikbaarheid van Copilot-modellen is afhankelijk 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 huidige modellenlijst.
Live catalogusvernieuwing vanuit de Copilot API
Zodra het verificatiepad via apparaat-aanmelding (of omgevingsvariabele)
een GitHub-token heeft bepaald, vernieuwt OpenClaw de modelcatalogus op
aanvraag via ${baseUrl}/models (hetzelfde eindpunt dat VS Code Copilot
gebruikt). Zo volgt de runtime de rechten per account en nauwkeurige
contextvensters zonder wijzigingen in 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 en 1M voor de interne
claude-opus-*-1m-varianten).
De meegeleverde statische catalogus blijft zichtbaar als terugvaloptie
wanneer detectie is uitgeschakeld, de gebruiker geen GitHub-
verificatieprofiel heeft, de tokenuitwisseling mislukt of de HTTPS-aanroep
naar /models een fout oplevert. Als je dit wilt uitschakelen en volledig
wilt vertrouwen op de statische manifestcatalogus (offline of fysiek van
netwerken gescheiden scenario'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.
Aanvraagcompatibiliteit
OpenClaw verzendt aanvraagheaders in Copilot IDE-stijl via Copilot-
transporten (versies van de VS Code-editor en -Plugin en de integratie-ID
vscode-chat), markeert vervolgbeurten met toolresultaten als door de agent
geïnitieerd en stelt de Copilot-visionheader in wanneer een beurt
afbeeldingsinvoer bevat.
Volgorde voor het bepalen van omgevingsvariabelen
OpenClaw bepaalt Copilot-verificatie via omgevingsvariabelen 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) |
Wanneer meerdere variabelen zijn ingesteld, gebruikt OpenClaw de variabele
met de hoogste prioriteit. De apparaat-aanmeldingsflow
(openclaw models auth login-github-copilot) slaat het token op in de
verificatieprofielopslag en heeft voorrang op alle omgevingsvariabelen.
Tokenopslag
De aanmelding slaat een GitHub-token op in de verificatieprofielopslag
(profiel-ID github-copilot:github) en wisselt dit tijdens het uitvoeren
van OpenClaw in voor een kortstondig Copilot API-token. 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 gebruiken voor embeddings zonder een afzonderlijke API-sleutel.
Configuratie
Stel memorySearch.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.
{ agents: { defaults: { memorySearch: { provider: "github-copilot", // Optioneel: het automatisch gedetecteerde model overschrijven model: "text-embedding-3-small", }, }, },}Werking
- OpenClaw bepaalt je GitHub-token (via omgevingsvariabelen of een verificatieprofiel).
- Het token wordt ingewisseld voor een kortstondig Copilot API-token.
- Het Copilot-eindpunt
/modelswordt opgevraagd om beschikbare embeddingmodellen te detecteren. - Het beste model wordt gekozen (voorkeursvolgorde:
text-embedding-3-small,text-embedding-3-large,text-embedding-ada-002). - Embeddingaanvragen worden naar het Copilot-eindpunt
/embeddingsverzonden.
De beschikbaarheid van modellen is afhankelijk van je GitHub-abonnement. Als er geen embeddingmodellen beschikbaar zijn, slaat OpenClaw Copilot over en probeert het de volgende provider.