Providers
GitHub Copilot
GitHub Copilot دستیار کدنویسی هوش مصنوعی GitHub است. این سرویس برای حساب و طرح GitHub شما دسترسی به مدلهای Copilot را فراهم میکند. OpenClaw میتواند به سه روش مختلف از Copilot بهعنوان ارائهدهنده مدل یا محیط اجرای عامل استفاده کند.
سه روش استفاده از Copilot در OpenClaw
ارائهدهنده داخلی (github-copilot)
از جریان بومی ورود با دستگاه برای دریافت توکن GitHub استفاده کنید، سپس هنگام اجرای OpenClaw آن را با توکنهای API مربوط به Copilot مبادله کنید. این مسیر پیشفرض و سادهترین گزینه است، زیرا به VS Code نیاز ندارد.
اجرای فرمان ورود
openclaw models auth login-github-copilotاز شما خواسته میشود به یک نشانی وب مراجعه و یک کد یکبارمصرف وارد کنید. تا تکمیل فرایند، پایانه را باز نگه دارید.
تنظیم یک مدل پیشفرض
openclaw models set github-copilot/claude-opus-4.7یا در پیکربندی:
{ agents: { defaults: { model: { primary: "github-copilot/claude-opus-4.7" } }, },}Plugin چارچوب Copilot SDK (copilot)
زمانی که میخواهید Copilot CLI و SDK متعلق به 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" }, }, }, }, },}این گزینه را زمانی انتخاب کنید که برای آن نوبتهای عامل، نشستهای بومی Copilot CLI، وضعیت رشته مدیریتشده با SDK و Compaction تحت مدیریت Copilot را میخواهید. بدون فعالسازی صریح agentRuntime، مدلهای github-copilot/* همچنان از ارائهدهنده داخلی استفاده میکنند. برای قرارداد کامل محیط اجرا، به چارچوب Copilot SDK مراجعه کنید.
Plugin پراکسی Copilot (copilot-proxy)
از افزونه VS Code با نام Copilot Proxy بهعنوان یک پل محلی استفاده کنید. OpenClaw با نقطه پایانی /v1 پراکسی (بهطور پیشفرض http://localhost:3000/v1) ارتباط برقرار میکند و از فهرست مدلهایی که پیکربندی میکنید استفاده میکند.
Plugin مربوط به copilot-proxy همراه OpenClaw ارائه میشود و بهطور پیشفرض فعال است. نشانی پایه و شناسههای مدل را با فرمان زیر پیکربندی کنید:
openclaw models auth login --provider copilot-proxy --set-defaultGitHub Enterprise (اقامت داده)
اگر سازمان شما از یک مستأجر GitHub Enterprise دارای اقامت داده استفاده میکند (میزبانی با الگوی *.ghe.com مانند your-org.ghe.com)، Copilot بهجای github.com عمومی روی نقاط پایانی محلی همان مستأجر قرار دارد. OpenClaw این حالت را بهعنوان یک گزینه احراز هویت درجهیک ارائه میکند تا نیازی به ویرایش دستی نشانیها نداشته باشید.
انتخاب گزینه احراز هویت 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 نگاشت میشوند. توکنهای اقامت داده دارای مهر مستأجر هستند و هیچ راهنمای پراکسی ندارند؛ بنابراین نشانی پایه تکمیلها بهجای نقطه پایانی عمومی، از میزبان 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 استفاده میکند. با تنظیم COPILOT_GITHUB_TOKEN، از --secret-input-mode ref استفاده کنید تا بهجای متن ساده در auth-profiles.json، یک tokenRef مبتنی بر متغیر محیطی ذخیره شود.
TTY تعاملی الزامی است
جریان ورود با دستگاه به یک TTY تعاملی نیاز دارد. آن را مستقیماً در یک پایانه اجرا کنید، نه در اسکریپت غیرتعاملی یا خط لوله CI.
دردسترسبودن مدل به طرح شما بستگی دارد
دردسترسبودن مدلهای Copilot به طرح GitHub شما بستگی دارد. اگر مدلی رد شد، شناسه دیگری را امتحان کنید (برای مثال github-copilot/gpt-5.5). برای مشاهده فهرست فعلی مدلها، به مدلهای پشتیبانیشده در هر طرح Copilot متعلق به GitHub مراجعه کنید.
تازهسازی زنده فهرست از API مربوط به Copilot
پس از آنکه مسیر احراز هویت ورود با دستگاه (یا متغیر محیطی) یک توکن GitHub را تعیین کرد، OpenClaw فهرست مدلها را در صورت نیاز از ${baseUrl}/models تازهسازی میکند (همان نقطه پایانی که Copilot در VS Code استفاده میکند) تا محیط اجرا بدون تغییر مکرر مانیفست، استحقاقهای هر حساب و پنجرههای زمینه دقیق را دنبال کند. مدلهای تازه منتشرشده Copilot بدون ارتقای OpenClaw قابل مشاهده میشوند و پنجرههای زمینه محدودیتهای واقعی هر مدل را منعکس میکنند (برای مثال ۴۰۰ هزار برای سری gpt-5.x و ۱ میلیون برای گونههای داخلی 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، سرآیندهای درخواست به سبک محیط توسعه Copilot را ارسال میکند (نسخههای ویرایشگر/Plugin در VS Code و شناسه یکپارچهسازی vscode-chat)، نوبتهای پیگیری نتیجه ابزار را بهعنوان آغازشده توسط عامل علامت میزند و هنگامی که یک نوبت شامل ورودی تصویر باشد، سرآیند بینایی Copilot را تنظیم میکند.
ترتیب تعیین متغیرهای محیطی
OpenClaw احراز هویت Copilot را با ترتیب اولویت زیر از متغیرهای محیطی تعیین میکند:
| اولویت | متغیر | توضیحات |
|---|---|---|
| ۱ | COPILOT_GITHUB_TOKEN |
بالاترین اولویت، ویژه Copilot |
| ۲ | GH_TOKEN |
توکن GitHub CLI (جایگزین) |
| ۳ | GITHUB_TOKEN |
توکن استاندارد GitHub (کمترین اولویت) |
وقتی چند متغیر تنظیم شده باشند، OpenClaw از مورد دارای بالاترین اولویت استفاده میکند. جریان ورود با دستگاه (openclaw models auth login-github-copilot) توکن خود را در مخزن نمایه احراز هویت ذخیره میکند و بر همه متغیرهای محیطی اولویت دارد.
ذخیرهسازی توکن
فرایند ورود یک توکن GitHub را در مخزن نمایه احراز هویت (با شناسه نمایه github-copilot:github) ذخیره میکند و هنگام اجرای OpenClaw آن را با یک توکن کوتاهعمر API مربوط به Copilot مبادله میکند. نیازی نیست توکن را بهصورت دستی مدیریت کنید.
بردارسازیهای جستوجوی حافظه
GitHub Copilot میتواند بهعنوان ارائهدهنده بردارسازی برای جستوجوی حافظه نیز عمل کند. اگر اشتراک Copilot دارید و وارد شدهاید، OpenClaw میتواند بدون کلید API جداگانه از آن برای بردارسازی استفاده کند.
پیکربندی
برای استفاده از بردارسازیهای GitHub Copilot، memorySearch.provider را بهصراحت تنظیم کنید. اگر توکن GitHub در دسترس باشد، OpenClaw مدلهای بردارسازی موجود را از API مربوط به Copilot کشف میکند و بهترین مورد را بهطور خودکار انتخاب میکند.
{ agents: { defaults: { memorySearch: { 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 صرفنظر میکند و ارائهدهنده بعدی را امتحان میکند.