Tres maneras de usar Copilot en OpenClaw
- Built-in provider (github-copilot)
- Copilot SDK harness plugin (copilot)
- Copilot Proxy plugin (copilot-proxy)
Usa el flujo nativo de inicio de sesión por dispositivo para obtener un token de GitHub y luego canjearlo por
tokens de la API de Copilot cuando OpenClaw se ejecuta. Esta es la ruta predeterminada y más sencilla
porque no requiere VS Code.
Banderas opcionales
| Comando | Bandera | 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 |
Incorporación no interactiva
El flujo de inicio de sesión por dispositivo requiere una TTY interactiva. Para una configuración sin interfaz, importa un token de acceso OAuth de GitHub existente conopenclaw onboard --non-interactive:
--auth-choice; pasar --github-copilot-token infiere la
opción de autenticación del proveedor GitHub Copilot. Si se omite la bandera, la incorporación
recurre a COPILOT_GITHUB_TOKEN, GH_TOKEN y luego GITHUB_TOKEN. Usa
--secret-input-mode ref con COPILOT_GITHUB_TOKEN configurado para almacenar un
tokenRef respaldado por variable de entorno en lugar de texto sin formato en auth-profiles.json.
Interactive TTY required
Interactive TTY required
El flujo de inicio de sesión por dispositivo requiere una TTY interactiva. Ejecútalo directamente en una
terminal, no en un script no interactivo ni en una canalización de CI.
Model availability depends on your plan
Model availability depends on your plan
La disponibilidad de modelos de Copilot depende de tu plan de GitHub. Si se rechaza un modelo,
prueba con otro ID (por ejemplo
github-copilot/gpt-5.5). Consulta
modelos compatibles por plan de Copilot
de GitHub para ver la lista actual de modelos.Live catalog refresh from the Copilot API
Live catalog refresh from the Copilot API
Una vez que la ruta de autenticación por inicio de sesión por 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 endpoint que usa VS Code Copilot), de modo que el runtime sigue
los derechos por cuenta y ventanas de contexto precisas sin rotación de manifiestos.
Los modelos de Copilot recién publicados se vuelven visibles sin actualizar OpenClaw,
y las ventanas de contexto reflejan los límites reales por modelo
(p. ej., 400k para la serie gpt-5.x, 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 perfil de autenticación de GitHub, el intercambio de token
falla o la llamada HTTPS a /models produce un error. Para excluirte y depender por completo
del catálogo de manifiesto estático (escenarios sin conexión / aislados de la red):Transport selection
Transport selection
Los IDs de modelo Claude usan automáticamente el transporte Anthropic Messages.
Los modelos Gemini usan el transporte OpenAI Chat Completions; los modelos GPT y o-series
mantienen el transporte OpenAI Responses. OpenClaw selecciona el transporte correcto
según la referencia de modelo.
Request compatibility
Request compatibility
OpenClaw envía encabezados de solicitud de estilo IDE de Copilot en los transportes de Copilot
(versiones del editor/plugin de VS Code y el id de integración
vscode-chat),
marca los turnos de seguimiento con resultado de herramienta como iniciados por el agente y configura el encabezado
de visión de Copilot cuando un turno lleva entrada de imagen.Environment variable resolution order
Environment variable resolution order
OpenClaw resuelve la autenticación de Copilot desde variables de entorno en el siguiente
orden de prioridad:
Cuando se configuran varias variables, OpenClaw usa la de mayor prioridad.
El flujo de inicio de sesión por dispositivo (
| Prioridad | Variable | Notas |
|---|---|---|
| 1 | COPILOT_GITHUB_TOKEN | Prioridad más alta, específica de Copilot |
| 2 | GH_TOKEN | Token de GitHub CLI (alternativa) |
| 3 | GITHUB_TOKEN | Token estándar de GitHub (más baja) |
openclaw models auth login-github-copilot) almacena
su token en el almacén de perfiles de autenticación y tiene precedencia sobre todas las variables
de entorno.Token storage
Token storage
El inicio de sesión almacena un token de GitHub en el almacén de perfiles de autenticación (id de perfil
github-copilot:github) y lo canjea por un token de API de Copilot de corta duración
cuando OpenClaw se ejecuta. No necesitas gestionar el token manualmente.Embeddings de búsqueda de memoria
GitHub Copilot también puede servir como proveedor de embeddings para búsqueda de memoria. Si tienes una suscripción a Copilot y has iniciado sesión, OpenClaw puede usarlo para embeddings sin una clave de API separada.Configuración
ConfiguramemorySearch.provider explícitamente para usar embeddings de GitHub Copilot. Si hay un
token de GitHub disponible, OpenClaw detecta los modelos de embedding disponibles desde
la API de Copilot y elige automáticamente el mejor.
Cómo funciona
- OpenClaw resuelve tu token de GitHub (desde variables de entorno o perfil de autenticación).
- Lo canjea por un token de API de Copilot de corta duración.
- Consulta el endpoint
/modelsde Copilot para detectar modelos de embedding disponibles. - Elige el mejor modelo (orden de preferencia:
text-embedding-3-small,text-embedding-3-large,text-embedding-ada-002). - Envía solicitudes de embedding al endpoint
/embeddingsde Copilot.
Relacionado
Model selection
Elegir proveedores, referencias de modelo y comportamiento de conmutación por error.
OAuth and auth
Detalles de autenticación y reglas de reutilización de credenciales.