Drie manieren om Copilot in OpenClaw te gebruiken
- Ingebouwde provider (github-copilot)
- Copilot SDK-harnasplugin (copilot)
- Copilot Proxy-plugin (copilot-proxy)
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.Je wordt gevraagd een URL te bezoeken en een eenmalige code in te voeren. Houd de
terminal open totdat het proces is voltooid.Of in de configuratie:
1
Voer de aanmeldingsopdracht uit
2
Stel een standaardmodel in
GitHub 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.
1
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.2
Het 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:
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.
Bij het wisselen van domein wordt de apparaataanmelding altijd opnieuw uitgevoerd. Als je al een opgeslagen
Copilot-token hebt en een ander domein kiest (openbare
github.com ↔ een *.ghe.com-
tenant, of van de ene tenant naar een andere), gebruikt OpenClaw het bestaande token niet opnieuw —
het dwingt een nieuwe aanmelding af, zodat het token is beperkt tot het domein dat naar de
configuratie wordt geschreven. Als je je opnieuw aanmeldt voor hetzelfde domein, wordt nog steeds aangeboden het huidige
token opnieuw te gebruiken. Als je terugschakelt naar de openbare github.com, wordt de opgeslagen
githubDomain gewist, zodat de configuratie terugkeert naar de standaardinstelling.De omgevingsvariabele
COPILOT_GITHUB_DOMAIN overschrijft het omgezette domein
voor elk Copilot-pad dat dit omzet — de Enterprise-apparaataanmelding
(--method device-enterprise), de zelfstandige
openclaw models auth login-github-copilot-snelkoppeling, tokenvernieuwing, embeddings
en voltooiingen. Stel deze voor volledig headless- of CI-
configuraties in op je *.ghe.com-host. Laat deze oningesteld (en laat de configuratieparameter weg) om de openbare github.com te gebruiken.
Aanmeldingen slaan het domein op waarvoor ze het token hebben aangemaakt (en wissen het bij een aanmelding
bij de openbare github.com), zodat de routering correct blijft, zelfs nadat de
omgevingsvariabele is verwijderd.Optionele vlaggen
Niet-interactieve onboarding
De apparaataanmeldingsflow vereist een interactieve TTY. Importeer voor een headless configuratie een bestaand GitHub OAuth-toegangstoken metopenclaw onboard --non-interactive:
--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
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 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
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):Transportselectie
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
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
Volgorde voor het omzetten van omgevingsvariabelen
OpenClaw haalt Copilot-authenticatie uit omgevingsvariabelen op in de volgende
prioriteitsvolgorde:
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
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
Stelmemory.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.
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.
Gerelateerd
Modelselectie
Providers, modelreferenties en failovergedrag kiezen.
OAuth en authenticatie
Authenticatiedetails en regels voor het hergebruik van aanmeldgegevens.