OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

GitHub Copilot

GitHub Copilot, GitHub'ın yapay zekâ destekli kodlama asistanıdır. GitHub hesabınız ve planınız için Copilot modellerine erişim sağlar. OpenClaw, Copilot'ı üç farklı şekilde model sağlayıcısı veya ajan çalışma zamanı olarak kullanabilir.

OpenClaw'da Copilot'ı kullanmanın üç yolu

Yerleşik sağlayıcı (github-copilot)

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.

  • Oturum açma komutunu çalıştırın

    bash
    openclaw models auth login-github-copilot

    Bir URL'yi ziyaret etmeniz ve tek kullanımlık bir kod girmeniz istenir. İşlem tamamlanana kadar terminali açık tutun.

  • Varsayılan bir model ayarlayın

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

    Veya yapılandırmada:

    json5
    {  agents: {    defaults: { model: { primary: "github-copilot/claude-opus-4.7" } },  },}

    • Copilot SDK donanım Plugin'i (copilot)

    Seçili github-copilot/* modellerinde düşük seviyeli ajan döngüsünü GitHub'ın Copilot CLI ve SDK'sının yönetmesini istediğinizde harici @openclaw/copilot Plugin'ini yükleyin.

    bash
    openclaw plugins install @openclaw/copilot

    Ardından bir modeli veya sağlayıcıyı çalışma zamanına dahil edin:

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

    Yerel Copilot CLI oturumları, SDK tarafından yönetilen iş parçacığı durumu ve bu ajan turları için Copilot tarafından yönetilen Compaction istediğinizde bunu seçin. Açık agentRuntime katılımı olmadan github-copilot/* modelleri yerleşik sağlayıcıyı kullanmaya devam eder. Tam çalışma zamanı sözleşmesi için Copilot SDK donanımına bakın.

    Copilot Proxy Plugin'i (copilot-proxy)

    Yerel köprü olarak Copilot Proxy VS Code uzantısını kullanın. OpenClaw, proxy'nin /v1 uç noktasıyla (varsayılan http://localhost:3000/v1) iletişim kurar ve yapılandırdığınız model listesini kullanır.

    copilot-proxy Plugin'i OpenClaw ile birlikte gelir ve varsayılan olarak etkindir. Temel URL'yi ve model kimliklerini şununla yapılandırın:

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

    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.

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

    bash
    openclaw models auth login --provider github-copilot --method device-enterprise

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

    json5
    {  models: {    providers: {      "github-copilot": { params: { githubDomain: "your-org.ghe.com" } },    },  },}

    • Cihaz akışı, belirteç değişimi ve tamamlamalar sırasıyla 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.

    İsteğe bağlı bayraklar

    Komut Bayrak Açıklama
    openclaw models auth login-github-copilot --yes Mevcut kimlik doğrulama profilinin üzerine sormadan yaz
    openclaw models auth login --provider github-copilot --method device --set-default Sağlayıcının önerdiği varsayılan modeli de uygula
    bash
    # Yeniden oturum açma onayını atlaopenclaw models auth login-github-copilot --yes # Tek adımda oturum aç ve varsayılan modeli ayarlaopenclaw models auth login --provider github-copilot --method device --set-default

    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 belirtecini openclaw onboard --non-interactive ile içe aktarın:

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

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

    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

    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

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

    json5
    {  plugins: {    entries: {      "github-copilot": {        config: { discovery: { enabled: false } },      },    },  },}
    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

    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ı

    OpenClaw, Copilot kimlik doğrulamasını ortam değişkenlerinden aşağıdaki öncelik sırasıyla çözümler:

    Öncelik Değişken Notlar
    1 COPILOT_GITHUB_TOKEN En yüksek öncelik, Copilot'a özgü
    2 GH_TOKEN GitHub CLI belirteci (geri dönüş seçeneği)
    3 GITHUB_TOKEN Standart GitHub belirteci (en düşük)

    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

    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çin memory.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.

    json5
    {  memory: {    search: {      provider: "github-copilot",      // İsteğe bağlı: otomatik keşfedilen modeli geçersiz kıl      model: "text-embedding-3-small",    },  },}

    Nasıl çalışır?

    1. OpenClaw, GitHub belirtecinizi (ortam değişkenlerinden veya kimlik doğrulama profilinden) çözümler.
    2. Bunu kısa ömürlü bir Copilot API belirteciyle değiştirir.
    3. Kullanılabilir gömme modellerini keşfetmek için Copilot /models uç noktasını sorgular.
    4. En iyi modeli seçer (tercih sırası: text-embedding-3-small, text-embedding-3-large, text-embedding-ada-002).
    5. Gömme isteklerini Copilot /embeddings uç noktasına gönderir.

    Model kullanılabilirliği GitHub planınıza bağlıdır. Kullanılabilir gömme modeli yoksa OpenClaw, Copilot'ı atlar ve sonraki sağlayıcıyı dener.

    İ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ı.
    Was this useful?
    On this page

    On this page