Providers
GitHub Copilot
GitHub Copilot دستیار کدنویسی هوش مصنوعی GitHub است. این ابزار دسترسی به مدلهای Copilot را برای حساب و طرح GitHub شما فراهم میکند. OpenClaw میتواند از Copilot بهعنوان ارائهدهنده مدل به دو روش متفاوت استفاده کند.
دو روش برای استفاده از Copilot در OpenClaw
Built-in provider (github-copilot)
از جریان ورود بومی دستگاه برای دریافت توکن GitHub استفاده کنید، سپس هنگام اجرای OpenClaw آن را با توکنهای API Copilot مبادله کنید. این مسیر پیشفرض و سادهترین روش است چون به VS Code نیاز ندارد.
Run the login command
openclaw models auth login-github-copilot
از شما خواسته میشود یک URL را باز کنید و یک کد یکبارمصرف وارد کنید. تا زمان تکمیل شدن فرایند، ترمینال را باز نگه دارید.
Set a default model
openclaw models set github-copilot/claude-opus-4.7
یا در پیکربندی:
{
agents: {
defaults: { model: { primary: "github-copilot/claude-opus-4.7" } },
},
}
Copilot Proxy plugin (copilot-proxy)
از افزونه VS Code با نام Copilot Proxy بهعنوان یک پل محلی استفاده کنید. OpenClaw با
نقطه پایانی /v1 پراکسی صحبت میکند و از فهرست مدلهایی که آنجا پیکربندی میکنید استفاده میکند.
پرچمهای اختیاری
| پرچم | توضیح |
|---|---|
--yes |
اعلان تأیید را رد میکند |
--set-default |
مدل پیشفرض پیشنهادی ارائهدهنده را نیز اعمال میکند |
# Skip confirmation
openclaw models auth login-github-copilot --yes
# Login and set the default model in one step
openclaw models auth login --provider github-copilot --method device --set-default
راهاندازی غیرتعاملی
اگر از قبل یک توکن دسترسی OAuth برای GitHub Copilot دارید، آن را هنگام
راهاندازی headless با 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 مبتنی بر متغیر محیطی ذخیره شود.
Interactive TTY required
جریان ورود دستگاه به یک TTY تعاملی نیاز دارد. آن را مستقیماً در ترمینال اجرا کنید، نه در یک اسکریپت غیرتعاملی یا خط لوله CI.
Model availability depends on your plan
دسترسپذیری مدلهای Copilot به طرح GitHub شما بستگی دارد. اگر یک مدل
رد شد، شناسه دیگری را امتحان کنید، برای مثال github-copilot/gpt-4.1.
Transport selection
شناسههای مدل Claude بهطور خودکار از انتقال Anthropic Messages استفاده میکنند. مدلهای GPT، سری o، و Gemini انتقال OpenAI Responses را نگه میدارند. OpenClaw انتقال درست را بر اساس ارجاع مدل انتخاب میکند.
Request compatibility
OpenClaw در انتقالهای Copilot سرآیندهای درخواست به سبک IDE مربوط به Copilot را ارسال میکند، از جمله نوبتهای داخلی Compaction، نتیجه ابزار، و پیگیری تصویر. این ابزار ادامهدهی Responses در سطح ارائهدهنده را برای Copilot فعال نمیکند، مگر اینکه آن رفتار در برابر API Copilot تأیید شده باشد.
Environment variable resolution order
OpenClaw احراز هویت Copilot را از متغیرهای محیطی با ترتیب اولویت زیر حل میکند:
| اولویت | متغیر | یادداشتها |
|---|---|---|
| 1 | COPILOT_GITHUB_TOKEN |
بالاترین اولویت، مخصوص Copilot |
| 2 | GH_TOKEN |
توکن GitHub CLI (جایگزین) |
| 3 | GITHUB_TOKEN |
توکن استاندارد GitHub (کمترین اولویت) |
وقتی چند متغیر تنظیم شده باشند، OpenClaw از موردی با بالاترین اولویت استفاده میکند.
جریان ورود دستگاه (openclaw models auth login-github-copilot) توکن
خود را در مخزن پروفایل احراز هویت ذخیره میکند و بر همه متغیرهای محیطی
مقدم است.
Token storage
ورود، یک توکن GitHub را در مخزن پروفایل احراز هویت ذخیره میکند و هنگام اجرای OpenClaw آن را با یک توکن API Copilot مبادله میکند. لازم نیست توکن را دستی مدیریت کنید.
embeddingهای جستوجوی حافظه
GitHub Copilot همچنین میتواند بهعنوان ارائهدهنده embedding برای جستوجوی حافظه عمل کند. اگر اشتراک Copilot دارید و وارد شدهاید، OpenClaw میتواند بدون کلید API جداگانه از آن برای embeddingها استفاده کند.
تشخیص خودکار
وقتی memorySearch.provider برابر "auto" باشد (حالت پیشفرض)، GitHub Copilot با
اولویت 15 امتحان میشود -- بعد از embeddingهای محلی اما قبل از OpenAI و سایر
ارائهدهندگان پولی. اگر توکن GitHub در دسترس باشد، OpenClaw مدلهای
embedding موجود را از 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 پرسوجو میکند تا مدلهای embedding موجود را کشف کند. - بهترین مدل را انتخاب میکند (ترجیحاً
text-embedding-3-small). - درخواستهای embedding را به نقطه پایانی
/embeddingsدر Copilot ارسال میکند.
دسترسپذیری مدل به طرح GitHub شما بستگی دارد. اگر هیچ مدل embedding در دسترس نباشد، OpenClaw از Copilot عبور میکند و ارائهدهنده بعدی را امتحان میکند.