Drei Möglichkeiten, Copilot in OpenClaw zu verwenden
- Integrierter Provider (github-copilot)
- Copilot-SDK-Harness-Plugin (copilot)
- Copilot-Proxy-Plugin (copilot-proxy)
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.
Optionale Flags
| Flag | Beschreibung |
|---|---|
--yes | Bestätigungsabfrage überspringen |
--set-default | Auch das vom Provider empfohlene Standardmodell anwenden |
Nicht interaktives Onboarding
Wenn Sie bereits ein GitHub-OAuth-Zugriffstoken für Copilot haben, importieren Sie es während der Headless-Einrichtung mitopenclaw onboard --non-interactive:
--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
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
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
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):Transportauswahl
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
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
Auflösungsreihenfolge für Umgebungsvariablen
OpenClaw löst Copilot-Authentifizierung aus Umgebungsvariablen in der folgenden Prioritätsreihenfolge auf:
Wenn mehrere Variablen gesetzt sind, verwendet OpenClaw diejenige mit der höchsten Priorität. Der Device-Login-Ablauf (
| 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) |
openclaw models auth login-github-copilot) speichert sein Token im Auth-Profil-Speicher und hat Vorrang vor allen Umgebungsvariablen.Token-Speicherung
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 SiememorySearch.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.
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.
Verwandte Themen
Modellauswahl
Provider, Modellreferenzen und Failover-Verhalten auswählen.
OAuth und Authentifizierung
Authentifizierungsdetails und Regeln zur Wiederverwendung von Anmeldedaten.