OpenClaw’da Copilot’ı kullanmanın üç yolu
- Yerleşik sağlayıcı (github-copilot)
- Copilot SDK donanım Plugin'i (copilot)
- Copilot Proxy Plugin'i (copilot-proxy)
Bir GitHub belirteci almak için yerel cihazla oturum açma akışını kullanın,
ardından OpenClaw çalışırken bunu Copilot API belirteçleriyle değiştirin. Bu,
VS Code gerektirmediği için varsayılan ve en basit yoldur.Bir URL’yi ziyaret etmeniz ve tek kullanımlık bir kod girmeniz istenir.
İşlem tamamlanana kadar terminali açık tutun.Veya yapılandırmada:
1
Oturum açma komutunu çalıştırın
2
Varsayılan bir model ayarlayın
GitHub Enterprise (veri yerleşimi)
Kuruluşunuz veri yerleşimli bir GitHub Enterprise kiracısı kullanıyorsa (your-org.ghe.com gibi bir *.ghe.com ana bilgisayarı), Copilot genel
github.com yerine kiracıya yerel uç noktalarda bulunur. OpenClaw bunu
birinci sınıf bir kimlik doğrulama seçeneği olarak sunar; böylece URL’leri elle
düzenlemeniz gerekmez.
1
Enterprise kimlik doğrulama seçeneğini belirleyin
İlk katılımda veya
openclaw models auth içinde
GitHub Copilot (Enterprise / data residency) seçeneğini belirleyin.
Enterprise alan adınız istenir (örneğin your-org.ghe.com), ardından cihazla
oturum açma işlemi bu kiracıya karşı çalışır.Yalnızca kiracı kökünü (your-org.ghe.com) girin. api.your-org.ghe.com veya
copilot-api.your-org.ghe.com gibi türetilmiş hizmet ana bilgisayarları kabul edilmez;
OpenClaw bu uç noktaları kiracı kökünden otomatik olarak türetir.2
Alan adı yapılandırmada kalıcı olarak saklanır
Seçilen ana bilgisayar sağlayıcı parametreleri altında saklanır; böylece
sonraki belirteç yenilemeleri ve tamamlamalar otomatik olarak kiracıyı hedefler:
https://your-org.ghe.com/login/device/code,
https://api.your-org.ghe.com/copilot_internal/v2/token ve
https://copilot-api.your-org.ghe.com olarak çözümlenir. Veri yerleşimi belirteçleri bir
kiracı damgası taşır ve proxy ipucu içermez; bu nedenle tamamlamaların temel
URL’si genel uç nokta yerine kiracının Copilot ana bilgisayarına geri döner.
Alan adları arasında geçiş yapıldığında cihazla oturum açma her zaman yeniden
çalıştırılır. Zaten saklanmış bir Copilot belirteciniz varsa ve farklı bir alan
adı seçerseniz (genel
github.com ↔ bir *.ghe.com kiracısı veya
bir kiracıdan diğerine), OpenClaw mevcut belirteci yeniden kullanmaz; belirtecin
yapılandırmaya yazılan alan adıyla sınırlandırılması için yeni bir oturum açmayı
zorunlu kılar. Aynı alan adı için oturum açmayı yeniden çalıştırmak, mevcut
belirteci yeniden kullanma seçeneğini sunmaya devam eder. Genel
github.com alanına geri dönüldüğünde kalıcı githubDomain
temizlenir ve yapılandırma varsayılana döner.COPILOT_GITHUB_DOMAIN ortam değişkeni, alan adını çözümleyen tüm Copilot yollarında
çözümlenen alan adını geçersiz kılar: Enterprise cihazla oturum açma
(--method device-enterprise), bağımsız openclaw models auth login-github-copilot kısayolu, belirteç yenileme,
gömmeler ve tamamlamalar. Tamamen başsız veya CI kurulumları için bunu
*.ghe.com ana bilgisayarınıza ayarlayın. Genel github.com
kullanmak için ayarlamayın (ve yapılandırma parametresini eklemeyin). Oturum
açma işlemleri, belirteci oluşturdukları alan adını kalıcı olarak saklar (ve
genel github.com üzerinde oturum açarken temizler); böylece ortam
değişkeni kaldırıldıktan sonra bile yönlendirme doğru kalır.İsteğe bağlı bayraklar
Etkileşimsiz ilk katılım
Cihazla oturum açma akışı etkileşimli bir TTY gerektirir. Başsız kurulum için mevcut bir GitHub OAuth erişim belirteciniopenclaw onboard --non-interactive ile içe aktarın:
--auth-choice seçeneğini de atlayabilirsiniz; --github-copilot-token iletilmesi
GitHub Copilot sağlayıcısı kimlik doğrulama seçeneğini çıkarır. Bayrak atlanırsa
ilk katılım sırasıyla COPILOT_GITHUB_TOKEN, GH_TOKEN ve ardından
GITHUB_TOKEN seçeneklerine geri döner. auth-profiles.json içinde düz metin
yerine ortam değişkenine dayalı bir tokenRef saklamak için
COPILOT_GITHUB_TOKEN ayarlıyken --secret-input-mode ref kullanın.
Etkileşimli TTY gereklidir
Etkileşimli TTY gereklidir
Cihazla oturum açma akışı etkileşimli bir TTY gerektirir. Etkileşimsiz bir
betik veya CI işlem hattı içinde değil, doğrudan terminalde çalıştırın.
Model kullanılabilirliği planınıza bağlıdır
Model kullanılabilirliği planınıza bağlıdır
Copilot model kullanılabilirliği GitHub planınıza bağlıdır. Bir model
reddedilirse başka bir kimlik deneyin (örneğin
github-copilot/gpt-5.5). Güncel
model listesi için GitHub’ın Copilot planına göre desteklenen modellerine
bakın.Copilot API'den canlı katalog yenileme
Copilot API'den canlı katalog yenileme
Cihazla oturum açma (veya ortam değişkeni) kimlik doğrulama yolu bir GitHub
belirtecini çözümledikten sonra OpenClaw, çalışma zamanının hesap başına
yetkilendirmeyi ve doğru bağlam pencerelerini manifest değişikliği olmadan
izlemesi için model kataloğunu isteğe bağlı olarak
${baseUrl}/models
üzerinden (VS Code Copilot’ın kullandığı uç noktanın aynısı) yeniler.
Yeni yayımlanan Copilot modelleri OpenClaw yükseltmesi olmadan görünür olur
ve bağlam pencereleri model başına gerçek sınırları yansıtır (örneğin gpt-5.x
serisi için 400k, dahili claude-opus-*-1m varyantları için 1M).Paketlenmiş statik katalog; keşif devre dışı bırakıldığında, kullanıcının
GitHub kimlik doğrulama profili olmadığında, belirteç değişimi başarısız
olduğunda veya /models HTTPS çağrısı hata verdiğinde görünür geri
dönüş seçeneği olarak kalır. Devre dışı bırakıp tamamen statik manifest
kataloğuna dayanmak için (çevrimdışı / izole ağ senaryoları):Aktarım seçimi
Aktarım seçimi
Claude model kimlikleri Anthropic Messages aktarımını otomatik olarak
kullanır. Gemini modelleri OpenAI Chat Completions aktarımını kullanır;
GPT ve o-serisi modeller OpenAI Responses aktarımını kullanmaya devam eder.
OpenClaw, model referansına göre doğru aktarımı seçer.
İstek uyumluluğu
İstek uyumluluğu
OpenClaw, Copilot aktarımlarında Copilot IDE tarzı istek üst bilgileri
(VS Code düzenleyici/Plugin sürümleri ve
vscode-chat entegrasyon
kimliği) gönderir, araç sonucu takip turlarını ajan tarafından başlatılmış
olarak işaretler ve bir tur görüntü girdisi taşıdığında Copilot görüntü
üst bilgisini ayarlar.Ortam değişkeni çözümleme sırası
Ortam değişkeni çözümleme sırası
OpenClaw, Copilot kimlik doğrulamasını ortam değişkenlerinden aşağıdaki
öncelik sırasıyla çözümler:
Birden fazla değişken ayarlandığında OpenClaw en yüksek öncelikli olanı
kullanır. Cihazla oturum açma akışı (
openclaw models auth login-github-copilot) belirtecini kimlik
doğrulama profili deposunda saklar ve tüm ortam değişkenlerine göre önceliklidir.Belirteç depolama
Belirteç depolama
Oturum açma işlemi, GitHub belirtecini kimlik doğrulama profili deposunda
(profil kimliği
github-copilot:github) saklar ve OpenClaw çalışırken bunu kısa
ömürlü bir Copilot API belirteciyle değiştirir. Belirteci elle yönetmeniz gerekmez.Bellek arama gömmeleri
GitHub Copilot, bellek araması için bir gömme sağlayıcısı olarak da hizmet verebilir. Copilot aboneliğiniz varsa ve oturum açtıysanız OpenClaw, ayrı bir API anahtarı olmadan gömmeler için onu kullanabilir.Yapılandırma
GitHub Copilot gömmelerini kullanmak içinmemory.search.provider değerini açıkça
ayarlayın. Bir GitHub belirteci mevcutsa OpenClaw, Copilot API’den kullanılabilir
gömme modellerini keşfeder ve en iyisini otomatik olarak seçer.
Nasıl çalışır?
- OpenClaw, GitHub belirtecinizi (ortam değişkenlerinden veya kimlik doğrulama profilinden) çözümler.
- Bunu kısa ömürlü bir Copilot API belirteciyle değiştirir.
- Kullanılabilir gömme modellerini keşfetmek için Copilot
/modelsuç noktasını sorgular. - En iyi modeli seçer (tercih sırası:
text-embedding-3-small,text-embedding-3-large,text-embedding-ada-002). - Gömme isteklerini Copilot
/embeddingsuç noktasına gönderir.
İlgili
Model seçimi
Sağlayıcıları, model referanslarını ve yük devretme davranışını seçme.
OAuth ve kimlik doğrulama
Kimlik doğrulama ayrıntıları ve kimlik bilgilerini yeniden kullanma kuralları.