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 untergeordnete Agent-Schleife für ausgewählte github-copilot/*-Modelle übernehmen 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 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:

    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), 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.

    bash
    openclaw models auth login --provider github-copilot --method device-enterprise
  • 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:

    json5
    {  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
    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 monitorlose Einrichtung mit openclaw onboard --non-interactive ein vorhandenes GitHub-OAuth-Zugriffstoken:

    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 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):

    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 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.

    json5
    {  agents: {    defaults: {      memorySearch: {        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 tauscht dieses gegen ein kurzlebiges Copilot-API-Token aus.
    3. Es fragt den Copilot-Endpunkt /models ab, um verfügbare Embedding-Modelle zu erkennen.
    4. Es wählt das beste Modell aus (Präferenzreihenfolge: text-embedding-3-small, text-embedding-3-large, text-embedding-ada-002).
    5. 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.

    Verwandte Themen

    Was this useful?
    On this page

    On this page