Providers
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)
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-copilotSe 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.7O en la configuración:
{ agents: { defaults: { model: { primary: "github-copilot/claude-opus-4.7" } }, },}Plugin de arnés del SDK de Copilot (copilot)
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/copilotDespué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.
Plugin Copilot Proxy (copilot-proxy)
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-defaultGitHub 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-enterpriseEl 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.
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ónopenclaw models auth login-github-copilot --yes # Iniciar sesión y establecer el modelo predeterminado en un solo pasoopenclaw models auth login --provider github-copilot --method device --set-defaultIncorporació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-healthTambié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
/modelsde 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
/embeddingsde 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.
