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از شما خواسته میشود به یک URL بروید و یک کد یکبارمصرف وارد کنید. تا زمان تکمیل، ترمینال را باز نگه دارید.
تنظیم مدل پیشفرض
openclaw models set github-copilot/claude-opus-4.7یا در پیکربندی:
{ agents: { defaults: { model: { primary: "github-copilot/claude-opus-4.7" } }, },}Plugin پروکسی Copilot (copilot-proxy)
از افزونه VS Code Copilot Proxy بهعنوان یک پل محلی استفاده کنید. OpenClaw با
نقطه پایانی /v1 پروکسی ارتباط برقرار میکند و از فهرست مدلهایی استفاده میکند که آنجا پیکربندی میکنید.
پرچمهای اختیاری
| پرچم | توضیح |
|---|---|
--yes |
رد کردن اعلان تأیید |
--set-default |
همچنین مدل پیشفرض پیشنهادی ارائهدهنده را اعمال میکند |
# 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-defaultراهاندازی غیرتعاملی
اگر از قبل یک توکن دسترسی GitHub OAuth برای Copilot دارید، آن را در هنگام
راهاندازی بدون رابط تعاملی با 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 بازمیگردد. از
--secret-input-mode ref همراه با تنظیم COPILOT_GITHUB_TOKEN استفاده کنید تا بهجای متن آشکار در
auth-profiles.json یک tokenRef مبتنی بر متغیر محیطی ذخیره شود.
TTY تعاملی لازم است
جریان ورود با دستگاه به یک TTY تعاملی نیاز دارد. آن را مستقیماً در ترمینال اجرا کنید، نه در اسکریپت غیرتعاملی یا خط لوله CI.
دسترسپذیری مدل به طرح شما بستگی دارد
دسترسپذیری مدلهای Copilot به طرح GitHub شما بستگی دارد. اگر مدلی
رد شد، شناسه دیگری را امتحان کنید (برای مثال github-copilot/gpt-4.1).
تازهسازی زنده کاتالوگ از API Copilot
پس از اینکه مسیر احراز هویت ورود با دستگاه (یا متغیر محیطی) یک توکن GitHub را حل کرد،
OpenClaw کاتالوگ مدل را برحسب تقاضا از ${baseUrl}/models
(همان نقطه پایانی که VS Code Copilot استفاده میکند) تازهسازی میکند تا زمان اجرا
استحقاق هر حساب و پنجرههای زمینه دقیق را بدون تغییر مانیفست دنبال کند.
مدلهای Copilot تازه منتشرشده بدون ارتقای OpenClaw قابل مشاهده میشوند،
و پنجرههای زمینه محدودیتهای واقعی هر مدل را بازتاب میدهند
(مثلاً 400k برای سری gpt-5.x و 1M برای گونههای داخلی
claude-opus-*-1m).
کاتالوگ ایستای همراه، زمانی که کشف غیرفعال است، کاربر پروفایل احراز هویت GitHub ندارد،
مبادله توکن شکست میخورد، یا فراخوانی HTTPS به /models خطا میدهد،
بهعنوان پشتیبان قابل مشاهده باقی میماند. برای انصراف و اتکای کامل
به کاتالوگ مانیفست ایستا (سناریوهای آفلاین / جدا از شبکه):
{ plugins: { entries: { "github-copilot": { config: { discovery: { enabled: false } }, }, }, },}انتخاب انتقال
شناسههای مدل Claude بهصورت خودکار از انتقال Anthropic Messages استفاده میکنند. مدلهای GPT، سری o و Gemini انتقال OpenAI Responses را نگه میدارند. OpenClaw انتقال درست را براساس ارجاع مدل انتخاب میکند.
سازگاری درخواست
OpenClaw سرآیندهای درخواست به سبک IDE Copilot را روی انتقالهای Copilot ارسال میکند، از جمله نوبتهای داخلی Compaction، نتیجه ابزار، و پیگیری تصویر. این ابزار ادامه Responses در سطح ارائهدهنده را برای Copilot فعال نمیکند، مگر اینکه آن رفتار در برابر API Copilot تأیید شده باشد.
ترتیب حل متغیرهای محیطی
OpenClaw احراز هویت Copilot را از متغیرهای محیطی با ترتیب اولویت زیر حل میکند:
| اولویت | متغیر | یادداشتها |
|---|---|---|
| 1 | COPILOT_GITHUB_TOKEN |
بالاترین اولویت، مخصوص Copilot |
| 2 | GH_TOKEN |
توکن GitHub CLI (پشتیبان) |
| 3 | GITHUB_TOKEN |
توکن استاندارد GitHub (پایینترین) |
وقتی چند متغیر تنظیم شده باشد، OpenClaw از موردی با بالاترین اولویت استفاده میکند.
جریان ورود با دستگاه (openclaw models auth login-github-copilot) توکن خود را
در مخزن پروفایل احراز هویت ذخیره میکند و بر همه متغیرهای محیطی
اولویت دارد.
ذخیرهسازی توکن
ورود، یک توکن GitHub را در مخزن پروفایل احراز هویت ذخیره میکند و هنگام اجرای OpenClaw آن را با یک توکن API Copilot مبادله میکند. نیازی نیست توکن را بهصورت دستی مدیریت کنید.
تعبیههای جستوجوی حافظه
GitHub Copilot همچنین میتواند بهعنوان ارائهدهنده تعبیه برای جستوجوی حافظه عمل کند. اگر اشتراک Copilot دارید و وارد شدهاید، OpenClaw میتواند بدون کلید API جداگانه از آن برای تعبیهها استفاده کند.
تشخیص خودکار
وقتی memorySearch.provider برابر "auto" باشد (پیشفرض)، GitHub Copilot
با اولویت 15 امتحان میشود -- بعد از تعبیههای محلی اما قبل از OpenAI و سایر
ارائهدهندگان پولی. اگر توکن GitHub در دسترس باشد، OpenClaw مدلهای
تعبیه موجود را از API Copilot کشف میکند و بهترین مورد را بهصورت خودکار انتخاب میکند.
پیکربندی صریح
{ agents: { defaults: { memorySearch: { provider: "github-copilot", // Optional: override the auto-discovered model model: "text-embedding-3-small", }, }, },}نحوه کار
- OpenClaw توکن GitHub شما را حل میکند (از متغیرهای محیطی یا پروفایل احراز هویت).
- آن را با یک توکن کوتاهمدت API Copilot مبادله میکند.
- نقطه پایانی
/modelsدر Copilot را برای کشف مدلهای تعبیه موجود پرسوجو میکند. - بهترین مدل را انتخاب میکند (ترجیحاً
text-embedding-3-small). - درخواستهای تعبیه را به نقطه پایانی
/embeddingsدر Copilot ارسال میکند.
دسترسپذیری مدل به طرح GitHub شما بستگی دارد. اگر هیچ مدل تعبیهای در دسترس نباشد، OpenClaw از Copilot عبور میکند و ارائهدهنده بعدی را امتحان میکند.