OpenAB Copilot

Esta plantilla despliega la variante Copilot (openab-copilot) de OpenAB, usando GitHub Copilot CLI como backend de agente.

Notas Importantes

• Suscripción de pago requerida: Copilot CLI requiere un plan de pago (Pro, Pro+, Business o Enterprise). El plan Free no incluye acceso CLI/ACP.
• Public preview: El soporte ACP de Copilot CLI está en public preview desde enero de 2026.
• Autenticación después del despliegue: A diferencia de Claude/Codex, no hay variable de API key. Debe ejecutar gh auth login dentro del contenedor tras el primer despliegue.
• Etiqueta de imagen: Esta plantilla rastrea la etiqueta flotante stable. Para fijar una versión específica, cambie la etiqueta de imagen en Zeabur Dashboard → Servicio → Configuración.
• Almacenamiento persistente: /home/node está montado como volumen persistente e incluye las credenciales OAuth de GitHub.

Configuración

1. Obtener Discord Bot Token e invitar el bot

2. Desplegar la plantilla (el servicio dormirá hasta que Copilot esté autenticado)

3. En Zeabur Dashboard → Servicio → Exec, ejecutar:

   runuser -u node -- gh auth login --hostname github.com --git-protocol https -p https -w
   

4. Completar la autorización en el navegador y reiniciar el servicio

Añadir plataformas de mensajería (Telegram / LINE / Feishu / Google Chat / MS Teams)

Para conectar Telegram, LINE, Feishu/Lark, Google Chat o MS Teams, despliega la plantilla OpenAB Gateway en el mismo proyecto Zeabur. Luego añade estas variables de entorno a este servicio:

• GATEWAY_URL = ws://openab-gateway:8080/ws
• GATEWAY_PLATFORM = uno de telegram, line, feishu, googlechat, teams

Reinicia el servicio. El script de arranque inyecta automáticamente el bloque [gateway] en config.toml.

Uso

• @mencionar al bot en un canal permitido para iniciar una conversación
• OpenAB crea un thread para conversaciones multi-turno
• Copilot CLI usa Claude Sonnet 4.6 por defecto (no se puede cambiar en ACP)

Personalización

Archivo	Descripción
/home/node/.config/openab/config.toml	Configuración de OpenAB
/home/node/.config/gh/	Credenciales OAuth de GitHub

config.toml se crea a partir de una plantilla integrada en el primer arranque. Después, edite el archivo directamente. Para restablecer los valores predeterminados: rm /home/node/.config/openab/config.toml

Webhook / Bot Integration

Por defecto, openab ignora los mensajes de otros bots y webhooks. Para permitir mensajes activados por webhook (por ejemplo, pruebas automatizadas o pipelines de CI), añada lo siguiente a su config.toml:

[discord]
allow_bot_messages = "mentions"

Con esta configuración, openab responde a cualquier bot o webhook que lo @mencione. Para restringir a un webhook específico, añada también:

trusted_bot_ids = ["YOUR_WEBHOOK_USER_ID"]

El ID de usuario del webhook es el ID numérico en la URL del webhook: https://discord.com/api/webhooks/<ID>/...

Desactivar

Deje Discord Bot Token vacío. El servicio entra en modo sleep sin fallar.

Enlaces

• OpenAB GitHub
• GitHub Copilot CLI