GitHub Copilot

GitHub Copilot adalah asisten pengodean AI milik GitHub. Layanan ini menyediakan akses ke model Copilot untuk akun dan paket GitHub Anda. OpenClaw dapat menggunakan Copilot sebagai penyedia model atau runtime agen melalui tiga cara berbeda.

Tiga cara menggunakan Copilot di OpenClaw

Penyedia bawaan (github-copilot)
Plugin harness SDK Copilot (copilot)
Plugin Proxy Copilot (copilot-proxy)

Gunakan alur masuk perangkat native untuk memperoleh token GitHub, lalu tukarkan token tersebut dengan token API Copilot saat OpenClaw berjalan. Ini adalah jalur default dan paling sederhana karena tidak memerlukan VS Code.

Jalankan perintah masuk

openclaw models auth login-github-copilot

Anda akan diminta mengunjungi URL dan memasukkan kode sekali pakai. Biarkan terminal tetap terbuka hingga proses selesai.

Tetapkan model default

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

Atau dalam konfigurasi:

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

Instal plugin eksternal @openclaw/copilot jika Anda ingin CLI dan SDK Copilot milik GitHub menangani loop agen tingkat rendah untuk model github-copilot/* yang dipilih.

openclaw plugins install @openclaw/copilot

Kemudian aktifkan runtime untuk model atau penyedia:

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

Pilih opsi ini jika Anda menginginkan sesi CLI Copilot native, status utas yang dikelola SDK, dan compaction yang dikelola Copilot untuk giliran agen tersebut. Tanpa pengaktifan agentRuntime secara eksplisit, model github-copilot/* tetap menggunakan penyedia bawaan. Lihat harness SDK Copilot untuk kontrak runtime lengkap.

Gunakan ekstensi VS Code Copilot Proxy sebagai jembatan lokal. OpenClaw berkomunikasi dengan endpoint /v1 proxy (default http://localhost:3000/v1) dan menggunakan daftar model yang Anda konfigurasikan.Plugin copilot-proxy disertakan bersama OpenClaw dan diaktifkan secara default. Konfigurasikan URL dasar dan ID model dengan:

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

Pilih opsi ini jika Anda sudah menjalankan Copilot Proxy di VS Code atau perlu merutekan melalui layanan tersebut. Ekstensi VS Code harus tetap berjalan.

GitHub Enterprise (residensi data)

Jika organisasi Anda menggunakan tenant GitHub Enterprise dengan residensi data (host *.ghe.com seperti your-org.ghe.com), Copilot berada pada endpoint lokal tenant, bukan github.com publik. OpenClaw menyediakan ini sebagai pilihan autentikasi kelas utama sehingga Anda tidak perlu mengedit URL secara manual.

Pilih opsi autentikasi Enterprise

Dalam proses orientasi atau openclaw models auth, pilih GitHub Copilot (Enterprise / data residency). Anda akan diminta memasukkan domain Enterprise Anda (misalnya your-org.ghe.com), lalu proses masuk perangkat dijalankan pada tenant tersebut.Masukkan hanya akar tenant (your-org.ghe.com). Host layanan turunan seperti api.your-org.ghe.com atau copilot-api.your-org.ghe.com tidak diterima; OpenClaw memperoleh endpoint tersebut secara otomatis dari akar tenant.

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

Domain dipertahankan dalam konfigurasi

Host yang dipilih disimpan di bawah parameter penyedia sehingga penyegaran token dan penyelesaian berikutnya secara otomatis menargetkan tenant:

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

Alur perangkat, pertukaran token, dan penyelesaian masing-masing menggunakan https://your-org.ghe.com/login/device/code, https://api.your-org.ghe.com/copilot_internal/v2/token, dan https://copilot-api.your-org.ghe.com. Token residensi data membawa penanda tenant dan tidak memiliki petunjuk proxy, sehingga URL dasar penyelesaian beralih ke host Copilot tenant, bukan endpoint publik.

Mengganti domain selalu menjalankan ulang proses masuk perangkat. Jika Anda sudah memiliki token Copilot tersimpan dan memilih domain berbeda (github.com publik ↔ tenant *.ghe.com, atau dari satu tenant ke tenant lain), OpenClaw tidak akan menggunakan kembali token yang ada — OpenClaw memaksa proses masuk baru agar cakupan token sesuai dengan domain yang ditulis ke konfigurasi. Menjalankan ulang proses masuk untuk domain yang sama tetap menawarkan penggunaan kembali token saat ini. Beralih kembali ke github.com publik akan menghapus githubDomain yang dipertahankan sehingga konfigurasi kembali ke default.

Variabel lingkungan COPILOT_GITHUB_DOMAIN menimpa domain yang ditentukan untuk setiap jalur Copilot yang menggunakannya — proses masuk perangkat Enterprise (--method device-enterprise), pintasan mandiri openclaw models auth login-github-copilot, penyegaran token, penyematan, dan penyelesaian. Tetapkan ke host *.ghe.com Anda untuk penyiapan yang sepenuhnya tanpa antarmuka atau untuk CI. Biarkan tidak ditetapkan (dan parameter konfigurasi tidak ada) untuk menggunakan github.com publik. Proses masuk mempertahankan domain tempat token diterbitkan (dan menghapusnya saat masuk melalui github.com publik), sehingga perutean tetap benar bahkan setelah variabel lingkungan tidak lagi ditetapkan.

Flag opsional

Perintah	Flag	Deskripsi
`openclaw models auth login-github-copilot`	`--yes`	Timpa profil autentikasi yang ada tanpa meminta konfirmasi
`openclaw models auth login --provider github-copilot --method device`	`--set-default`	Terapkan juga model default yang direkomendasikan penyedia

# Lewati konfirmasi masuk ulang
openclaw models auth login-github-copilot --yes

# Masuk dan tetapkan model default dalam satu langkah
openclaw models auth login --provider github-copilot --method device --set-default

Orientasi noninteraktif

Alur masuk perangkat memerlukan TTY interaktif. Untuk penyiapan tanpa antarmuka, impor token akses OAuth GitHub yang ada dengan openclaw onboard --non-interactive:

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

Anda juga dapat menghilangkan --auth-choice; meneruskan --github-copilot-token akan menyimpulkan pilihan autentikasi penyedia GitHub Copilot. Jika flag dihilangkan, proses orientasi akan beralih ke COPILOT_GITHUB_TOKEN, GH_TOKEN, lalu GITHUB_TOKEN. Gunakan --secret-input-mode ref dengan COPILOT_GITHUB_TOKEN yang telah ditetapkan untuk menyimpan tokenRef berbasis lingkungan, bukan teks biasa di auth-profiles.json.

TTY interaktif diperlukan

Alur masuk perangkat memerlukan TTY interaktif. Jalankan langsung di terminal, bukan dalam skrip noninteraktif atau pipeline CI.

Ketersediaan model bergantung pada paket Anda

Ketersediaan model Copilot bergantung pada paket GitHub Anda. Jika sebuah model ditolak, coba ID lain (misalnya github-copilot/gpt-5.5). Lihat model yang didukung untuk setiap paket Copilot dari GitHub untuk daftar model saat ini.

Penyegaran katalog langsung dari API Copilot

Setelah jalur autentikasi masuk perangkat (atau variabel lingkungan) menentukan token GitHub, OpenClaw menyegarkan katalog model sesuai permintaan dari ${baseUrl}/models (endpoint yang sama dengan yang digunakan Copilot di VS Code) agar runtime mengikuti hak akses per akun dan jendela konteks yang akurat tanpa perubahan manifes. Model Copilot yang baru diterbitkan akan terlihat tanpa peningkatan versi OpenClaw, dan jendela konteks mencerminkan batas sebenarnya per model (misalnya 400 ribu untuk seri gpt-5.x, 1 juta untuk varian internal claude-opus-*-1m).Katalog statis yang disertakan tetap menjadi cadangan yang terlihat ketika penemuan dinonaktifkan, pengguna tidak memiliki profil autentikasi GitHub, pertukaran token gagal, atau panggilan HTTPS /models mengalami galat. Untuk menonaktifkannya dan sepenuhnya mengandalkan katalog manifes statis (skenario luring/terisolasi dari jaringan):

{
  plugins: {
    entries: {
      "github-copilot": {
        config: { discovery: { enabled: false } },
      },
    },
  },
}

Pemilihan transportasi

ID model Claude menggunakan transportasi Anthropic Messages secara otomatis. Model Gemini menggunakan transportasi OpenAI Chat Completions; model GPT dan seri o tetap menggunakan transportasi OpenAI Responses. OpenClaw memilih transportasi yang tepat berdasarkan referensi model.

Kompatibilitas permintaan

OpenClaw mengirim header permintaan bergaya IDE Copilot pada transportasi Copilot (versi editor/plugin VS Code dan ID integrasi vscode-chat), menandai giliran tindak lanjut hasil alat sebagai dimulai oleh agen, dan menetapkan header visi Copilot saat suatu giliran membawa masukan gambar.

Urutan resolusi variabel lingkungan

OpenClaw menentukan autentikasi Copilot dari variabel lingkungan berdasarkan urutan prioritas berikut:

Prioritas	Variabel	Catatan
1	`COPILOT_GITHUB_TOKEN`	Prioritas tertinggi, khusus Copilot
2	`GH_TOKEN`	Token CLI GitHub (cadangan)
3	`GITHUB_TOKEN`	Token GitHub standar (prioritas terendah)

Ketika beberapa variabel ditetapkan, OpenClaw menggunakan variabel dengan prioritas tertinggi. Alur masuk perangkat (openclaw models auth login-github-copilot) menyimpan tokennya di penyimpanan profil autentikasi dan memiliki prioritas di atas semua variabel lingkungan.

Penyimpanan token

Proses masuk menyimpan token GitHub di penyimpanan profil autentikasi (ID profil github-copilot:github) dan menukarkannya dengan token API Copilot berumur pendek saat OpenClaw berjalan. Anda tidak perlu mengelola token secara manual.

Penyematan pencarian memori

GitHub Copilot juga dapat berfungsi sebagai penyedia penyematan untuk pencarian memori. Jika Anda memiliki langganan Copilot dan telah masuk, OpenClaw dapat menggunakannya untuk penyematan tanpa kunci API terpisah.

Konfigurasi

Tetapkan memorySearch.provider secara eksplisit untuk menggunakan penyematan GitHub Copilot. Jika token GitHub tersedia, OpenClaw menemukan model penyematan yang tersedia dari API Copilot dan secara otomatis memilih yang terbaik.

{
  agents: {
    defaults: {
      memorySearch: {
        provider: "github-copilot",
        // Opsional: timpa model yang ditemukan secara otomatis
        model: "text-embedding-3-small",
      },
    },
  },
}

Cara kerjanya

OpenClaw menentukan token GitHub Anda (dari variabel lingkungan atau profil autentikasi).
Menukarkannya dengan token API Copilot berumur pendek.
Mengueri endpoint /models Copilot untuk menemukan model penyematan yang tersedia.
Memilih model terbaik (urutan preferensi: text-embedding-3-small, text-embedding-3-large, text-embedding-ada-002).
Mengirim permintaan penyematan ke endpoint /embeddings Copilot.

Ketersediaan model bergantung pada paket GitHub Anda. Jika tidak ada model penyematan yang tersedia, OpenClaw melewati Copilot dan mencoba penyedia berikutnya.

Overview

Concepts and configuration

Providers

Tiga cara menggunakan Copilot di OpenClaw

GitHub Enterprise (residensi data)

Flag opsional

Orientasi noninteraktif

Penyematan pencarian memori

Konfigurasi

Cara kerjanya

Terkait

Pemilihan model

OAuth dan autentikasi

​Tiga cara menggunakan Copilot di OpenClaw

​GitHub Enterprise (residensi data)

​Flag opsional

​Orientasi noninteraktif

​Penyematan pencarian memori

​Konfigurasi

​Cara kerjanya

​Terkait

Pemilihan model

OAuth dan autentikasi

Tiga cara menggunakan Copilot di OpenClaw

GitHub Enterprise (residensi data)

Flag opsional

Orientasi noninteraktif

Penyematan pencarian memori

Konfigurasi

Cara kerjanya

Terkait