Providers
GitHub Copilot
GitHub Copilot adalah asisten pengodean AI dari GitHub. Ini menyediakan akses ke model Copilot untuk akun dan paket GitHub Anda. OpenClaw dapat menggunakan Copilot sebagai penyedia model atau runtime agen dengan tiga cara berbeda.
Tiga cara menggunakan Copilot di OpenClaw
Penyedia bawaan (github-copilot)
Gunakan alur login perangkat native untuk memperoleh token GitHub, lalu menukarnya dengan token API Copilot saat OpenClaw berjalan. Ini adalah jalur default dan paling sederhana karena tidak memerlukan VS Code.
Jalankan perintah login
openclaw models auth login-github-copilotAnda akan diminta mengunjungi URL dan memasukkan kode sekali pakai. Biarkan terminal tetap terbuka sampai selesai.
Tetapkan model default
openclaw models set github-copilot/claude-opus-4.7Atau dalam konfigurasi:
{ agents: { defaults: { model: { primary: "github-copilot/claude-opus-4.7" } }, },}Plugin harness Copilot SDK (copilot)
Instal plugin eksternal @openclaw/copilot saat Anda ingin CLI dan SDK
Copilot milik GitHub menangani loop agen tingkat rendah untuk model
github-copilot/* tertentu.
openclaw plugins install clawhub:@openclaw/copilotLalu aktifkan runtime untuk sebuah model atau penyedia:
{ agents: { defaults: { model: "github-copilot/gpt-5.5", models: { "github-copilot/gpt-5.5": { agentRuntime: { id: "copilot" }, }, }, }, },}Pilih ini saat Anda menginginkan sesi Copilot CLI native, status thread yang dikelola SDK, dan Compaction milik Copilot untuk giliran agen tersebut. Lihat harness Copilot SDK untuk kontrak runtime lengkap.
Plugin Copilot Proxy (copilot-proxy)
Gunakan ekstensi VS Code Copilot Proxy sebagai bridge lokal. OpenClaw berbicara dengan
endpoint /v1 proxy dan menggunakan daftar model yang Anda konfigurasikan di sana.
Flag opsional
| Flag | Deskripsi |
|---|---|
--yes |
Lewati prompt konfirmasi |
--set-default |
Juga terapkan model default yang direkomendasikan penyedia |
# Skip confirmationopenclaw models auth login-github-copilot --yes # Login and set the default model in one stepopenclaw models auth login --provider github-copilot --method device --set-defaultOnboarding non-interaktif
Jika Anda sudah memiliki token akses OAuth GitHub untuk Copilot, impor saat
penyiapan headless dengan openclaw onboard --non-interactive:
openclaw onboard --non-interactive --accept-risk \ --auth-choice github-copilot \ --github-copilot-token "$COPILOT_GITHUB_TOKEN" \ --skip-channels --skip-healthAnda juga dapat menghilangkan --auth-choice; meneruskan --github-copilot-token akan menyimpulkan
pilihan auth penyedia GitHub Copilot. Jika flag dihilangkan, onboarding akan
fallback ke COPILOT_GITHUB_TOKEN, GH_TOKEN, lalu GITHUB_TOKEN. Gunakan
--secret-input-mode ref dengan COPILOT_GITHUB_TOKEN yang disetel untuk menyimpan
tokenRef berbasis env, bukan plaintext di auth-profiles.json.
TTY interaktif diperlukan
Alur login perangkat memerlukan TTY interaktif. Jalankan langsung di terminal, bukan dalam skrip non-interaktif 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 per paket Copilot
dari GitHub untuk daftar model saat ini.
Refresh katalog langsung dari API Copilot
Setelah jalur auth login perangkat (atau env-var) berhasil menyelesaikan token GitHub,
OpenClaw menyegarkan katalog model sesuai permintaan dari ${baseUrl}/models
(endpoint yang sama yang digunakan VS Code Copilot) sehingga runtime melacak
hak akun per akun dan jendela konteks yang akurat tanpa churn manifes.
Model Copilot yang baru diterbitkan menjadi terlihat tanpa upgrade OpenClaw,
dan jendela konteks mencerminkan batas nyata per model
(mis. 400k untuk seri gpt-5.x, 1M untuk varian internal
claude-opus-*-1m).
Katalog statis bawaan tetap menjadi fallback yang terlihat saat discovery
dinonaktifkan, pengguna tidak memiliki profil auth GitHub, penukaran token
gagal, atau panggilan HTTPS /models error. Untuk opt out dan sepenuhnya mengandalkan
katalog manifes statis (skenario offline / air-gapped):
{ plugins: { entries: { "github-copilot": { config: { discovery: { enabled: false } }, }, }, },}Pemilihan transport
ID model Claude menggunakan transport Anthropic Messages secara otomatis. GPT, o-series, dan model Gemini tetap menggunakan transport OpenAI Responses. OpenClaw memilih transport yang benar berdasarkan ref model.
Kompatibilitas permintaan
OpenClaw mengirim header permintaan bergaya Copilot IDE pada transport Copilot, termasuk Compaction bawaan, hasil alat, dan giliran tindak lanjut gambar. Ini tidak mengaktifkan kelanjutan Responses tingkat penyedia untuk Copilot kecuali perilaku tersebut telah diverifikasi terhadap API Copilot.
Urutan resolusi variabel lingkungan
OpenClaw menyelesaikan auth Copilot dari variabel lingkungan dalam urutan prioritas berikut:
| Prioritas | Variabel | Catatan |
|---|---|---|
| 1 | COPILOT_GITHUB_TOKEN |
Prioritas tertinggi, khusus Copilot |
| 2 | GH_TOKEN |
Token GitHub CLI (fallback) |
| 3 | GITHUB_TOKEN |
Token GitHub standar (terendah) |
Saat beberapa variabel disetel, OpenClaw menggunakan yang berprioritas tertinggi.
Alur login perangkat (openclaw models auth login-github-copilot) menyimpan
tokennya di penyimpanan profil auth dan lebih diprioritaskan daripada semua variabel
lingkungan.
Penyimpanan token
Login menyimpan token GitHub di penyimpanan profil auth dan menukarnya dengan token API Copilot saat OpenClaw berjalan. Anda tidak perlu mengelola token secara manual.
Embedding pencarian memori
GitHub Copilot juga dapat berfungsi sebagai penyedia embedding untuk pencarian memori. Jika Anda memiliki langganan Copilot dan sudah login, OpenClaw dapat menggunakannya untuk embedding tanpa kunci API terpisah.
Konfigurasi
Setel memorySearch.provider secara eksplisit untuk menggunakan embedding GitHub Copilot. Jika
token GitHub tersedia, OpenClaw menemukan model embedding yang tersedia dari
API Copilot dan memilih yang terbaik secara otomatis.
{ agents: { defaults: { memorySearch: { provider: "github-copilot", // Optional: override the auto-discovered model model: "text-embedding-3-small", }, }, },}Cara kerjanya
- OpenClaw menyelesaikan token GitHub Anda (dari env vars atau profil auth).
- Menukarnya dengan token API Copilot berumur pendek.
- Mengkueri endpoint
/modelsCopilot untuk menemukan model embedding yang tersedia. - Memilih model terbaik (memprioritaskan
text-embedding-3-small). - Mengirim permintaan embedding ke endpoint
/embeddingsCopilot.
Ketersediaan model bergantung pada paket GitHub Anda. Jika tidak ada model embedding yang tersedia, OpenClaw melewati Copilot dan mencoba penyedia berikutnya.
