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 während der Ausführung von OpenClaw gegen Copilot-API-Token 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 @openclaw/copilot Plugin, wenn die Copilot CLI
und das SDK von GitHub die untergeordnete Agentenschleife für ausgewählte
github-copilot/* Modelle steuern sollen.
openclaw plugins install @openclaw/copilotAktivieren Sie die Runtime anschließend 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 diese Option, wenn Sie native Copilot-CLI-Sitzungen, einen vom SDK verwalteten
Thread-Status und eine von Copilot gesteuerte Compaction für diese Agentendurchläufe wünschen. 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 (standardmäßig http://localhost:3000/v1) und verwendet die von Ihnen
konfigurierte Modellliste.
Das copilot-proxy Plugin 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), befindet sich Copilot auf mandantenlokalen
Endpunkten und nicht auf dem öffentlichen github.com. 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 zur Eingabe
Ihrer Enterprise-Domain aufgefordert (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 aus 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 unter den Provider-Parametern gespeichert, sodass spätere Token-Aktualisierungen und Vervollständigungen automatisch an den Mandanten gerichtet werden:
{ models: { providers: { "github-copilot": { params: { githubDomain: "your-org.ghe.com" } }, }, },}Der Geräteablauf, der Token-Austausch und die Vervollständigungen werden jeweils über
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 abgewickelt. Datenresidenz-Token enthalten
eine Mandantenkennung und keinen Proxy-Hinweis, sodass die Basis-URL für Vervollständigungen auf den
Copilot-Host des Mandanten statt auf den öffentlichen Endpunkt zurückfällt.
Optionale Flags
| Befehl | Flag | Beschreibung |
|---|---|---|
openclaw models auth login-github-copilot |
--yes |
Vorhandenes Authentifizierungsprofil ohne Nachfrage überschreiben |
openclaw models auth login --provider github-copilot --method device |
--set-default |
Zusätzlich das vom Provider empfohlene Standardmodell 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 monitorlose Einrichtung
mit openclaw onboard --non-interactive ein vorhandenes GitHub-OAuth-Zugriffstoken:
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 dann GITHUB_TOKEN zurück. Verwenden Sie
--secret-input-mode ref bei gesetztem COPILOT_GITHUB_TOKEN, um ein umgebungsvariablenbasiertes
tokenRef statt Klartext in auth-profiles.json 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 Geräteanmelde- oder Umgebungsvariablen-Authentifizierungspfad ein GitHub-Token aufgelöst wurde,
aktualisiert OpenClaw den Modellkatalog bei Bedarf über ${baseUrl}/models
(denselben Endpunkt, den VS Code Copilot verwendet), sodass die Runtime
kontospezifische Berechtigungen und korrekte Kontextfenster ohne Änderungen am Manifest
berücksichtigt. Neu veröffentlichte Copilot-Modelle werden ohne OpenClaw-
Upgrade sichtbar, und die Kontextfenster entsprechen den tatsächlichen modellspezifischen Grenzwerten
(z. B. 400k für die gpt-5.x-Reihe, 1M für die internen
claude-opus-*-1m Varianten).
Der mitgelieferte statische Katalog bleibt als sichtbare Ausweichoption bestehen, wenn die Erkennung
deaktiviert ist, kein GitHub-Authentifizierungsprofil vorhanden ist, der Token-Austausch
fehlschlägt oder beim HTTPS-Aufruf von /models ein Fehler auftritt. Um dies zu deaktivieren und sich vollständig
auf den statischen Manifestkatalog zu verlassen (Offline-/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 o-Reihen- Modelle verwenden weiterhin den OpenAI-Responses-Transport. OpenClaw wählt den richtigen Transport anhand der Modellreferenz aus.
Anfragekompatibilität
OpenClaw sendet auf Copilot-Transporten Anfrage-Header im Stil der Copilot-IDE
(Versionen des VS-Code-Editors/Plugins und die Integrations-ID vscode-chat),
kennzeichnet auf Werkzeugergebnisse folgende Durchläufe als vom Agenten initiiert und setzt den Copilot-
Vision-Header, wenn ein Durchlauf eine Bildeingabe 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 (Ausweichoption) |
| 3 | GITHUB_TOKEN |
Standard-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 Authentifizierungsprofilspeicher und hat Vorrang vor allen Umgebungsvariablen.
Token-Speicherung
Bei der Anmeldung wird ein GitHub-Token im Authentifizierungsprofilspeicher gespeichert (Profil-ID
github-copilot:github) und während der Ausführung von OpenClaw gegen ein kurzlebiges Copilot-API-
Token ausgetauscht. 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 über ein Copilot-Abonnement verfügen und angemeldet sind, kann OpenClaw Copilot ohne separaten API-Schlüssel für Embeddings verwenden.
Konfiguration
Legen Sie memory.search.provider ausdrücklich fest, um GitHub-Copilot-Embeddings zu verwenden. Wenn ein
GitHub-Token verfügbar ist, ermittelt OpenClaw verfügbare Embedding-Modelle über
die Copilot-API und wählt automatisch das beste aus.
{ memory: { search: { provider: "github-copilot", // Optional: automatisch ermitteltes 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 den nächsten Provider.