Auf dieser Seite
Auf dieser Seite
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
Sie werden aufgefordert, eine URL aufzurufen und einen Einmalcode einzugeben. Lassen Sie das Terminal geöffnet, bis der Vorgang abgeschlossen ist.
Standardmodell festlegen
Oder in der Konfiguration:
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.
Aktivieren Sie die Runtime anschließend für ein Modell oder einen Provider:
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:
GitHub 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.
Domain 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:
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 |
Nicht 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:
Sie 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):
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.
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.