Providers
GitHub Copilot
GitHub Copilot دستیار کدنویسی هوش مصنوعی GitHub است. این ابزار دسترسی به مدلهای Copilot را برای حساب و طرح GitHub شما فراهم میکند. OpenClaw میتواند به سه روش مختلف از Copilot بهعنوان ارائهدهنده مدل یا محیط اجرای عامل استفاده کند.
سه روش استفاده از Copilot در OpenClaw
ارائهدهنده داخلی (github-copilot)
از جریان ورود بومی دستگاه برای دریافت توکن GitHub استفاده کنید و سپس هنگام اجرای OpenClaw، آن را با توکنهای API مربوط به Copilot مبادله کنید. این مسیر پیشفرض و سادهترین مسیر است، زیرا به VS Code نیاز ندارد.
اجرای فرمان ورود
openclaw models auth login-github-copilotاز شما خواسته میشود به یک URL مراجعه کنید و کدی یکبارمصرف وارد کنید. تا زمان تکمیل فرایند، ترمینال را باز نگه دارید.
تنظیم یک مدل پیشفرض
openclaw models set github-copilot/claude-opus-4.7یا در پیکربندی:
{ agents: { defaults: { model: { primary: "github-copilot/claude-opus-4.7" } }, },}Plugin مهار SDK مربوط به Copilot (copilot)
هنگامی که میخواهید CLI و SDK مربوط به Copilot در GitHub حلقه سطح پایین عامل
را برای مدلهای انتخابشده github-copilot/* مدیریت کنند، Plugin خارجی
@openclaw/copilot را نصب کنید.
openclaw plugins install @openclaw/copilotسپس یک مدل یا ارائهدهنده را برای استفاده از محیط اجرا فعال کنید:
{ agents: { defaults: { model: "github-copilot/gpt-5.5", models: { "github-copilot/gpt-5.5": { agentRuntime: { id: "copilot" }, }, }, }, },}زمانی این گزینه را انتخاب کنید که نشستهای بومی CLI مربوط به Copilot، وضعیت
رشته مدیریتشده با SDK و Compaction تحت مدیریت Copilot را برای آن نوبتهای عامل
میخواهید. بدون فعالسازی صریح agentRuntime، مدلهای github-copilot/*
همچنان از ارائهدهنده داخلی استفاده میکنند. برای قرارداد کامل محیط اجرا،
مهار SDK مربوط به Copilot را ببینید.
Plugin پراکسی Copilot (copilot-proxy)
از افزونه VS Code با نام Copilot Proxy بهعنوان پل محلی استفاده کنید. OpenClaw
با نقطه پایانی /v1 پراکسی (پیشفرض http://localhost:3000/v1) ارتباط
برقرار میکند و از فهرست مدلهایی که پیکربندی میکنید استفاده میکند.
Plugin مربوط به copilot-proxy همراه OpenClaw ارائه میشود و بهطور پیشفرض
فعال است. URL پایه و شناسههای مدل را با فرمان زیر پیکربندی کنید:
openclaw models auth login --provider copilot-proxy --set-defaultGitHub Enterprise (محل اقامت دادهها)
اگر سازمان شما از مستأجر GitHub Enterprise با قابلیت اقامت دادهها استفاده میکند
(میزبان *.ghe.com مانند your-org.ghe.com)، Copilot بهجای
github.com عمومی روی نقاط پایانی محلی مستأجر قرار دارد. OpenClaw این
امکان را بهعنوان گزینه احراز هویت درجهیک ارائه میدهد تا نیازی به ویرایش دستی
URLها نداشته باشید.
انتخاب گزینه احراز هویت Enterprise
هنگام راهاندازی اولیه یا openclaw models auth، گزینه
GitHub Copilot (Enterprise / data residency) را انتخاب کنید. از شما دامنه
Enterprise خواسته میشود (برای مثال your-org.ghe.com) و سپس ورود دستگاه
در همان مستأجر انجام میشود.
فقط ریشه مستأجر (your-org.ghe.com) را وارد کنید. میزبانهای سرویس مشتقشده
مانند api.your-org.ghe.com یا copilot-api.your-org.ghe.com پذیرفته نمیشوند؛
OpenClaw این نقاط پایانی را بهطور خودکار از ریشه مستأجر استخراج میکند.
openclaw models auth login --provider github-copilot --method device-enterpriseذخیره دامنه در پیکربندی
میزبان انتخابشده در پارامترهای ارائهدهنده ذخیره میشود تا نوسازیهای بعدی توکن و تکمیلها بهطور خودکار مستأجر را هدف بگیرند:
{ models: { providers: { "github-copilot": { params: { githubDomain: "your-org.ghe.com" } }, }, },}جریان دستگاه، مبادله توکن و تکمیلها بهترتیب به
https://your-org.ghe.com/login/device/code،
https://api.your-org.ghe.com/copilot_internal/v2/token و
https://copilot-api.your-org.ghe.com هدایت میشوند. توکنهای اقامت داده دارای
مهر مستأجر هستند و اشارهای به پراکسی ندارند؛ بنابراین URL پایه تکمیلها بهجای
نقطه پایانی عمومی، از میزبان Copilot مستأجر استفاده میکند.
پرچمهای اختیاری
| فرمان | پرچم | توضیحات |
|---|---|---|
openclaw models auth login-github-copilot |
--yes |
بازنویسی نمایه احراز هویت موجود بدون درخواست تأیید |
openclaw models auth login --provider github-copilot --method device |
--set-default |
اعمال مدل پیشفرض پیشنهادی ارائهدهنده نیز |
# رد کردن تأیید ورود دوبارهopenclaw models auth login-github-copilot --yes # ورود و تنظیم مدل پیشفرض در یک مرحلهopenclaw models auth login --provider github-copilot --method device --set-defaultراهاندازی اولیه غیرتعاملی
جریان ورود دستگاه به TTY تعاملی نیاز دارد. برای راهاندازی بدون رابط، یک توکن
دسترسی OAuth موجود GitHub را با openclaw onboard --non-interactive وارد کنید:
openclaw onboard --non-interactive --accept-risk \ --auth-choice github-copilot \ --github-copilot-token "$COPILOT_GITHUB_TOKEN" \ --skip-channels --skip-healthهمچنین میتوانید --auth-choice را حذف کنید؛ ارائه
--github-copilot-token گزینه احراز هویت ارائهدهنده GitHub Copilot را استنباط میکند.
اگر پرچم حذف شود، راهاندازی اولیه بهترتیب به COPILOT_GITHUB_TOKEN،
GH_TOKEN و سپس GITHUB_TOKEN بازمیگردد. برای ذخیره
tokenRef مبتنی بر محیط بهجای متن ساده در auth-profiles.json،
از --secret-input-mode ref همراه با تنظیم COPILOT_GITHUB_TOKEN استفاده کنید.
TTY تعاملی الزامی است
جریان ورود دستگاه به TTY تعاملی نیاز دارد. آن را مستقیماً در یک ترمینال اجرا کنید، نه در اسکریپت غیرتعاملی یا پایپلاین CI.
دسترسپذیری مدل به طرح شما بستگی دارد
دسترسپذیری مدلهای Copilot به طرح GitHub شما بستگی دارد. اگر مدلی رد شد،
شناسه دیگری را امتحان کنید (برای مثال github-copilot/gpt-5.5). برای مشاهده
فهرست فعلی مدلها، مدلهای پشتیبانیشده برای هر طرح Copilot
در GitHub را ببینید.
نوسازی زنده کاتالوگ از API مربوط به Copilot
پس از اینکه مسیر احراز هویت ورود دستگاه (یا متغیر محیطی) یک توکن GitHub را
تعیین کرد، OpenClaw کاتالوگ مدل را هنگام نیاز از ${baseUrl}/models
(همان نقطه پایانی که Copilot در VS Code استفاده میکند) نوسازی میکند تا محیط
اجرا مجوزهای هر حساب و پنجرههای زمینه دقیق را بدون تغییر مداوم مانیفست دنبال
کند. مدلهای تازه منتشرشده Copilot بدون ارتقای OpenClaw قابل مشاهده میشوند
و پنجرههای زمینه محدودیتهای واقعی هر مدل را بازتاب میدهند
(برای مثال 400k برای سری gpt-5.x و 1M برای گونههای داخلی
claude-opus-*-1m).
هنگامی که کشف غیرفعال باشد، کاربر نمایه احراز هویت GitHub نداشته باشد، مبادله
توکن ناموفق شود یا فراخوانی HTTPS مربوط به /models خطا دهد،
کاتالوگ ایستای همراه محصول بهعنوان جایگزین قابل مشاهده باقی میماند. برای
انصراف و اتکای کامل به کاتالوگ ایستای مانیفست (سناریوهای آفلاین / جدا از شبکه):
{ plugins: { entries: { "github-copilot": { config: { discovery: { enabled: false } }, }, }, },}انتخاب انتقال
شناسه مدلهای Claude بهطور خودکار از انتقال Anthropic Messages استفاده میکنند. مدلهای Gemini از انتقال OpenAI Chat Completions استفاده میکنند؛ مدلهای GPT و سری o همچنان از انتقال OpenAI Responses استفاده میکنند. OpenClaw انتقال صحیح را بر اساس مرجع مدل انتخاب میکند.
سازگاری درخواست
OpenClaw سرآیندهای درخواست به سبک Copilot IDE را در انتقالهای Copilot ارسال
میکند (نسخههای ویرایشگر/Plugin در VS Code و شناسه یکپارچهسازی
vscode-chat)، نوبتهای پیگیری نتیجه ابزار را بهعنوان آغازشده توسط
عامل علامتگذاری میکند و هنگامی که نوبتی ورودی تصویر دارد، سرآیند بینایی
Copilot را تنظیم میکند.
ترتیب حل متغیرهای محیطی
OpenClaw احراز هویت Copilot را از متغیرهای محیطی با ترتیب اولویت زیر حل میکند:
| اولویت | متغیر | یادداشتها |
|---|---|---|
| 1 | COPILOT_GITHUB_TOKEN |
بالاترین اولویت، مختص Copilot |
| 2 | GH_TOKEN |
توکن CLI مربوط به GitHub (جایگزین) |
| 3 | GITHUB_TOKEN |
توکن استاندارد GitHub (پایینترین) |
هنگامی که چند متغیر تنظیم شده باشند، OpenClaw از متغیری با بالاترین اولویت
استفاده میکند. جریان ورود دستگاه (openclaw models auth login-github-copilot) توکن خود را در
مخزن نمایه احراز هویت ذخیره میکند و بر همه متغیرهای محیطی اولویت دارد.
ذخیرهسازی توکن
ورود، یک توکن GitHub را در مخزن نمایه احراز هویت (شناسه نمایه
github-copilot:github) ذخیره میکند و هنگام اجرای OpenClaw آن را با یک توکن
کوتاهعمر API مربوط به Copilot مبادله میکند. نیازی نیست توکن را دستی مدیریت کنید.
تعبیههای جستوجوی حافظه
GitHub Copilot همچنین میتواند بهعنوان ارائهدهنده تعبیه برای جستوجوی حافظه عمل کند. اگر اشتراک Copilot دارید و وارد شدهاید، OpenClaw میتواند بدون کلید API جداگانه از آن برای تعبیهها استفاده کند.
پیکربندی
برای استفاده از تعبیههای GitHub Copilot، مقدار memory.search.provider را صریحاً
تنظیم کنید. اگر توکن GitHub در دسترس باشد، OpenClaw مدلهای تعبیه موجود را از
API مربوط به Copilot کشف میکند و بهطور خودکار بهترین مدل را انتخاب میکند.
{ memory: { search: { provider: "github-copilot", // اختیاری: بازنویسی مدل کشفشده بهطور خودکار model: "text-embedding-3-small", }, },}نحوه کار
- OpenClaw توکن GitHub شما را حل میکند (از متغیرهای محیطی یا نمایه احراز هویت).
- آن را با یک توکن کوتاهعمر API مربوط به Copilot مبادله میکند.
- برای کشف مدلهای تعبیه موجود، نقطه پایانی
/modelsمربوط به Copilot را پرسوجو میکند. - بهترین مدل را انتخاب میکند (ترتیب ترجیح:
text-embedding-3-small،text-embedding-3-large،text-embedding-ada-002). - درخواستهای تعبیه را به نقطه پایانی
/embeddingsمربوط به Copilot ارسال میکند.
دسترسپذیری مدل به طرح GitHub شما بستگی دارد. اگر هیچ مدل تعبیهای در دسترس نباشد، OpenClaw از Copilot صرفنظر میکند و ارائهدهنده بعدی را امتحان میکند.