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 untergeordnete Agent-Schleife für ausgewählte
github-copilot/*-Modelle übernehmen 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 native Copilot-CLI-Sitzungen, einen vom SDK verwalteten
Thread-Zustand und eine von Copilot verwaltete Compaction für diese Agent-Durchläufe
wünschen. Ohne die ausdrückliche Aktivierung von 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 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), befindet sich Copilot auf lokalen
Endpunkten des Mandanten statt 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 unter openclaw models auth
GitHub Copilot (Enterprise / data residency) aus. Sie werden nach Ihrer
Enterprise-Domain gefragt (zum Beispiel your-org.ghe.com); anschließend
erfolgt die Geräteanmeldung bei diesem Mandanten.
Geben Sie nur die Stammadresse des Mandanten (your-org.ghe.com) ein. Abgeleitete
Dienst-Hosts 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 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 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, 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 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
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 für den GitHub-Copilot-Provider
abgeleitet. Wenn das Flag weggelassen wird, greift das Onboarding zunächst auf
COPILOT_GITHUB_TOKEN, dann auf GH_TOKEN und schließlich auf GITHUB_TOKEN zurück.
Verwenden Sie --secret-input-mode ref bei gesetztem COPILOT_GITHUB_TOKEN, um statt
Klartext in auth-profiles.json eine umgebungsvariablenbasierte 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 Geräteanmeldepfad (oder den Umgebungsvariablenpfad) ein GitHub-Token
aufgelöst wurde, aktualisiert OpenClaw den Modellkatalog bei Bedarf über
${baseUrl}/models (denselben Endpunkt, den VS Code Copilot verwendet), damit die
Runtime kontospezifische Berechtigungen und genaue Kontextfenster ohne Änderungen
am Manifest berücksichtigt. Neu veröffentlichte Copilot-Modelle werden ohne ein
OpenClaw-Upgrade sichtbar, und 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 sichtbarer Rückfall erhalten, wenn die
Erkennung deaktiviert ist, der Benutzer kein GitHub-Authentifizierungsprofil besitzt,
der Token-Austausch fehlschlägt oder der HTTPS-Aufruf von /models einen Fehler ergibt.
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-Series- Modelle behalten den OpenAI-Responses-Transport bei. OpenClaw wählt den richtigen Transport anhand der Modellreferenz aus.
Anfragekompatibilität
OpenClaw sendet auf Copilot-Transporten Anfrage-Header im Copilot-IDE-Stil
(Versionen des VS-Code-Editors/Plugins und die Integrations-ID vscode-chat),
kennzeichnet auf Werkzeugergebnisse folgende Durchläufe als vom Agent initiiert
und setzt den Copilot-Vision-Header, wenn ein Durchlauf 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 (Rückfall) |
| 3 | GITHUB_TOKEN |
Standardmäßiges GitHub-Token (niedrigste) |
Wenn mehrere Variablen gesetzt sind, verwendet OpenClaw die 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 memorySearch.provider ausdrücklich, um GitHub-Copilot-Embeddings zu verwenden.
Wenn ein GitHub-Token verfügbar ist, erkennt OpenClaw verfügbare Embedding-Modelle über
die Copilot-API und wählt automatisch das beste aus.
{ agents: { defaults: { memorySearch: { 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 tauscht dieses gegen ein kurzlebiges Copilot-API-Token aus.
- Es fragt den Copilot-Endpunkt
/modelsab, um verfügbare Embedding-Modelle zu erkennen. - Es wählt das beste Modell aus (Präferenzreihenfolge:
text-embedding-3-small,text-embedding-3-large,text-embedding-ada-002). - Es sendet Embedding-Anfragen an den Copilot-Endpunkt
/embeddings.
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.