Entorno de pruebas del SDK de Copilot

​

Requisitos

• OpenClaw con el plugin @openclaw/copilot instalado.
• Si tu configuración usa plugins.allow, incluye copilot (el id de manifiesto que declara el plugin). Una entrada de allowlist para el nombre del paquete npm @openclaw/copilot no coincidirá y dejará el plugin bloqueado, incluso con agentRuntime.id: "copilot" definido.
• Una suscripción de GitHub Copilot que pueda controlar la CLI de Copilot, o una variable de entorno gitHubToken / entrada de perfil de autenticación para ejecuciones sin interfaz o de cron.
• Un directorio copilotHome con permisos de escritura. El valor predeterminado es <agentDir>/copilot cuando OpenClaw proporciona un directorio de agente; de lo contrario, ~/.openclaw/agents/<agentId>/copilot.

​

Instalación

openclaw plugins install @openclaw/copilot

1. import("@github/copilot-sdk") desde el paquete @openclaw/copilot instalado.
2. El directorio de respaldo ~/.openclaw/npm-runtime/copilot/ (destino heredado de instalación bajo demanda).

​

Inicio rápido

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

​

Proveedores compatibles

• anthropic-messages
• azure-openai-responses
• ollama (completions compatibles con OpenAI)
• openai-completions
• openai-responses

​

BYOK

{
  agents: {
    defaults: {
      model: "custom-proxy/llama-3.1-8b",
      models: {
        "custom-proxy/llama-3.1-8b": {
          agentRuntime: { id: "copilot" },
        },
      },
    },
  },
  models: {
    mode: "merge",
    providers: {
      "custom-proxy": {
        baseUrl: "https://api.example.com/v1",
        apiKey: "${CUSTOM_PROXY_API_KEY}",
        api: "openai-responses",
        authHeader: true,
        models: [{ id: "llama-3.1-8b", name: "Llama 3.1 8B" }],
      },
    },
  },
}

​

Autenticación

1. useLoggedInUser: true explícito en la entrada del intento: usa el usuario con sesión iniciada de la CLI de Copilot bajo el copilotHome del agente.
2. gitHubToken explícito en la entrada del intento (requiere profileId + profileVersion). Para invocaciones directas de CLI y pruebas que necesitan omitir la resolución de perfiles de autenticación.
3. resolvedApiKey + authProfileId resueltos por contrato: la ruta principal de producción. El núcleo resuelve el perfil de autenticación github-copilot configurado para el agente (src/infra/provider-usage.auth.ts:resolveProviderAuths) antes de invocar el arnés, por lo que un perfil de autenticación github-copilot:<profile> funciona de extremo a extremo para configuraciones sin interfaz, cron o con múltiples perfiles sin variables de entorno.
4. Respaldo de variables de entorno, comprobadas en este orden (gana el primer valor no vacío; las cadenas vacías cuentan como ausentes; refleja la precedencia enviada del proveedor github-copilot en extensions/github-copilot/auth.ts):
   1. OPENCLAW_GITHUB_TOKEN: anulación específica del arnés; te permite fijar un token para el arnés de OpenClaw sin alterar la configuración global de gh / la CLI de Copilot.
   2. COPILOT_GITHUB_TOKEN: variable de entorno estándar del SDK / CLI de Copilot.
   3. GH_TOKEN: variable de entorno estándar de la CLI gh.
   4. GITHUB_TOKEN: respaldo genérico de token de GitHub.
   El id de perfil de grupo sintetizado es env:<NAME>; la versión del perfil es una huella sha256 no reversible del token, por lo que rotar el valor de entorno invalida limpiamente el grupo de clientes.
5. useLoggedInUser predeterminado cuando no hay ninguna señal de token disponible.

​

Superficie de configuración

​

Compaction

1. Reanuda la sesión del SDK rastreada sin continuar trabajo pendiente.
2. Llama a la RPC de compaction de historial con ámbito de sesión del SDK.
3. Devuelve el resultado de compaction del SDK sin escribir archivos marcadores de compatibilidad bajo el espacio de trabajo.

​

Espejo de transcripción

​

Preguntas secundarias (/btw)

​

Doctor

• Un legacyConfigRules vacío (todavía no hay campos retirados).
• Un normalizeCompatibilityConfig sin operación (conservado para que futuras retiradas de campos tengan un lugar estable dentro del árbol).
• Una entrada sessionRouteStateOwners: proveedor github-copilot, runtime copilot, clave de sesión de CLI copilot, prefijo de perfil de autenticación github-copilot:.

​

Limitaciones

• El harness reclama github-copilot más ids de proveedor BYOK personalizados sin propietario. Los ids de proveedor nativo propiedad del manifiesto permanecen en su runtime propietario incluso cuando agentRuntime.id se fuerza a copilot.
• Sin superficie TUI; la TUI de PI sigue siendo la alternativa para runtimes sin una superficie equivalente.
• El estado de sesión de PI no migra cuando un agente cambia a copilot. La selección es por intento; las sesiones de PI existentes siguen siendo válidas.
• ask_user usa la misma ruta de prompt y respuesta de OpenClaw que el harness de Codex: cuando el SDK de Copilot solicita entrada del usuario, OpenClaw publica un prompt bloqueante en el canal/TUI activo, y el siguiente mensaje de usuario en cola resuelve la solicitud del SDK.

​

Permisos y ask_user

• overridesBuiltInTool: true — reemplaza la herramienta integrada de Copilot CLI con el mismo nombre (edit, read, write, bash, …) para que cada llamada de herramienta vuelva a enrutarse a OpenClaw.
• skipPermission: true — indica al SDK que no dispare onPermissionRequest({kind: "custom-tool"}) antes de invocar la herramienta. El execute() envuelto ya realiza la comprobación de políticas más completa de OpenClaw; un prompt a nivel de SDK acortaría la aplicación de OpenClaw (permitir todo) o bloquearía cada llamada de herramienta (rechazar todo), y ninguno de los dos coincide con la paridad con PI.

​

Token de GitHub a nivel de sesión

​

Relacionado

• Runtimes de agente
• Harness de Codex
• Plugins de harness de agente (referencia del SDK)