Pular para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

GitHub Copilot é o assistente de programação por IA do GitHub. Ele fornece acesso aos modelos do Copilot para sua conta e seu plano do GitHub. O OpenClaw pode usar o Copilot como provedor de modelos de duas maneiras diferentes.

​
Duas maneiras de usar o Copilot no OpenClaw

Use o fluxo nativo de login por dispositivo para obter um token do GitHub e, em seguida, trocá-lo por tokens da API do Copilot quando o OpenClaw for executado. Este é o caminho padrão e mais simples porque não requer o VS Code.
1

Run the login command

openclaw models auth login-github-copilot
Você será solicitado a acessar uma URL e inserir um código de uso único. Mantenha o terminal aberto até que ele seja concluído.
2

Set a default model

openclaw models set github-copilot/claude-opus-4.7
Ou na configuração:
{
  agents: {
    defaults: { model: { primary: "github-copilot/claude-opus-4.7" } },
  },
}

​
Flags opcionais

FlagDescrição
--yesPula o prompt de confirmação
--set-defaultTambém aplica o modelo padrão recomendado pelo provedor
# 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

​
Integração não interativa

Se você já tem um token de acesso OAuth do GitHub para o Copilot, importe-o durante a configuração sem interface com openclaw onboard --non-interactive: 
openclaw onboard --non-interactive --accept-risk \
  --auth-choice github-copilot \
  --github-copilot-token "$COPILOT_GITHUB_TOKEN" \
  --skip-channels --skip-health
Você também pode omitir --auth-choice; passar --github-copilot-token infere a opção de autenticação do provedor GitHub Copilot. Se a flag for omitida, a integração 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 respaldado por env em vez de texto simples em auth-profiles.json.
O fluxo de login por dispositivo requer uma TTY interativa. Execute-o diretamente em um terminal, não em um script não interativo ou pipeline de CI.
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-4.1).
Depois que o caminho de autenticação por login de dispositivo (ou env-var) resolver um token do GitHub, o OpenClaw atualiza o catálogo de modelos sob demanda a partir de ${baseUrl}/models (o mesmo endpoint que o VS Code Copilot usa), de modo que o runtime acompanhe a autorização 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 depender inteiramente do catálogo de manifesto estático (cenários offline / isolados da rede):
{
  plugins: {
    entries: {
      "github-copilot": {
        config: { discovery: { enabled: false } },
      },
    },
  },
}
IDs de modelo Claude usam automaticamente o transporte Anthropic Messages. Modelos GPT, o-series e Gemini mantêm o transporte OpenAI Responses. O OpenClaw seleciona o transporte correto com base na ref do modelo.
O OpenClaw envia cabeçalhos de solicitação no estilo da IDE do Copilot nos transportes do Copilot, incluindo turnos integrados de Compaction, resultado de ferramenta e acompanhamento de imagem. Ele não habilita continuação de Responses no nível do provedor para o Copilot, a menos que esse comportamento tenha sido verificado com a API do Copilot.
O OpenClaw resolve a autenticação do Copilot a partir de variáveis de ambiente na seguinte ordem de prioridade:
PrioridadeVariávelObservações
1COPILOT_GITHUB_TOKENMaior prioridade, específica do Copilot
2GH_TOKENToken da GitHub CLI (fallback)
3GITHUB_TOKENToken padrão do GitHub (menor prioridade)
Quando várias variáveis estão definidas, o OpenClaw usa a de maior prioridade. O fluxo de login por dispositivo (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.
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.
O comando de login por dispositivo requer uma TTY interativa. Use a integração não interativa quando precisar de configuração sem interface.

​
Embeddings de busca de memória

O GitHub Copilot também pode servir como provedor de embeddings para busca de memória. Se você tem uma assinatura do Copilot e fez login, o OpenClaw pode usá-lo para embeddings sem uma chave de API separada.

​
Detecção automática

Quando memorySearch.provider é "auto" (o padrão), o GitHub Copilot é tentado na prioridade 15 — após embeddings locais, mas antes da OpenAI e outros provedores pagos. Se um token do GitHub estiver disponível, o OpenClaw descobre modelos de embeddings disponíveis a partir da API do Copilot e escolhe automaticamente o melhor.

​
Configuração explícita

{
  agents: {
    defaults: {
      memorySearch: {
        provider: "github-copilot",
        // Optional: override the auto-discovered model
        model: "text-embedding-3-small",
      },
    },
  },
}

​
Como funciona

  1. O OpenClaw resolve seu token do GitHub (a partir de env vars ou do perfil de autenticação).
  2. Troca-o por um token de API do Copilot de curta duração.
  3. Consulta o endpoint /models do Copilot para descobrir modelos de embeddings disponíveis.
  4. Escolhe o melhor modelo (prefere text-embedding-3-small).
  5. Envia solicitações de embedding para o endpoint /embeddings do Copilot.
A disponibilidade de modelos depende do seu plano do GitHub. Se nenhum modelo de embedding estiver disponível, o OpenClaw ignora o Copilot e tenta o próximo provedor.

​
Relacionados

Model selection

Escolher provedores, refs de modelo e comportamento de failover.

OAuth and auth

Detalhes de autenticação e regras de reutilização de credenciais.