OpenAB Kiro

OpenAB es un arnés ligero de código abierto en Rust que conecta Discord con cualquier CLI de coding compatible con Agent Client Protocol a través de stdio JSON-RPC.

Esta plantilla despliega la variante Kiro, usando la imagen base openab con kiro-cli como backend de agente.

Notas Importantes

• Etiqueta de imagen: Esta plantilla usa una versión fijada (0.8.1-beta.5). Para actualizar, cambie la etiqueta de imagen en Zeabur Dashboard → Servicio → Configuración. Etiquetas disponibles: GitHub Packages.
• Almacenamiento persistente: /home/agent está montado como volumen persistente. Plugins, configuración y credenciales se conservan entre reinicios.
• Permisos de archivos: El contenedor inicia como root y cambia al usuario agent (uid 1000) antes de ejecutar openab. Si encuentra problemas de permisos, reinicie el servicio — los permisos se corrigen automáticamente al arrancar.

Configuración

1. Obtener el Discord Bot Token

1. Ir a https://discord.com/developers/applications y hacer clic en New Application
2. Ir a la pestaña Bot → clic en Reset Token → copiar el token
3. En la misma página, bajar y habilitar Message Content Intent en Privileged Gateway Intents
4. Ir a OAuth2 → URL Generator → marcar scope bot → marcar permisos: Send Messages, Send Messages in Threads, Create Public Threads, Read Message History, Add Reactions, Manage Messages
5. Copiar la URL generada y abrirla en el navegador para invitar al Bot al servidor

2. Obtener IDs de canales de Discord

1. Abrir Discord → Ajustes de usuario (icono de engranaje) → Avanzado → activar Modo desarrollador
2. Clic derecho en el canal donde quieres que el Bot responda → Copiar ID del canal
3. Para múltiples canales, separar con comas: 123456789012345678,234567890123456789

3. Obtener una Kiro API Key (solo plan Pro/Pro+/Power)

Si tienes una suscripción de pago de Kiro, ve a kiro.dev → Settings → API Keys, crea una key y pégala en la variable KIRO_API_KEY. El servicio se autenticará automáticamente sin pasos post-despliegue.

Los usuarios del plan gratuito pueden dejar KIRO_API_KEY vacío y autenticarse después del despliegue en el paso 5.

4. Desplegar

Completa las variables y haz clic en desplegar. El servicio se conecta a Discord automáticamente.

5. Autenticar Kiro con Device Flow (solo plan gratuito)

Omite este paso si configuraste KIRO_API_KEY en el paso 3.

Después de que el servicio esté ejecutándose, abre la terminal del servicio en Zeabur Dashboard y ejecuta:

HOME=/home/agent kiro-cli login --use-device-flow

⚠️ Debe ejecutarse como agent. Ejecutar como root escribe las credenciales en /root/, que no es persistente y se perderán al reiniciar.

Sigue la URL y el código en pantalla para completar la autorización en tu navegador. Reinicia el servicio después de completar el login.

Configuración de Slack (Opcional)

OpenAB soporta Slack mediante Socket Mode — no se necesita URL pública.

1. Ir a https://api.slack.com/apps → Create New App → From scratch
2. Socket Mode → Habilitar → generar App-Level Token con scope connections:write → copiar el token xapp-... (SLACK_APP_TOKEN)
3. Event Subscriptions → Habilitar → añadir bot events: app_mention, message.channels, message.groups
4. OAuth & Permissions → Bot Token Scopes → añadir: app_mentions:read, chat:write, channels:history, groups:history, channels:read, groups:read, reactions:write, files:read, users:read
5. Install App → Instalar en el workspace → copiar el token xoxb-... (SLACK_BOT_TOKEN)
6. En cada canal de Slack donde quieras usar el bot, ejecuta /invite @YourAppName

Rellena SLACK_BOT_TOKEN y SLACK_APP_TOKEN antes de desplegar. Discord y Slack pueden funcionar simultáneamente.

Uso

• @mencionar al bot en un canal de Discord o Slack permitido para iniciar una conversación
• OpenAB crea un thread para conversaciones de múltiples turnos — no se necesita @mención en los mensajes siguientes
• Cada thread corresponde a una sesión persistente de Kiro (TTL de 24h por defecto)

Personalización

Archivo	Descripción
/home/agent/.config/openab/config.toml	Configuración de OpenAB (sessions, reactions, STT, etc.)

config.toml se crea a partir de una plantilla integrada en el primer arranque. Después, edite el archivo directamente — las variables de entorno solo se usan para la configuración inicial. Para restablecer los valores predeterminados, elimine y reinicie: rm /home/agent/.config/openab/config.toml

Para opciones de configuración, consulte la documentación de OpenAB.

Desactivar

Dejar Discord Bot Token vacío al desplegar. El servicio entrará en modo sleep sin fallar.

Enlaces

• OpenAB GitHub
• Agent Client Protocol