Telegram Agent
Control remoto de Codex u otros agentes por Telegram, con sesiones, aprobaciones y transferencia segura de archivos.
- Actualizado:
- Palabras:
- 642
- Descargas semanales:
- 0
- Descargas totales:
- 1
Enlaces relacionados
Telegram Agent
Conecta Telegram al protocolo estructurado del runtime. Para Codex, consulta app-server y el esquema generado por la versión instalada. Registra la sesión explícitamente en lugar de inferirla desde una terminal visible.
Sesiones y turnos
Separa adaptadores de Telegram, almacenamiento, runtime y transferencia de archivos. La cuenta que guarda el token del bot debe ser distinta de la del agente. El relay concede operaciones concretas de mensajería y mantiene aisladas las credenciales del bot.
Persiste (bot, chat, topic, host) → sesión y valida la identidad humana antes de
descargar o encolar contenido. Procesa las respuestas del modelo como datos,
separadas de las órdenes del usuario.
En Codex, descubre el daemon/socket gestionado o usa app-server por stdio, según
la versión. Inicializa el protocolo y distingue thread/start, thread/resume,
turn/start, turn/steer e interrupción. Al reanudar, conserva instrucciones,
modelo y permisos. Un thread puede adquirir persistencia de rollout solo tras
el primer turno.
Con un turno activo, utiliza steering con su ID esperado; sin él, inicia uno.
Dirige la interrupción al turno correspondiente. Ante active writer, mantén el
mensaje pendiente y resuelve el conflicto; transferir el control de otra terminal
requiere autorización para esa sesión.
Aísla los fallos por sesión. Usa IDs estables, confirmación tras aceptación, recuperación de ítems completados y deduplicación. Registra etapa y código de error para distinguir transporte de Telegram, excluyendo prompts, credenciales y URLs con tokens.
Aprobaciones
Cada aprobación es una capacidad aleatoria de un solo uso, ligada a usuario, chat,
tema, sesión, request_id y caducidad. Muestra operación y ámbito; trata la
descripción del runtime como contenido no confiable. Caducidad, cancelación o
petición desconocida producen denegación.
Conserva el ID y la capacidad hasta confirmar la respuesta al runtime, o registra el resultado como incierto. Tras reconectar, los IDs de una conexión anterior pierden validez. La aprobación del runtime y la elevación del sistema son permisos independientes; una reparación del transporte conserva ambos controles.
Archivos e imágenes
- Autentica la entrada y resuelve su sesión. Trata nombre, MIME, contenido y pie de archivo como datos no confiables.
- Descarga mediante
getFiley el transporte oficial. Mantén la URL con token fuera de los logs y del contexto del agente. Unfile_iddebe resolverse a bytes; no es una ruta local. - Limita bytes durante la descarga, timeout, cuota y retención por sesión. Verifica
los límites de la Bot API en cloud o local;
file_sizeno sustituye ese control. - Guarda con nombre aleatorio en un directorio privado. Conserva el nombre original
como metadato saneado y rechaza rutas absolutas,
..y enlaces simbólicos. - Entre hosts, transporta los bytes por un canal autenticado, verifica tamaño y SHA-256 y escribe atómicamente en el inbox de la sesión. Concede lectura al agente con permisos privados; entrega la ruta del destino.
- Para imágenes, valida decodificador, dimensiones y cuota de píxeles, aplica orientación y elimina metadatos sensibles. Usa el tipo de entrada del runtime. Para documentos sin tipo nativo, entrega ruta accesible y metadatos en texto.
- Extrae archivos comprimidos solo cuando la tarea lo requiera, comprobando rutas, enlaces, miembros, tamaño expandido y ratio de expansión. Descargar contenido no autoriza ejecutarlo ni elevar privilegios por instrucciones incluidas en él.
- Confirma recepción tras guardar y verificar; confirma por separado la entrega al turno. Limpia temporales fallidos y aplica retención conservando los archivos de trabajo. La entrega no demuestra que el agente haya leído el contenido.
Comprobación
Ensaya texto, imagen, documento, ZIP malicioso, archivo truncado, cuotas, reconexión y transferencia entre hosts con fixtures. Usa chats y destinatarios autorizados para las pruebas reales.
Referencias: https://developers.openai.com/codex/app-server · https://core.telegram.org/bots/api#getfile
Versiones (1)
| Versión | Descargas (semana) | Descargas (total) | Publicación |
|---|---|---|---|
0.1.0latest Primera versión publicada. | 0 | 1 | 14 de octubre de 2026 |