Три способи використання Copilot в OpenClaw
- Вбудований постачальник (github-copilot)
- Plugin середовища Copilot SDK (copilot)
- Plugin Copilot Proxy (copilot-proxy)
Скористайтеся вбудованим процесом входу через пристрій, щоб отримати токен GitHub, а потім обмінюйте його на
токени API Copilot під час роботи OpenClaw. Це стандартний і найпростіший спосіб,
оскільки він не потребує VS Code.Вам буде запропоновано перейти за URL-адресою та ввести одноразовий код. Не закривайте
термінал до завершення процесу.Або в конфігурації:
1
Виконайте команду входу
2
Установіть модель за замовчуванням
GitHub Enterprise (резидентність даних)
Якщо ваша організація використовує клієнт GitHub Enterprise із резидентністю даних (вузол*.ghe.com, наприклад your-org.ghe.com), Copilot працює на локальних для клієнта
кінцевих точках, а не на загальнодоступному github.com. OpenClaw надає це як
повноцінний варіант автентифікації, щоб вам не доводилося вручну редагувати URL-адреси.
1
Виберіть варіант автентифікації 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 автоматично формує ці кінцеві точки з кореневого домену клієнта.2
Домен зберігається в конфігурації
Вибраний вузол зберігається в параметрах постачальника, тому подальші оновлення токена
й завершення автоматично спрямовуються до клієнта:
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 клієнта замість загальнодоступної кінцевої точки.
Перемикання доменів завжди повторно запускає вхід через пристрій. Якщо у вас уже збережено
токен Copilot і ви виберете інший домен (загальнодоступний
github.com ↔ клієнт
*.ghe.com або один клієнт ↔ інший), OpenClaw не використовуватиме наявний токен повторно —
він примусово виконає новий вхід, щоб область дії токена відповідала домену, який записується до
конфігурації. Повторний вхід для того самого домену, як і раніше, пропонує повторно використати поточний
токен. Повернення до загальнодоступного github.com очищає збережений
githubDomain, щоб конфігурація повернулася до стандартного стану.Змінна середовища
COPILOT_GITHUB_DOMAIN перевизначає визначений домен
для кожного процесу Copilot, який його визначає: входу через пристрій Enterprise
(--method device-enterprise), окремої скороченої команди
openclaw models auth login-github-copilot, оновлення токена, векторних представлень
і завершень. Установіть для неї значення вашого вузла *.ghe.com для повністю безінтерфейсних середовищ або
CI. Не встановлюйте її (і не додавайте параметр конфігурації), щоб використовувати загальнодоступний github.com.
Під час входу зберігається домен, для якого було створено токен (і очищається під час входу
через загальнодоступний github.com), тому маршрутизація залишається правильною навіть після
видалення змінної середовища.Необов’язкові прапорці
Неінтерактивне початкове налаштування
Процес входу через пристрій потребує інтерактивного TTY. Для налаштування без інтерфейсу імпортуйте наявний токен доступу GitHub OAuth за допомогоюopenclaw onboard --non-interactive:
--auth-choice: передавання --github-copilot-token автоматично визначає
варіант автентифікації постачальника GitHub Copilot. Якщо прапорець не вказано, початкове налаштування
послідовно перевіряє COPILOT_GITHUB_TOKEN, GH_TOKEN, а потім GITHUB_TOKEN. Використовуйте
--secret-input-mode ref із установленою змінною COPILOT_GITHUB_TOKEN, щоб зберігати
tokenRef із посиланням на змінну середовища замість відкритого тексту в auth-profiles.json.
Потрібен інтерактивний TTY
Потрібен інтерактивний TTY
Процес входу через пристрій потребує інтерактивного TTY. Запускайте його безпосередньо в
терміналі, а не в неінтерактивному сценарії чи конвеєрі CI.
Доступність моделей залежить від вашого тарифного плану
Доступність моделей залежить від вашого тарифного плану
Доступність моделей Copilot залежить від вашого тарифного плану GitHub. Якщо модель
відхилено, спробуйте інший ідентифікатор (наприклад,
github-copilot/gpt-5.5). Поточний
список моделей див. у переліку GitHub
підтримуваних моделей для кожного тарифного плану Copilot.Оновлення каталогу в реальному часі через API Copilot
Оновлення каталогу в реальному часі через API Copilot
Щойно шлях автентифікації через вхід із пристрою (або змінну середовища) визначить токен GitHub,
OpenClaw за потреби оновлює каталог моделей із
${baseUrl}/models
(тієї самої кінцевої точки, яку використовує VS Code Copilot), щоб середовище виконання враховувало
права доступу конкретного облікового запису й точні розміри контекстних вікон без
постійних змін маніфесту. Нові опубліковані моделі Copilot стають доступними без оновлення OpenClaw,
а контекстні вікна відповідають фактичним обмеженням кожної моделі
(наприклад, 400 тис. для серії gpt-5.x і 1 млн для внутрішніх
варіантів claude-opus-*-1m).Вбудований статичний каталог залишається видимим резервним варіантом, коли виявлення
вимкнено, у користувача немає профілю автентифікації GitHub, обмін токена
завершується невдало або HTTPS-виклик /models повертає помилку. Щоб вимкнути це й повністю
покладатися на статичний каталог маніфесту (для автономних або ізольованих від мережі середовищ):Вибір транспорту
Вибір транспорту
Ідентифікатори моделей Claude автоматично використовують транспорт Anthropic Messages.
Моделі Gemini використовують транспорт OpenAI Chat Completions; моделі GPT і серії o
продовжують використовувати транспорт OpenAI Responses. OpenClaw вибирає правильний
транспорт на основі посилання на модель.
Сумісність запитів
Сумісність запитів
OpenClaw надсилає в транспорті Copilot заголовки запитів у стилі IDE Copilot
(версії редактора/Plugin VS Code та ідентифікатор інтеграції
vscode-chat),
позначає наступні ходи після результату інструмента як ініційовані агентом і встановлює заголовок
візуального введення Copilot, коли хід містить вхідне зображення.Порядок визначення змінних середовища
Порядок визначення змінних середовища
OpenClaw визначає автентифікацію Copilot зі змінних середовища в такому
порядку пріоритетності:
Якщо встановлено кілька змінних, OpenClaw використовує змінну з найвищим пріоритетом.
Процес входу через пристрій (
openclaw models auth login-github-copilot) зберігає
свій токен у сховищі профілів автентифікації та має пріоритет над усіма змінними
середовища.Зберігання токена
Зберігання токена
Під час входу токен GitHub зберігається у сховищі профілів автентифікації (ідентифікатор профілю
github-copilot:github) і обмінюється на короткостроковий токен API Copilot
під час роботи OpenClaw. Вам не потрібно керувати токеном вручну.Векторні представлення для пошуку в пам’яті
GitHub Copilot також можна використовувати як постачальника векторних представлень для пошуку в пам’яті. Якщо у вас є передплата Copilot і ви ввійшли в систему, OpenClaw може використовувати його для векторних представлень без окремого ключа API.Конфігурація
Щоб використовувати векторні представлення GitHub Copilot, явно встановітьmemorySearch.provider. Якщо
токен GitHub доступний, OpenClaw виявляє доступні моделі векторних представлень через
API Copilot і автоматично вибирає найкращу.
Принцип роботи
- OpenClaw визначає ваш токен GitHub (зі змінних середовища або профілю автентифікації).
- Обмінює його на короткостроковий токен API Copilot.
- Надсилає запит до кінцевої точки Copilot
/models, щоб виявити доступні моделі векторних представлень. - Вибирає найкращу модель (порядок переваги:
text-embedding-3-small,text-embedding-3-large,text-embedding-ada-002). - Надсилає запити на створення векторних представлень до кінцевої точки Copilot
/embeddings.
Пов’язані матеріали
Вибір моделі
Вибір постачальників, посилань на моделі та поведінки резервного перемикання.
OAuth і автентифікація
Відомості про автентифікацію та правила повторного використання облікових даних.