GitHub Copilot

GitHub Copilot es el asistente de programación con IA de GitHub. Proporciona acceso a los modelos de Copilot para su cuenta y plan de GitHub. OpenClaw puede usar Copilot como proveedor de modelos o entorno de ejecución de agentes de tres maneras diferentes.

Tres maneras de usar Copilot en OpenClaw

Proveedor integrado (github-copilot)
Plugin de arnés del SDK de Copilot (copilot)
Plugin Copilot Proxy (copilot-proxy)

Use el flujo nativo de inicio de sesión mediante dispositivo para obtener un token de GitHub y, después, intercambiarlo por tokens de la API de Copilot cuando se ejecute OpenClaw. Esta es la ruta predeterminada y más sencilla porque no requiere VS Code.

Ejecutar el comando de inicio de sesión

openclaw models auth login-github-copilot

Se le pedirá que visite una URL e introduzca un código de un solo uso. Mantenga la terminal abierta hasta que finalice.

Establecer un modelo predeterminado

openclaw models set github-copilot/claude-opus-4.7

O en la configuración:

{
  agents: {
    defaults: { model: { primary: "github-copilot/claude-opus-4.7" } },
  },
}

Instale el plugin externo @openclaw/copilot cuando quiera que la CLI y el SDK de Copilot de GitHub controlen el bucle de agente de bajo nivel para los modelos github-copilot/* seleccionados.

openclaw plugins install @openclaw/copilot

Después, habilite el entorno de ejecución para un modelo o proveedor:

{
  agents: {
    defaults: {
      model: "github-copilot/gpt-5.5",
      models: {
        "github-copilot/gpt-5.5": {
          agentRuntime: { id: "copilot" },
        },
      },
    },
  },
}

Elija esta opción cuando quiera sesiones nativas de la CLI de Copilot, estado de hilos gestionado por el SDK y Compaction controlada por Copilot para esos turnos del agente. Sin la habilitación explícita agentRuntime, los modelos github-copilot/* siguen usando el proveedor integrado. Consulte Arnés del SDK de Copilot para ver el contrato completo del entorno de ejecución.

Use la extensión Copilot Proxy de VS Code como puente local. OpenClaw se comunica con el punto de conexión /v1 del proxy (valor predeterminado: http://localhost:3000/v1) y usa la lista de modelos que configure.El plugin copilot-proxy se distribuye con OpenClaw y está habilitado de forma predeterminada. Configure la URL base y los identificadores de modelo con:

openclaw models auth login --provider copilot-proxy --set-default

Elija esta opción si ya ejecuta Copilot Proxy en VS Code o necesita enrutar las solicitudes a través de él. La extensión de VS Code debe permanecer en ejecución.

GitHub Enterprise (residencia de datos)

Si su organización usa un inquilino de GitHub Enterprise con residencia de datos (un host *.ghe.com como your-org.ghe.com), Copilot se aloja en puntos de conexión locales del inquilino en lugar de en el github.com público. OpenClaw ofrece esta opción de autenticación directamente para que no tenga que editar las URL manualmente.

Elegir la opción de autenticación Enterprise

Durante la incorporación o en openclaw models auth, elija GitHub Copilot (Enterprise / data residency). Se le solicitará el dominio de Enterprise (por ejemplo, your-org.ghe.com) y, después, el inicio de sesión mediante dispositivo se ejecutará en ese inquilino.Introduzca únicamente la raíz del inquilino (your-org.ghe.com). No se aceptan hosts de servicio derivados, como api.your-org.ghe.com o copilot-api.your-org.ghe.com; OpenClaw obtiene automáticamente esos puntos de conexión a partir de la raíz del inquilino.

openclaw models auth login --provider github-copilot --method device-enterprise

El dominio se conserva en la configuración

El host elegido se almacena en los parámetros del proveedor para que las posteriores renovaciones de tokens y solicitudes de completado se dirijan automáticamente al inquilino:

{
  models: {
    providers: {
      "github-copilot": { params: { githubDomain: "your-org.ghe.com" } },
    },
  },
}

El flujo mediante dispositivo, el intercambio de tokens y las solicitudes de completado se resuelven respectivamente en https://your-org.ghe.com/login/device/code, https://api.your-org.ghe.com/copilot_internal/v2/token y https://copilot-api.your-org.ghe.com. Los tokens de residencia de datos contienen una marca del inquilino y ninguna indicación de proxy, por lo que la URL base de completado usa como alternativa el host de Copilot del inquilino en lugar del punto de conexión público.

Al cambiar de dominio, siempre se vuelve a ejecutar el inicio de sesión mediante dispositivo. Si ya tiene almacenado un token de Copilot y elige un dominio diferente (github.com público ↔ un inquilino *.ghe.com, o de un inquilino a otro), OpenClaw no reutilizará el token existente: obligará a iniciar sesión de nuevo para que el token quede limitado al dominio que se escribirá en la configuración. Al repetir el inicio de sesión para el mismo dominio, se sigue ofreciendo reutilizar el token actual. Al volver al github.com público, se elimina el githubDomain conservado para que la configuración vuelva al valor predeterminado.

La variable de entorno COPILOT_GITHUB_DOMAIN sustituye el dominio resuelto en todas las rutas de Copilot que lo resuelven: el inicio de sesión mediante dispositivo de Enterprise (--method device-enterprise), el acceso directo independiente openclaw models auth login-github-copilot, la renovación de tokens, las incrustaciones y las solicitudes de completado. Establézcala en su host *.ghe.com para configuraciones completamente desatendidas o de CI. Déjela sin definir (y sin el parámetro de configuración) para usar el github.com público. Los inicios de sesión conservan el dominio para el que emitieron el token (y lo eliminan al iniciar sesión en el github.com público), por lo que el enrutamiento sigue siendo correcto incluso después de eliminar la variable de entorno.

Indicadores opcionales

Comando	Indicador	Descripción
`openclaw models auth login-github-copilot`	`--yes`	Sobrescribe un perfil de autenticación existente sin preguntar
`openclaw models auth login --provider github-copilot --method device`	`--set-default`	También aplica el modelo predeterminado recomendado por el proveedor

# Omitir la confirmación para volver a iniciar sesión
openclaw models auth login-github-copilot --yes

# Iniciar sesión y establecer el modelo predeterminado en un solo paso
openclaw models auth login --provider github-copilot --method device --set-default

Incorporación no interactiva

El flujo de inicio de sesión mediante dispositivo requiere una TTY interactiva. Para una configuración desatendida, importe un token de acceso OAuth de GitHub existente con openclaw onboard --non-interactive:

openclaw onboard --non-interactive --accept-risk \
  --auth-choice github-copilot \
  --github-copilot-token "$COPILOT_GITHUB_TOKEN" \
  --skip-channels --skip-health

También puede omitir --auth-choice; proporcionar --github-copilot-token permite inferir la opción de autenticación del proveedor GitHub Copilot. Si se omite el indicador, la incorporación recurre sucesivamente a COPILOT_GITHUB_TOKEN, GH_TOKEN y GITHUB_TOKEN. Use --secret-input-mode ref con COPILOT_GITHUB_TOKEN definido para almacenar un tokenRef respaldado por una variable de entorno en lugar de texto sin formato en auth-profiles.json.

Se requiere una TTY interactiva

El flujo de inicio de sesión mediante dispositivo requiere una TTY interactiva. Ejecútelo directamente en una terminal, no en un script no interactivo ni en un Pipeline de CI.

La disponibilidad de los modelos depende de su plan

La disponibilidad de los modelos de Copilot depende de su plan de GitHub. Si se rechaza un modelo, pruebe otro identificador (por ejemplo, github-copilot/gpt-5.5). Consulte los modelos compatibles por plan de Copilot de GitHub para ver la lista actual de modelos.

Actualización en vivo del catálogo desde la API de Copilot

Una vez que la ruta de autenticación mediante inicio de sesión en dispositivo (o variable de entorno) ha resuelto un token de GitHub, OpenClaw actualiza el catálogo de modelos bajo demanda desde ${baseUrl}/models (el mismo punto de conexión que usa Copilot para VS Code), de modo que el entorno de ejecución siga los derechos de cada cuenta y las ventanas de contexto exactas sin cambios continuos en el manifiesto. Los modelos de Copilot recién publicados se hacen visibles sin actualizar OpenClaw, y las ventanas de contexto reflejan los límites reales de cada modelo (por ejemplo, 400k para la serie gpt-5.x y 1M para las variantes internas claude-opus-*-1m).El catálogo estático incluido permanece como alternativa visible cuando la detección está deshabilitada, el usuario no tiene un perfil de autenticación de GitHub, falla el intercambio de tokens o se produce un error en la llamada HTTPS /models. Para desactivar esta función y depender por completo del catálogo estático del manifiesto (escenarios sin conexión o con aislamiento de red):

{
  plugins: {
    entries: {
      "github-copilot": {
        config: { discovery: { enabled: false } },
      },
    },
  },
}

Selección del transporte

Los identificadores de modelos Claude usan automáticamente el transporte Anthropic Messages. Los modelos Gemini usan el transporte OpenAI Chat Completions; los modelos GPT y de la serie o mantienen el transporte OpenAI Responses. OpenClaw selecciona el transporte correcto según la referencia del modelo.

Compatibilidad de las solicitudes

OpenClaw envía encabezados de solicitud al estilo del IDE de Copilot en los transportes de Copilot (versiones del editor/plugin de VS Code y el identificador de integración vscode-chat), marca como iniciados por el agente los turnos de seguimiento de resultados de herramientas y establece el encabezado de visión de Copilot cuando un turno contiene una imagen de entrada.

Orden de resolución de las variables de entorno

OpenClaw resuelve la autenticación de Copilot a partir de las variables de entorno en el siguiente orden de prioridad:

Prioridad	Variable	Notas
1	`COPILOT_GITHUB_TOKEN`	Máxima prioridad, específica de Copilot
2	`GH_TOKEN`	Token de la CLI de GitHub (alternativa)
3	`GITHUB_TOKEN`	Token estándar de GitHub (mínima prioridad)

Cuando hay varias variables definidas, OpenClaw usa la de mayor prioridad. El flujo de inicio de sesión mediante dispositivo (openclaw models auth login-github-copilot) almacena su token en el almacén de perfiles de autenticación y tiene prioridad sobre todas las variables de entorno.

Almacenamiento de tokens

El inicio de sesión almacena un token de GitHub en el almacén de perfiles de autenticación (identificador de perfil github-copilot:github) y lo intercambia por un token de corta duración de la API de Copilot cuando se ejecuta OpenClaw. No es necesario gestionar el token manualmente.

Incrustaciones para la búsqueda en memoria

GitHub Copilot también puede funcionar como proveedor de incrustaciones para la búsqueda en memoria. Si tiene una suscripción a Copilot y ha iniciado sesión, OpenClaw puede usarlo para generar incrustaciones sin una clave de API independiente.

Configuración

Establezca memory.search.provider explícitamente para usar las incrustaciones de GitHub Copilot. Si hay un token de GitHub disponible, OpenClaw detecta los modelos de incrustación disponibles en la API de Copilot y elige automáticamente el mejor.

{
  memory: {
    search: {
      provider: "github-copilot",
      // Opcional: sustituir el modelo detectado automáticamente
      model: "text-embedding-3-small",
    },
  },
}

Funcionamiento

OpenClaw resuelve su token de GitHub (desde variables de entorno o el perfil de autenticación).
Lo intercambia por un token de corta duración de la API de Copilot.
Consulta el punto de conexión /models de Copilot para detectar los modelos de incrustación disponibles.
Elige el mejor modelo (orden de preferencia: text-embedding-3-small, text-embedding-3-large, text-embedding-ada-002).
Envía las solicitudes de incrustación al punto de conexión /embeddings de Copilot.

La disponibilidad de los modelos depende de su plan de GitHub. Si no hay modelos de incrustación disponibles, OpenClaw omite Copilot y prueba el siguiente proveedor.

Contenido relacionado

Selección de modelos

Elección de proveedores, referencias de modelos y comportamiento de conmutación por error.

OAuth y autenticación

Detalles de autenticación y reglas de reutilización de credenciales.

Overview

Concepts and configuration

Providers

Tres maneras de usar Copilot en OpenClaw

GitHub Enterprise (residencia de datos)

Indicadores opcionales

Incorporación no interactiva

Incrustaciones para la búsqueda en memoria

Configuración

Funcionamiento

Contenido relacionado

Selección de modelos

OAuth y autenticación

​Tres maneras de usar Copilot en OpenClaw

​GitHub Enterprise (residencia de datos)

​Indicadores opcionales

​Incorporación no interactiva

​Incrustaciones para la búsqueda en memoria

​Configuración

​Funcionamiento

​Contenido relacionado

Selección de modelos

OAuth y autenticación

Tres maneras de usar Copilot en OpenClaw

GitHub Enterprise (residencia de datos)

Indicadores opcionales

Incorporación no interactiva

Incrustaciones para la búsqueda en memoria

Configuración

Funcionamiento

Contenido relacionado