Três maneiras de usar Copilot no OpenClaw
- Provedor integrado (github-copilot)
- Plugin de harness do SDK do Copilot (copilot)
- Plugin Copilot Proxy (copilot-proxy)
Use o fluxo nativo de login por dispositivo para obter um token do GitHub e depois trocá-lo por
tokens da API do Copilot quando o OpenClaw for executado. Este é o caminho padrão e mais simples
porque não exige VS Code.
Flags opcionais
| Flag | Descrição |
|---|---|
--yes | Pula o prompt de confirmação |
--set-default | Também aplica o modelo padrão recomendado do provedor |
Onboarding não interativo
Se você já tem um token de acesso OAuth do GitHub para Copilot, importe-o durante a configuração sem interface comopenclaw onboard --non-interactive:
--auth-choice; passar --github-copilot-token infere a
escolha de autenticação do provedor GitHub Copilot. Se a flag for omitida, o onboarding
recorre a COPILOT_GITHUB_TOKEN, GH_TOKEN e depois GITHUB_TOKEN. Use
--secret-input-mode ref com COPILOT_GITHUB_TOKEN definido para armazenar um
tokenRef baseado em variável de ambiente em vez de texto simples em auth-profiles.json.
TTY interativo obrigatório
TTY interativo obrigatório
O fluxo de login por dispositivo exige um TTY interativo. Execute-o diretamente em um
terminal, não em um script não interativo ou pipeline de CI.
A disponibilidade de modelos depende do seu plano
A disponibilidade de modelos depende do seu plano
A disponibilidade de modelos do Copilot depende do seu plano do GitHub. Se um modelo for
rejeitado, tente outro ID (por exemplo,
github-copilot/gpt-5.5). Consulte os
modelos compatíveis por plano Copilot
do GitHub para ver a lista atual de modelos.Atualização de catálogo ao vivo pela API do Copilot
Atualização de catálogo ao vivo pela API do Copilot
Depois que o caminho de autenticação por login de dispositivo (ou variável de ambiente) resolve um token do GitHub,
OpenClaw atualiza o catálogo de modelos sob demanda a partir de
${baseUrl}/models
(o mesmo endpoint usado pelo VS Code Copilot), para que o ambiente de execução acompanhe
direitos por conta e janelas de contexto precisas sem rotatividade de manifesto.
Modelos Copilot recém-publicados ficam visíveis sem uma atualização do OpenClaw,
e as janelas de contexto refletem os limites reais por modelo
(por exemplo, 400k para a série gpt-5.x, 1M para as variantes internas
claude-opus-*-1m).O catálogo estático incluído permanece como fallback visível quando a descoberta
está desabilitada, o usuário não tem perfil de autenticação do GitHub, a troca de token
falha ou a chamada HTTPS para /models gera erro. Para desativar e confiar inteiramente
no catálogo estático do manifesto (cenários offline / air-gapped):Seleção de transporte
Seleção de transporte
IDs de modelos Claude usam automaticamente o transporte Anthropic Messages. Modelos GPT,
o-series e Gemini mantêm o transporte OpenAI Responses. OpenClaw
seleciona o transporte correto com base na referência do modelo.
Compatibilidade de requisições
Compatibilidade de requisições
OpenClaw envia cabeçalhos de requisição no estilo IDE do Copilot em transportes Copilot,
incluindo turnos de Compaction integrada, resultado de ferramenta e acompanhamento de imagem. Ele
não habilita continuação Responses no nível do provedor para Copilot, a menos
que esse comportamento tenha sido verificado em relação à API do Copilot.
Ordem de resolução de variáveis de ambiente
Ordem de resolução de variáveis de ambiente
OpenClaw resolve a autenticação do Copilot a partir de variáveis de ambiente na seguinte
ordem de prioridade:
Quando várias variáveis estão definidas, OpenClaw usa a de maior prioridade.
O fluxo de login por dispositivo (
| Prioridade | Variável | Observações |
|---|---|---|
| 1 | COPILOT_GITHUB_TOKEN | Maior prioridade, específica do Copilot |
| 2 | GH_TOKEN | Token da CLI do GitHub (fallback) |
| 3 | GITHUB_TOKEN | Token padrão do GitHub (menor prioridade) |
openclaw models auth login-github-copilot) armazena
seu token no armazenamento de perfis de autenticação e tem precedência sobre todas as variáveis
de ambiente.Armazenamento de token
Armazenamento de token
O login armazena um token do GitHub no armazenamento de perfis de autenticação e o troca
por um token da API do Copilot quando o OpenClaw é executado. Você não precisa gerenciar o
token manualmente.
Embeddings de busca de memória
GitHub Copilot também pode atuar como provedor de embeddings para busca de memória. Se você tem uma assinatura do Copilot e fez login, OpenClaw pode usá-lo para embeddings sem uma chave de API separada.Configuração
DefinamemorySearch.provider explicitamente para usar embeddings do GitHub Copilot. Se um
token do GitHub estiver disponível, OpenClaw descobre os modelos de embedding disponíveis pela
API do Copilot e escolhe automaticamente o melhor.
Como funciona
- OpenClaw resolve seu token do GitHub (a partir de variáveis de ambiente ou perfil de autenticação).
- Troca-o por um token de curta duração da API do Copilot.
- Consulta o endpoint
/modelsdo Copilot para descobrir modelos de embedding disponíveis. - Escolhe o melhor modelo (prefere
text-embedding-3-small). - Envia requisições de embedding para o endpoint
/embeddingsdo Copilot.
Relacionados
Seleção de modelos
Escolha de provedores, referências de modelo e comportamento de failover.
OAuth e autenticação
Detalhes de autenticação e regras de reutilização de credenciais.