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

    bash
    openclaw models auth login-github-copilot

    Sie werden aufgefordert, eine URL aufzurufen und einen Einmalcode einzugeben. Lassen Sie das Terminal geöffnet, bis der Vorgang abgeschlossen ist.

  • Standardmodell festlegen

    bash
    openclaw models set github-copilot/claude-opus-4.7

    Oder in der Konfiguration:

    json5
    {  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 Agent-Schleife auf niedriger Ebene für ausgewählte github-copilot/*-Modelle steuern sollen.

    bash
    openclaw plugins install @openclaw/copilot

    Aktivieren Sie anschließend die Runtime für ein Modell oder einen Provider:

    json5
    {  agents: {    defaults: {      model: "github-copilot/gpt-5.5",      models: {        "github-copilot/gpt-5.5": {          agentRuntime: { id: "copilot" },        },      },    },  },}

    Wählen Sie dies, wenn Sie für diese Agent-Schritte native Copilot-CLI-Sitzungen, eine vom SDK verwaltete Thread-Zustandsverwaltung und eine Copilot-eigene Compaction verwenden möchten. 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 (Standard: 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:

    bash
    openclaw models auth login --provider copilot-proxy --set-default

    GitHub Enterprise (Datenresidenz)

    Wenn Ihre Organisation einen GitHub-Enterprise-Mandanten mit Datenresidenz verwendet (einen *.ghe.com-Host wie your-org.ghe.com), ist Copilot über mandantenlokale Endpunkte statt über das öffentliche github.com verfügbar. 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 nach Ihrer Enterprise-Domain gefragt (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 von der Stammadresse des Mandanten ab.

    bash
    openclaw models auth login --provider github-copilot --method device-enterprise
  • Domain wird in der Konfiguration gespeichert

    Der ausgewählte Host wird in den Provider-Parametern gespeichert, sodass spätere Token-Aktualisierungen und Vervollständigungen automatisch an den Mandanten gesendet werden:

    json5
    {  models: {    providers: {      "github-copilot": { params: { githubDomain: "your-org.ghe.com" } },    },  },}
  • Geräteablauf, Token-Austausch und 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. Daher greift die Basis-URL für Vervollständigungen auf den Copilot-Host des Mandanten statt auf den öffentlichen Endpunkt zurück.

    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
    bash
    # 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-default

    Nicht interaktives Onboarding

    Der Geräteanmeldeablauf erfordert ein interaktives TTY. Importieren Sie für eine Headless-Konfiguration ein vorhandenes GitHub-OAuth-Zugriffstoken mit openclaw onboard --non-interactive:

    bash
    openclaw onboard --non-interactive --accept-risk \  --auth-choice github-copilot \  --github-copilot-token "$COPILOT_GITHUB_TOKEN" \  --skip-channels --skip-health

    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 GITHUB_TOKEN zurück. Verwenden Sie --secret-input-mode ref bei gesetztem COPILOT_GITHUB_TOKEN, um statt Klartext in auth-profiles.json ein umgebungsvariablenbasiertes 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 Authentifizierungspfad der Geräteanmeldung oder Umgebungsvariable ein GitHub-Token aufgelöst wurde, aktualisiert OpenClaw den Modellkatalog bei Bedarf über ${baseUrl}/models (denselben Endpunkt, den VS Code Copilot verwendet). Dadurch berücksichtigt die Runtime die Berechtigungen des jeweiligen Kontos und die genauen Kontextfenster, ohne dass das Manifest ständig geändert werden muss. Neu veröffentlichte Copilot-Modelle werden ohne OpenClaw-Upgrade sichtbar, und die Kontextfenster entsprechen den tatsächlichen modellspezifischen Grenzen (z. B. 400k für die gpt-5.x-Reihe und 1M für die internen claude-opus-*-1m-Varianten).

    Der mitgelieferte statische Katalog bleibt als sichtbare Ausweichlösung erhalten, wenn die Erkennung deaktiviert ist, der Benutzer kein GitHub-Authentifizierungsprofil besitzt, der Token-Austausch fehlschlägt oder beim HTTPS-Aufruf von /models ein Fehler auftritt. So deaktivieren Sie die Erkennung und verwenden ausschließlich den statischen Manifestkatalog (Offline- oder Air-Gap-Szenarien):

    json5
    {  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 Modelle der o-Reihe verwenden weiterhin den OpenAI-Responses-Transport. OpenClaw wählt anhand der Modellreferenz den korrekten Transport aus.

    Anfragekompatibilität

    OpenClaw sendet bei Copilot-Transporten Anfrage-Header im Stil der Copilot-IDE (Versionen des VS-Code-Editors und -Plugins sowie die Integrations-ID vscode-chat), kennzeichnet auf Werkzeugergebnisse folgende Schritte als vom Agent initiiert und setzt den Copilot-Vision-Header, wenn ein Schritt 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 (Ausweichlösung)
    3 GITHUB_TOKEN Standardmäßiges 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 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 memory.search.provider ausdrücklich, um GitHub-Copilot-Embeddings zu verwenden. Wenn ein GitHub-Token verfügbar ist, erkennt OpenClaw die verfügbaren Embedding-Modelle über die Copilot-API und wählt automatisch das beste aus.

    json5
    {  memory: {    search: {      provider: "github-copilot",      // Optional: automatisch erkanntes Modell überschreiben      model: "text-embedding-3-small",    },  },}

    Funktionsweise

    1. OpenClaw löst Ihr GitHub-Token auf (aus Umgebungsvariablen oder dem Authentifizierungsprofil).
    2. Es wird gegen ein kurzlebiges Copilot-API-Token ausgetauscht.
    3. Der Copilot-Endpunkt /models wird abgefragt, um verfügbare Embedding-Modelle zu ermitteln.
    4. Das beste Modell wird ausgewählt (Präferenzreihenfolge: text-embedding-3-small, text-embedding-3-large, text-embedding-ada-002).
    5. Embedding-Anfragen werden an den Copilot-Endpunkt /embeddings gesendet.

    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.

    Verwandte Themen

    Was this useful?
    On this page

    On this page