Trzy sposoby używania Copilot w OpenClaw
- Wbudowany dostawca (github-copilot)
- Plugin środowiska Copilot SDK (copilot)
- Plugin Copilot Proxy (copilot-proxy)
Użyj natywnego procesu logowania na urządzeniu, aby uzyskać token GitHub, a następnie wymieniaj go na
tokeny API Copilot podczas działania OpenClaw. Jest to domyślna i najprostsza ścieżka,
ponieważ nie wymaga VS Code.Pojawi się prośba o odwiedzenie adresu URL i wprowadzenie jednorazowego kodu. Nie zamykaj
terminala do czasu zakończenia procesu.Lub w konfiguracji:
1
Uruchom polecenie logowania
2
Ustaw model domyślny
GitHub Enterprise (rezydencja danych)
Jeśli Twoja organizacja używa dzierżawy GitHub Enterprise z rezydencją danych (hosta*.ghe.com, takiego jak your-org.ghe.com), Copilot działa w lokalnych punktach końcowych
dzierżawy, a nie w publicznym github.com. OpenClaw udostępnia to jako
pełnoprawną opcję uwierzytelniania, dzięki czemu nie trzeba ręcznie edytować adresów URL.
1
Wybierz opcję uwierzytelniania Enterprise
Podczas wdrażania lub w
openclaw models auth wybierz
GitHub Copilot (Enterprise / data residency). Pojawi się prośba o podanie
domeny Enterprise (na przykład your-org.ghe.com), a następnie zostanie uruchomione
logowanie na urządzeniu w tej dzierżawie.Wprowadź wyłącznie domenę główną dzierżawy (your-org.ghe.com). Pochodne hosty usług, takie
jak api.your-org.ghe.com lub copilot-api.your-org.ghe.com, nie są akceptowane;
OpenClaw automatycznie wyprowadza te punkty końcowe z domeny głównej dzierżawy.2
Domena jest zapisywana w konfiguracji
Wybrany host jest przechowywany w parametrach dostawcy, dzięki czemu późniejsze odświeżanie tokenów
i generowanie odpowiedzi są automatycznie kierowane do dzierżawy:
https://your-org.ghe.com/login/device/code,
https://api.your-org.ghe.com/copilot_internal/v2/token oraz
https://copilot-api.your-org.ghe.com. Tokeny rezydencji danych zawierają
oznaczenie dzierżawy i nie zawierają wskazania serwera proxy, dlatego bazowy adres URL generowania odpowiedzi
wskazuje host Copilot dzierżawy zamiast publicznego punktu końcowego.
Zmiana domeny zawsze powoduje ponowne uruchomienie logowania na urządzeniu. Jeśli masz już zapisany
token Copilot i wybierzesz inną domenę (publiczne
github.com ↔ dzierżawa
*.ghe.com albo przejście z jednej dzierżawy do innej), OpenClaw nie użyje ponownie istniejącego tokenu —
wymusi nowe logowanie, aby zakres tokenu odpowiadał domenie zapisywanej w
konfiguracji. Ponowne uruchomienie logowania dla tej samej domeny nadal umożliwia ponowne użycie bieżącego
tokenu. Powrót do publicznego github.com usuwa zapisaną wartość
githubDomain, przywracając konfigurację domyślną.Zmienna środowiskowa
COPILOT_GITHUB_DOMAIN zastępuje ustaloną domenę
we wszystkich ścieżkach Copilot, które ją ustalają — w logowaniu urządzenia Enterprise
(--method device-enterprise), samodzielnym skrócie
openclaw models auth login-github-copilot, odświeżaniu tokenów, osadzeniach
i generowaniu odpowiedzi. Ustaw ją na host *.ghe.com w konfiguracjach całkowicie bezobsługowych lub CI.
Pozostaw ją nieustawioną (i nie dodawaj parametru konfiguracji), aby używać publicznego github.com.
Proces logowania zapisuje domenę, dla której utworzono token (i usuwa ją podczas logowania
do publicznego github.com), dzięki czemu kierowanie ruchu pozostaje poprawne nawet po
usunięciu zmiennej środowiskowej.Opcjonalne flagi
Wdrażanie nieinteraktywne
Proces logowania na urządzeniu wymaga interaktywnego TTY. W środowisku bez interfejsu zaimportuj istniejący token dostępu OAuth GitHub za pomocąopenclaw onboard --non-interactive:
--auth-choice; podanie --github-copilot-token powoduje wybranie
opcji uwierzytelniania dostawcy GitHub Copilot. Jeśli flaga zostanie pominięta, proces wdrażania
sprawdza kolejno COPILOT_GITHUB_TOKEN, GH_TOKEN, a następnie GITHUB_TOKEN. Użyj
--secret-input-mode ref przy ustawionej zmiennej COPILOT_GITHUB_TOKEN, aby zapisać
tokenRef oparty na zmiennej środowiskowej zamiast zwykłego tekstu w auth-profiles.json.
Wymagany interaktywny TTY
Wymagany interaktywny TTY
Proces logowania na urządzeniu wymaga interaktywnego TTY. Uruchom go bezpośrednio w
terminalu, a nie w nieinteraktywnym skrypcie lub potoku CI.
Dostępność modeli zależy od Twojego planu
Dostępność modeli zależy od Twojego planu
Dostępność modeli Copilot zależy od Twojego planu GitHub. Jeśli model zostanie
odrzucony, wypróbuj inny identyfikator (na przykład
github-copilot/gpt-5.5). Aktualną listę modeli
znajdziesz w dokumentacji GitHub dotyczącej modeli obsługiwanych w poszczególnych planach Copilot.Odświeżanie katalogu na żywo z API Copilot
Odświeżanie katalogu na żywo z API Copilot
Gdy ścieżka uwierzytelniania przez logowanie na urządzeniu (lub zmienną środowiskową) ustali token GitHub,
OpenClaw odświeża katalog modeli na żądanie z
${baseUrl}/models
(tego samego punktu końcowego, którego używa Copilot w VS Code), dzięki czemu środowisko uruchomieniowe uwzględnia
uprawnienia poszczególnych kont oraz dokładne okna kontekstu bez konieczności
aktualizowania manifestu. Nowo opublikowane modele Copilot stają się widoczne bez
aktualizacji OpenClaw, a okna kontekstu odzwierciedlają rzeczywiste limity poszczególnych modeli
(np. 400 tys. dla serii gpt-5.x i 1 mln dla wewnętrznych
wariantów claude-opus-*-1m).Dołączony katalog statyczny pozostaje widocznym rozwiązaniem rezerwowym, gdy wykrywanie
jest wyłączone, użytkownik nie ma profilu uwierzytelniania GitHub, wymiana tokenu
nie powiedzie się lub wywołanie HTTPS /models zakończy się błędem. Aby zrezygnować z tej funkcji i polegać wyłącznie
na statycznym katalogu manifestu (w scenariuszach offline lub z izolacją sieciową):Wybór transportu
Wybór transportu
Identyfikatory modeli Claude automatycznie używają transportu Anthropic Messages.
Modele Gemini używają transportu OpenAI Chat Completions, a modele GPT i serii o
nadal korzystają z transportu OpenAI Responses. OpenClaw wybiera właściwy
transport na podstawie odwołania do modelu.
Zgodność żądań
Zgodność żądań
OpenClaw wysyła nagłówki żądań w stylu środowiska IDE Copilot przez transporty Copilot
(wersje edytora/pluginu VS Code oraz identyfikator integracji
vscode-chat),
oznacza kolejne tury z wynikami narzędzi jako inicjowane przez agenta i ustawia nagłówek
obsługi obrazu Copilot, gdy tura zawiera dane wejściowe w postaci obrazu.Kolejność rozpoznawania zmiennych środowiskowych
Kolejność rozpoznawania zmiennych środowiskowych
OpenClaw ustala dane uwierzytelniające Copilot ze zmiennych środowiskowych w następującej
kolejności priorytetów:
Gdy ustawiono wiele zmiennych, OpenClaw używa tej o najwyższym priorytecie.
Proces logowania na urządzeniu (
openclaw models auth login-github-copilot) zapisuje
swój token w magazynie profili uwierzytelniania i ma pierwszeństwo przed wszystkimi zmiennymi
środowiskowymi.Przechowywanie tokenu
Przechowywanie tokenu
Proces logowania zapisuje token GitHub w magazynie profili uwierzytelniania (identyfikator profilu
github-copilot:github) i wymienia go na krótkotrwały token API Copilot
podczas działania OpenClaw. Nie musisz ręcznie zarządzać tokenem.Osadzenia do przeszukiwania pamięci
GitHub Copilot może również służyć jako dostawca osadzeń dla przeszukiwania pamięci. Jeśli masz subskrypcję Copilot i masz aktywną sesję, OpenClaw może używać go do osadzeń bez oddzielnego klucza API.Konfiguracja
Ustaw jawniememorySearch.provider, aby używać osadzeń GitHub Copilot. Jeśli
token GitHub jest dostępny, OpenClaw wykrywa dostępne modele osadzeń za pomocą
API Copilot i automatycznie wybiera najlepszy.
Jak to działa
- OpenClaw ustala Twój token GitHub (ze zmiennych środowiskowych lub profilu uwierzytelniania).
- Wymienia go na krótkotrwały token API Copilot.
- Wysyła zapytanie do punktu końcowego
/modelsCopilot, aby wykryć dostępne modele osadzeń. - Wybiera najlepszy model (kolejność preferencji:
text-embedding-3-small,text-embedding-3-large,text-embedding-ada-002). - Wysyła żądania osadzeń do punktu końcowego
/embeddingsCopilot.
Powiązane
Wybór modelu
Wybieranie dostawców, odwołań do modeli i sposobu działania mechanizmu przełączania awaryjnego.
OAuth i uwierzytelnianie
Szczegóły uwierzytelniania i zasady ponownego używania poświadczeń.