Providers
GitHub Copilot
GitHub Copilot ist der KI-Coding-Assistent von GitHub. Er bietet Zugriff auf Copilot-Modelle für Ihr GitHub-Konto und Ihren Plan. 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 Device-Login-Ablauf, um ein GitHub-Token zu erhalten, und tauschen Sie es dann gegen Copilot-API-Token aus, wenn OpenClaw ausgeführt wird. Dies ist der standardmäßige und einfachste Weg, da er VS Code nicht erfordert.
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 GitHubs Copilot-CLI und SDK den Low-Level-Agent-Loop für ausgewählte github-copilot/*-Modelle übernehmen sollen.
openclaw plugins install clawhub:@openclaw/copilotBinden Sie anschließend ein Modell oder einen Provider in die Runtime ein:
{ 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, SDK-verwalteten Thread-Status und Copilot-eigene Compaction für diese Agent-Turns wünschen. Siehe Copilot-SDK-Harness für den vollständigen Runtime-Vertrag.
Copilot-Proxy-Plugin (copilot-proxy)
Verwenden Sie die VS-Code-Erweiterung Copilot Proxy als lokale Bridge. OpenClaw kommuniziert mit dem /v1-Endpunkt des Proxys und verwendet die dort konfigurierte Modellliste.
Optionale Flags
| Flag | Beschreibung |
|---|---|
--yes |
Bestätigungsabfrage überspringen |
--set-default |
Auch das vom Provider empfohlene Standardmodell anwenden |
# Skip confirmationopenclaw models auth login-github-copilot --yes # Login and set the default model in one stepopenclaw models auth login --provider github-copilot --method device --set-defaultNicht interaktives Onboarding
Wenn Sie bereits ein GitHub-OAuth-Zugriffstoken für Copilot haben, importieren Sie es während der Headless-Einrichtung 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 Übergabe von --github-copilot-token wird die Authentifizierungsauswahl für den GitHub-Copilot-Provider abgeleitet. Wenn das Flag weggelassen wird, fällt das Onboarding auf COPILOT_GITHUB_TOKEN, GH_TOKEN und dann GITHUB_TOKEN zurück. Verwenden Sie --secret-input-mode ref mit gesetztem COPILOT_GITHUB_TOKEN, um statt Klartext in auth-profiles.json eine env-gestützte tokenRef zu speichern.
Interaktives TTY erforderlich
Der Device-Login-Ablauf 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 Plan ab
Die Verfügbarkeit von Copilot-Modellen hängt von Ihrem GitHub-Plan ab. Wenn ein Modell abgelehnt wird, versuchen Sie eine andere ID (zum Beispiel github-copilot/gpt-5.5). Siehe GitHubs unterstützte Modelle pro Copilot-Plan für die aktuelle Modellliste.
Live-Katalogaktualisierung aus der Copilot-API
Sobald der Authentifizierungspfad per Device-Login (oder Env-Var) ein GitHub-Token aufgelöst hat, aktualisiert OpenClaw den Modellkatalog bei Bedarf von ${baseUrl}/models (demselben Endpunkt, den VS Code Copilot verwendet), sodass die Runtime kontospezifische Berechtigungen und genaue Kontextfenster ohne Manifest-Änderungen verfolgt. Neu veröffentlichte Copilot-Modelle werden ohne OpenClaw-Upgrade sichtbar, und Kontextfenster spiegeln die realen modellbezogenen Limits wider (z. B. 400k für die gpt-5.x-Serie, 1M für die internen claude-opus-*-1m-Varianten).
Der gebündelte statische Katalog bleibt der sichtbare Fallback, wenn Discovery deaktiviert ist, der Benutzer kein GitHub-Auth-Profil hat, der Token-Austausch fehlschlägt oder der HTTPS-Aufruf von /models einen Fehler ausgibt. Um dies abzuwählen und vollständig auf den statischen Manifest-Katalog zu setzen (Offline-/Air-Gapped-Szenarien):
{ plugins: { entries: { "github-copilot": { config: { discovery: { enabled: false } }, }, }, },}Transportauswahl
Claude-Modell-IDs verwenden automatisch den Anthropic-Messages-Transport. GPT-, o-series- und Gemini-Modelle behalten den OpenAI-Responses-Transport. OpenClaw wählt den richtigen Transport anhand der Modellreferenz aus.
Request-Kompatibilität
OpenClaw sendet Copilot-IDE-artige Request-Header auf Copilot-Transporten, einschließlich integrierter Compaction sowie Tool-Ergebnis- und Bild-Follow-up-Turns. Es aktiviert keine Provider-seitige Responses-Fortsetzung für Copilot, es sei denn, dieses Verhalten wurde gegen Copilots API verifiziert.
Auflösungsreihenfolge für Umgebungsvariablen
OpenClaw löst Copilot-Authentifizierung aus 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 (Fallback) |
| 3 | GITHUB_TOKEN |
Standard-GitHub-Token (niedrigste Priorität) |
Wenn mehrere Variablen gesetzt sind, verwendet OpenClaw diejenige mit der höchsten Priorität. Der Device-Login-Ablauf (openclaw models auth login-github-copilot) speichert sein Token im Auth-Profil-Speicher und hat Vorrang vor allen Umgebungsvariablen.
Token-Speicherung
Die Anmeldung speichert ein GitHub-Token im Auth-Profil-Speicher und tauscht es gegen ein Copilot-API-Token aus, wenn OpenClaw ausgeführt wird. Sie müssen das Token nicht manuell verwalten.
Memory-Search-Embeddings
GitHub Copilot kann auch als Embedding-Provider für Memory Search dienen. Wenn Sie ein Copilot-Abonnement haben und angemeldet sind, kann OpenClaw es ohne separaten API-Schlüssel für Embeddings verwenden.
Konfiguration
Setzen Sie memorySearch.provider explizit, um GitHub-Copilot-Embeddings zu verwenden. Wenn ein GitHub-Token verfügbar ist, ermittelt OpenClaw verfügbare Embedding-Modelle aus der Copilot-API und wählt automatisch das beste aus.
{ agents: { defaults: { memorySearch: { provider: "github-copilot", // Optional: override the auto-discovered model model: "text-embedding-3-small", }, }, },}Funktionsweise
- OpenClaw löst Ihr GitHub-Token auf (aus Env-Vars oder Auth-Profil).
- Tauscht es gegen ein kurzlebiges Copilot-API-Token aus.
- Fragt den Copilot-Endpunkt
/modelsab, um verfügbare Embedding-Modelle zu ermitteln. - Wählt das beste Modell aus (bevorzugt
text-embedding-3-small). - Sendet Embedding-Requests an den Copilot-Endpunkt
/embeddings.
Die Modellverfügbarkeit hängt von Ihrem GitHub-Plan ab. Wenn keine Embedding-Modelle verfügbar sind, überspringt OpenClaw Copilot und versucht den nächsten Provider.
