Tiga cara menggunakan Copilot di OpenClaw
- Penyedia bawaan (github-copilot)
- Plugin harness Copilot SDK (copilot)
- Plugin Copilot Proxy (copilot-proxy)
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.
Flag opsional
| Flag | Deskripsi |
|---|---|
--yes | Lewati prompt konfirmasi |
--set-default | Juga terapkan model default yang direkomendasikan penyedia |
Onboarding non-interaktif
Jika Anda sudah memiliki token akses OAuth GitHub untuk Copilot, impor saat penyiapan headless denganopenclaw onboard --non-interactive:
--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
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 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
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):Pemilihan transport
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
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
Urutan resolusi variabel lingkungan
OpenClaw menyelesaikan auth Copilot dari variabel lingkungan dalam urutan
prioritas berikut:
Saat beberapa variabel disetel, OpenClaw menggunakan yang berprioritas tertinggi.
Alur login perangkat (
| 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) |
openclaw models auth login-github-copilot) menyimpan
tokennya di penyimpanan profil auth dan lebih diprioritaskan daripada semua variabel
lingkungan.Penyimpanan token
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
SetelmemorySearch.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.
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.
Terkait
Pemilihan model
Memilih penyedia, ref model, dan perilaku failover.
OAuth dan auth
Detail auth dan aturan penggunaan ulang kredensial.