Три способа использования Copilot в OpenClaw
- Встроенный поставщик (github-copilot)
- Плагин среды Copilot SDK (copilot)
- Плагин 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
(той же конечной точки, которую использует Copilot в VS Code), чтобы среда выполнения учитывала
права конкретной учетной записи и точные размеры контекстного окна без
изменений манифеста. Недавно опубликованные модели Copilot становятся доступны без обновления
OpenClaw, а размеры контекстного окна отражают реальные ограничения каждой модели
(например, 400k для серии gpt-5.x и 1M для внутренних
вариантов claude-opus-*-1m).Встроенный статический каталог остается видимым резервным вариантом, если обнаружение
отключено, у пользователя нет профиля аутентификации GitHub, произошел сбой обмена
токена или HTTPS-вызов /models завершился ошибкой. Чтобы отказаться от этого механизма и полностью
полагаться на статический каталог манифеста (в автономных или изолированных от сети средах):Выбор транспорта
Выбор транспорта
Для идентификаторов моделей Claude автоматически используется транспорт Anthropic Messages.
Модели Gemini используют транспорт OpenAI Chat Completions, а модели GPT и серии o
продолжают использовать транспорт OpenAI Responses. OpenClaw выбирает правильный
транспорт на основе ссылки на модель.
Совместимость запросов
Совместимость запросов
OpenClaw отправляет заголовки запросов в стиле Copilot IDE через транспорты Copilot
(версии редактора/плагина 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.Конфигурация
Явно задайтеmemorySearch.provider, чтобы использовать векторные представления GitHub Copilot. Если
доступен токен 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 и аутентификация
Сведения об аутентификации и правила повторного использования учётных данных.