Providers
GitHub Copilot
GitHub Copilot ist der KI-Programmierassistent von GitHub. Er bietet Zugriff auf Copilot- Modelle für Ihr GitHub-Konto und Ihren Tarif. OpenClaw kann Copilot auf drei verschiedene Arten als Modell-Provider oder Agent-Runtime verwenden.
Drei Möglichkeiten, Copilot in OpenClaw zu verwenden
Integrierter Provider (github-copilot)
Verwenden Sie den nativen Geräteanmeldeablauf, um ein GitHub-Token zu erhalten, und tauschen Sie es anschließend zur Laufzeit von OpenClaw gegen Copilot-API-Tokens aus. Dies ist der standardmäßige und einfachste Weg, da dafür kein VS Code erforderlich ist.
Anmeldebefehl ausführen
openclaw models auth login-github-copilotSie werden aufgefordert, eine URL aufzurufen und einen Einmalcode einzugeben. Lassen Sie das Terminal geöffnet, bis der Vorgang abgeschlossen ist.
Standardmodell festlegen
openclaw models set github-copilot/claude-opus-4.7Oder in der Konfiguration:
{ agents: { defaults: { model: { primary: "github-copilot/claude-opus-4.7" } }, },}Copilot-SDK-Harness-Plugin (copilot)
Installieren Sie das externe Plugin @openclaw/copilot, wenn die Copilot-CLI
und das SDK von GitHub die Agent-Schleife auf niedriger Ebene für ausgewählte
github-copilot/*-Modelle steuern sollen.
openclaw plugins install @openclaw/copilotAktivieren Sie anschließend die Runtime für ein Modell oder einen Provider:
{ agents: { defaults: { model: "github-copilot/gpt-5.5", models: { "github-copilot/gpt-5.5": { agentRuntime: { id: "copilot" }, }, }, }, },}Wählen Sie dies, wenn Sie für diese Agent-Schritte native Copilot-CLI-Sitzungen,
eine vom SDK verwaltete Thread-Zustandsverwaltung und eine Copilot-eigene Compaction
verwenden möchten. Ohne die ausdrückliche Aktivierung über agentRuntime
verwenden github-copilot/*-Modelle weiterhin den integrierten Provider. Den
vollständigen Runtime-Vertrag finden Sie unter Copilot-SDK-Harness.
Copilot-Proxy-Plugin (copilot-proxy)
Verwenden Sie die VS-Code-Erweiterung Copilot Proxy als lokale Brücke. OpenClaw
kommuniziert mit dem /v1-Endpunkt des Proxys (Standard:
http://localhost:3000/v1) und verwendet die von Ihnen konfigurierte Modellliste.
Das Plugin copilot-proxy wird mit OpenClaw ausgeliefert und ist standardmäßig
aktiviert. Konfigurieren Sie die Basis-URL und die Modell-IDs mit:
openclaw models auth login --provider copilot-proxy --set-defaultGitHub Enterprise (Datenresidenz)
Wenn Ihre Organisation einen GitHub-Enterprise-Mandanten mit Datenresidenz verwendet
(einen *.ghe.com-Host wie your-org.ghe.com), ist Copilot über
mandantenlokale Endpunkte statt über das öffentliche github.com verfügbar.
OpenClaw stellt dies als vollwertige Authentifizierungsoption bereit, sodass Sie URLs
nicht manuell bearbeiten müssen.
Enterprise-Authentifizierungsoption auswählen
Wählen Sie beim Onboarding oder in openclaw models auth
GitHub Copilot (Enterprise / data residency) aus. Sie werden nach Ihrer
Enterprise-Domain gefragt (zum Beispiel your-org.ghe.com); anschließend
wird die Geräteanmeldung bei diesem Mandanten ausgeführt.
Geben Sie nur die Stammadresse des Mandanten ein (your-org.ghe.com).
Abgeleitete Diensthosts wie api.your-org.ghe.com oder copilot-api.your-org.ghe.com
werden nicht akzeptiert; OpenClaw leitet diese Endpunkte automatisch von
der Stammadresse des Mandanten ab.
openclaw models auth login --provider github-copilot --method device-enterpriseDomain wird in der Konfiguration gespeichert
Der ausgewählte Host wird in den Provider-Parametern gespeichert, sodass spätere Token-Aktualisierungen und Vervollständigungen automatisch an den Mandanten gesendet werden:
{ models: { providers: { "github-copilot": { params: { githubDomain: "your-org.ghe.com" } }, }, },}Geräteablauf, Token-Austausch und Vervollständigungen werden jeweils zu
https://your-org.ghe.com/login/device/code,
https://api.your-org.ghe.com/copilot_internal/v2/token und
https://copilot-api.your-org.ghe.com aufgelöst. Datenresidenz-Tokens enthalten
eine Mandantenkennung und keinen Proxy-Hinweis. Daher greift die Basis-URL für
Vervollständigungen auf den Copilot-Host des Mandanten statt auf den öffentlichen
Endpunkt zurück.
Optionale Flags
| Befehl | Flag | Beschreibung |
|---|---|---|
openclaw models auth login-github-copilot |
--yes |
Vorhandenes Authentifizierungsprofil ohne Rückfrage überschreiben |
openclaw models auth login --provider github-copilot --method device |
--set-default |
Auch das empfohlene Standardmodell des Providers anwenden |
# Bestätigung für die erneute Anmeldung überspringenopenclaw models auth login-github-copilot --yes # Anmelden und das Standardmodell in einem Schritt festlegenopenclaw models auth login --provider github-copilot --method device --set-defaultNicht interaktives Onboarding
Der Geräteanmeldeablauf erfordert ein interaktives TTY. Importieren Sie für eine
Headless-Konfiguration ein vorhandenes GitHub-OAuth-Zugriffstoken mit
openclaw onboard --non-interactive:
openclaw onboard --non-interactive --accept-risk \ --auth-choice github-copilot \ --github-copilot-token "$COPILOT_GITHUB_TOKEN" \ --skip-channels --skip-healthSie können --auth-choice auch weglassen; durch die Übergabe von
--github-copilot-token wird die Authentifizierungsoption des GitHub-Copilot-Providers
abgeleitet. Wenn das Flag weggelassen wird, greift das Onboarding nacheinander auf
COPILOT_GITHUB_TOKEN, GH_TOKEN und GITHUB_TOKEN zurück. Verwenden
Sie --secret-input-mode ref bei gesetztem COPILOT_GITHUB_TOKEN, um statt Klartext in
auth-profiles.json ein umgebungsvariablenbasiertes tokenRef zu speichern.
Interaktives TTY erforderlich
Der Geräteanmeldeablauf erfordert ein interaktives TTY. Führen Sie ihn direkt in einem Terminal aus, nicht in einem nicht interaktiven Skript oder einer CI-Pipeline.
Modellverfügbarkeit hängt von Ihrem Tarif ab
Die Verfügbarkeit von Copilot-Modellen hängt von Ihrem GitHub-Tarif ab. Wenn ein
Modell abgelehnt wird, versuchen Sie eine andere ID (zum Beispiel
github-copilot/gpt-5.5). Die aktuelle Modellliste finden Sie in der GitHub-Dokumentation
zu den unterstützten Modellen je Copilot-Tarif.
Live-Aktualisierung des Katalogs über die Copilot-API
Sobald über den Authentifizierungspfad der Geräteanmeldung oder Umgebungsvariable
ein GitHub-Token aufgelöst wurde, aktualisiert OpenClaw den Modellkatalog bei Bedarf
über ${baseUrl}/models (denselben Endpunkt, den VS Code Copilot verwendet). Dadurch
berücksichtigt die Runtime die Berechtigungen des jeweiligen Kontos und die genauen
Kontextfenster, ohne dass das Manifest ständig geändert werden muss. Neu veröffentlichte
Copilot-Modelle werden ohne OpenClaw-Upgrade sichtbar, und die Kontextfenster entsprechen
den tatsächlichen modellspezifischen Grenzen (z. B. 400k für die gpt-5.x-Reihe und 1M
für die internen claude-opus-*-1m-Varianten).
Der mitgelieferte statische Katalog bleibt als sichtbare Ausweichlösung erhalten, wenn
die Erkennung deaktiviert ist, der Benutzer kein GitHub-Authentifizierungsprofil besitzt,
der Token-Austausch fehlschlägt oder beim HTTPS-Aufruf von /models ein Fehler
auftritt. So deaktivieren Sie die Erkennung und verwenden ausschließlich den statischen
Manifestkatalog (Offline- oder Air-Gap-Szenarien):
{ plugins: { entries: { "github-copilot": { config: { discovery: { enabled: false } }, }, }, },}Transportauswahl
Claude-Modell-IDs verwenden automatisch den Anthropic-Messages-Transport. Gemini-Modelle verwenden den OpenAI-Chat-Completions-Transport; GPT- und Modelle der o-Reihe verwenden weiterhin den OpenAI-Responses-Transport. OpenClaw wählt anhand der Modellreferenz den korrekten Transport aus.
Anfragekompatibilität
OpenClaw sendet bei Copilot-Transporten Anfrage-Header im Stil der Copilot-IDE
(Versionen des VS-Code-Editors und -Plugins sowie die Integrations-ID
vscode-chat), kennzeichnet auf Werkzeugergebnisse folgende Schritte als
vom Agent initiiert und setzt den Copilot-Vision-Header, wenn ein Schritt
Bildeingaben enthält.
Auflösungsreihenfolge der Umgebungsvariablen
OpenClaw löst die Copilot-Authentifizierung anhand von Umgebungsvariablen in der folgenden Prioritätsreihenfolge auf:
| Priorität | Variable | Hinweise |
|---|---|---|
| 1 | COPILOT_GITHUB_TOKEN |
Höchste Priorität, Copilot-spezifisch |
| 2 | GH_TOKEN |
GitHub-CLI-Token (Ausweichlösung) |
| 3 | GITHUB_TOKEN |
Standardmäßiges GitHub-Token (niedrigste) |
Wenn mehrere Variablen gesetzt sind, verwendet OpenClaw diejenige mit der höchsten
Priorität. Der Geräteanmeldeablauf (openclaw models auth login-github-copilot) speichert sein Token im
Speicher für Authentifizierungsprofile und hat Vorrang vor allen Umgebungsvariablen.
Token-Speicherung
Die Anmeldung speichert ein GitHub-Token im Speicher für Authentifizierungsprofile
(Profil-ID github-copilot:github) und tauscht es zur Laufzeit von OpenClaw gegen ein
kurzlebiges Copilot-API-Token aus. Sie müssen das Token nicht manuell verwalten.
Embeddings für die Speichersuche
GitHub Copilot kann auch als Embedding-Provider für die Speichersuche dienen. Wenn Sie ein Copilot-Abonnement besitzen und angemeldet sind, kann OpenClaw Copilot ohne separaten API-Schlüssel für Embeddings verwenden.
Konfiguration
Setzen Sie memory.search.provider ausdrücklich, um GitHub-Copilot-Embeddings zu verwenden.
Wenn ein GitHub-Token verfügbar ist, erkennt OpenClaw die verfügbaren Embedding-Modelle
über die Copilot-API und wählt automatisch das beste aus.
{ memory: { search: { provider: "github-copilot", // Optional: automatisch erkanntes Modell überschreiben model: "text-embedding-3-small", }, },}Funktionsweise
- OpenClaw löst Ihr GitHub-Token auf (aus Umgebungsvariablen oder dem Authentifizierungsprofil).
- Es wird gegen ein kurzlebiges Copilot-API-Token ausgetauscht.
- Der Copilot-Endpunkt
/modelswird abgefragt, um verfügbare Embedding-Modelle zu ermitteln. - Das beste Modell wird ausgewählt (Präferenzreihenfolge:
text-embedding-3-small,text-embedding-3-large,text-embedding-ada-002). - Embedding-Anfragen werden an den Copilot-Endpunkt
/embeddingsgesendet.
Die Modellverfügbarkeit hängt von Ihrem GitHub-Tarif ab. Wenn keine Embedding-Modelle verfügbar sind, überspringt OpenClaw Copilot und versucht es mit dem nächsten Provider.