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",
          },
        },
      },
    }
    

    نحوه کار

    1. OpenClaw توکن GitHub شما را حل می‌کند (از متغیرهای محیطی یا پروفایل احراز هویت).
    2. آن را با یک توکن کوتاه‌مدت API Copilot مبادله می‌کند.
    3. از نقطه پایانی /models در Copilot پرس‌وجو می‌کند تا مدل‌های embedding موجود را کشف کند.
    4. بهترین مدل را انتخاب می‌کند (ترجیحاً text-embedding-3-small).
    5. درخواست‌های embedding را به نقطه پایانی /embeddings در Copilot ارسال می‌کند.

    دسترس‌پذیری مدل به طرح GitHub شما بستگی دارد. اگر هیچ مدل embedding در دسترس نباشد، OpenClaw از Copilot عبور می‌کند و ارائه‌دهنده بعدی را امتحان می‌کند.

    مرتبط