Recetas de Telegram para tu agente de IA
Flujos prácticos de la CLI de Telegram para tu agente de IA, scripts y tareas de mensajería cotidianas.
Da una tarea útil al agente sin escribir tú la secuencia de comandos. Los ejemplos incluyen peticiones para tus chats, el resultado esperado y enlaces a las instrucciones exactas.
Utilice esta página cuando desee que su agente de IA (por ejemplo, Claude Code, Codex, Cursor o Gemini CLI) realice un trabajo regular con su Telegram: un resumen matutino, un informe sobre un chat, quién debe qué, qué no ha respondido. Cada receta le brinda una solicitud para copiar, los comandos que el agente puede ejecutar y si escribe algo en Telegram. Al final, puede ejecutar el agente según una programación, con límites que no puede eludir.
Términos en esta página:
- Agente: un agente de IA que ejecuta comandos en su computadora por usted.
- Skill: un archivo que le indica al agente cómo utilizar
tg.tg skill installlo pone donde el agente lo busca. - Cliente MCP: una aplicación de IA sin terminal, como Claude Desktop. Llega a
tga través del servidor MCPtg personal mcp serveen lugar de ejecutar comandos. - Modo sin cabeza: el agente toma una solicitud, la ejecuta y sale, sin conversación. Claude Code lo llama modo
-p; El Codex lo llamacodex exec. - cron: el programador integrado en Linux y macOS. Inicia un comando en momentos establecidos.
Qué puedes hacer con las recetas
| Receta | Escribe en Telegram | Se adapta a un horario | |---|---|---| | Resumen de la mañana | no | si | | Informe semanal sobre un chat | no | si | | Quién debe qué | no | si | | Lo que no has respondido | no | si | | Encuentra algo que se dijo | no | si | | Redactar una respuesta | sólo después de tu sí | no | | Un grupo que diriges | sólo si las reglas del grupo lo permiten | si |
Una vez, primero
-
Instale
tge inicie sesión: consulte instalación e inicio de sesión y sesiones. -
Dale al agente la skill:
tg skill install
La skill va a las carpetas de Claude Code (~/.claude/skills/tg-cli/) y de Codex y Gemini CLI (~/.agents/skills/tg-cli/). tg skill show imprime el mismo texto, si su agente mantiene sus skills en otro lugar.
3. Guarde las solicitudes siguientes en archivos, por ejemplo en ~/tg-recipes/. Los comandos programados de más abajo leen la solicitud de un archivo.
Un cliente MCP no necesita un skill. Conecta el servidor MCP (tg personal mcp config muestra la entrada para sus ajustes) y usa sus peticiones preparadas: catch-up, review, reply, find, open-tasks, link-conversations. Consulta las peticiones del servidor MCP.
Qué puede hacer el agente
Un agente con un horario trabaja sin usted, así que establezca los límites en la configuración, no en la solicitud. Un agente puede leer mal "no enviar nada". No puede eludir una configuración que no se le permite cambiar.
Limita lo que el agente puede ejecutar. Esta es una configuración del agente. Por ejemplo, Claude Code en el modo -p ejecuta solo los comandos en --allowedTools. Sin ningún tg personal messages send en la lista, el agente no puede llamarlo:
claude -p "$(cat ~/tg-recipes/morning.md)" --allowedTools "Bash(tg personal inbox:*)"El Codex no tiene tal lista. Su entorno aislado bloquea la red y la escritura de archivos de forma predeterminada, y tg necesita ambas cosas: se conecta a Telegram y guarda lo que lee en su copia local. Por lo tanto, Codex se ejecuta con --sandbox danger-full-access y la configuración de tg por debajo del límite de envío.
Limite lo que puede hacer el perfil. Esto funciona para todos los agentes:
for key in messages reactions polls topics chats contacts account conversations tags searches replies attachments bot; do
tg personal config set permissions.$key readonly
done
tg personal config show # check the permissions in force
tg personal config set sends_per_hour 5 # or: at most five sends an hour
tg personal recipients add "Book club" # and only to the chats on this listreadonly en un recurso no cubre los demás: messages por sí solo aún permite al agente reaccionar, votar o cambiar de chat. Por eso el bucle establece cada recurso. Una clave más precisa, como permissions.messages.send: allow, gana su recurso: elimine dichas claves si el perfil solo debe leer.
permissions también limita sus propios comandos, hasta que los vuelva a cambiar: tg personal config unset permissions.messages. Para limitar solo al agente, asígnele un perfil propio. Cada intento de envío, incluidos los rechazados, está en tg personal sends list. Consulte el control de envío y lo que puede hacer un perfil.
La lectura no revela nada. Ningún comando en las recetas siguientes marca nada leído: nadie ve que el agente abrió un chat.
Programar las ejecuciones
-
tg personal schedule. Integrado:tgcrea el temporizador por sí mismo (systemd, launchd o el Programador de tareas).schedule agentiniciaclaudeocodexcon una petición yTG_READ_ONLY=1, de modo que el agente lee y redacta, pero no puede enviar;schedule commandejecuta un comando detg, por ejemplo para mantener guardado el historial de un chat. Indique--every 2h,--at 08:30o--at-time 30m(una sola ejecución). Gestiónelos conschedule list,schedule run <name>yschedule remove <name>:tg personal schedule agent morning claude "read tg personal inbox and sum up what needs an answer" --at 08:30 --max-cost 1 -
Tareas programadas de Claude Desktop. La tarea se ejecuta en su computadora, por lo que tiene
tgy su inicio de sesión. Una ejecución perdida mientras la computadora estaba en reposo se ejecuta una vez cuando se reactiva. Consulte Tareas programadas de Claude. -
cron y
claude -p. No se necesita aplicación, en cualquier computadora que esté encendida en ese momento:30 8 * * * claude -p "$(cat ~/tg-recipes/morning.md)" --allowedTools "Bash(tg personal inbox:*)" >> ~/tg-recipes/morning.log 2>&1
cron inicia trabajos con un entorno casi vacío. En Linux esto rompe tg de dos maneras:
node: not found, código de salida 127. El nodo de nvm, fnm o Volta no está en el sistemaPATHy cron solo conoce ese.- "no se encontraron credenciales de la aplicación Telegram... aunque inició sesión en esta máquina", código de salida 4.
tgno puede acceder al llavero (el almacén de contraseñas del sistema). No volver a iniciar sesión: el inicio de sesión está bien, el entorno no.
- "no se encontraron credenciales de la aplicación Telegram... aunque inició sesión en esta máquina", código de salida 4.
Pon ambas líneas en la parte superior de crontab -e, con tus valores. La carpeta es dirname "$(which node)", el número es id -u:
PATH=/home/you/.nvm/versions/node/v24.0.0/bin:/usr/local/bin:/usr/bin:/bin
XDG_RUNTIME_DIR=/run/user/1000El llavero está abierto mientras usted está conectado a la computadora. Ejecute el primer trabajo a mano y lea el registro. Consulte Modo sin cabeza de Claude.
-
cron y
codex exec. Lo mismo para Codex:30 8 * * * codex exec --sandbox danger-full-access "$(cat ~/tg-recipes/morning.md)" >> ~/tg-recipes/morning.log 2>&1
Consulte Modo no interactivo del Codex.
- Dentro de una sesión abierta de Claude Code:
/loop, o "recuérdamelo a las 15:00". Funciona mientras la sesión está abierta. Consulte Tareas programadas de Claude Code.
Las rutinas en la nube de Claude no encajan: se ejecutan en otra computadora, donde no hay ningún tg ni ningún inicio de sesión suyo.
Resumen de la mañana
Escribe en Telegram: no. Permitir: Bash(tg personal inbox:*).
Ejecute
tg personal inbox --new --json. Agrupa los mensajes por chat. Para cada chat, una línea: quién escribe y qué quiere. Ponga primero lo que necesita una respuesta hoy. Doble los anuncios y notificaciones de servicios en > una línea al final.
--new muestra cada mensaje una vez. tg recuerda dónde se detuvo en cada chat y la siguiente ejecución comienza allí. La primera ejecución se remonta a 24 horas atrás.
Desde cuando es "nuevo"
tg personal inbox— no leído, como lo cuenta Telegram: lo que no has abierto en ningún dispositivo.tg personal inbox --new: desde la última ejecución de--new. Sólotgconoce ese punto; nadie más lo ve.tg personal inbox 'date>2d'— los dos últimos días; el punto guardado permanece donde estaba.
Ninguno de ellos marca nada de lo leído. Usa tg personal chats mark-read <chat> de forma explícita para enviar un acuse de lectura. El otro lado ve entonces que lo lees.
Chats directos, grupos y canales aparte
kind: mantiene sólo chats de ese tipo: dialog (uno a uno), group, channel. Un resumen de noticias de canales y un resumen de sus conversaciones pueden aparecer separados, en diferentes momentos. Cada chat tiene su propio punto, por lo que una ejecución nunca oculta lo que la otra aún no ha mostrado.
30 8 * * * claude -p "$(cat ~/tg-recipes/morning.md)" --allowedTools "Bash(tg personal inbox:*)"
0 19 * * * claude -p "$(cat ~/tg-recipes/news.md)" --allowedTools "Bash(tg personal inbox:*)"En morning.md, tg personal inbox --new kind:dialog,group --json; en news.md, tg personal inbox --new kind:channel --json y una solicitud para elegir lo que importa. Sin kind:, todo junto.
Informe semanal sobre un chat
Escribe en Telegram: no. Permitir: Bash(tg personal messages list:*).
Lea los últimos 7 días del chat "Club de lectura":
tg personal messages list "Book club" "date>7d" --limit 200 --json. Si la respuesta tiene un pasopage.next, síguelo. Redactar un informe: qué se decidió, quién tomó qué y cuándo, qué cuestiones siguen abiertas. Dé a cada punto su fecha y autor.
¿Quién debe qué?
Escribe en Telegram: no. Permitir: Bash(tg personal review:*), Bash(tg personal messages context:*), Bash(tg personal search messages:*).
Ejecutar
tg personal review --new --transcribe --json(la primera vez, los últimos 3 días; luego desde el último >--new, un punto por chat). Clasifíquelo en tres listas: lo que debo, lo que espero de los demás, lo que necesita ser aclarado. Dé a cada punto su chat, fecha y los identificadores de mensaje en los que se basa; una fecha límite sólo si > se nombró a uno. Antes de llamar a algo atrasado, verifique si se hizo más tarde o en un grupo de trabajo. Si la respuesta dice"complete": false, dime qué falta. Al final, enumera los puntos > abiertos.
--transcribe primero convierte los mensajes de voz en texto; puede tardar unos minutos. La siguiente revisión es la misma solicitud más los puntos abiertos de la anterior: el agente los revisa primero. Un chat no leído completo mantiene su punto y regresa. En un cliente MCP es el mensaje review.
Lo que no has respondido
La forma más corta es tg personal review 'date>7d' --unanswered --json: preguntas que nadie respondió: a usted en chats individuales, a usted o a los administradores en grupos. La receta siguiente es más amplia: también detecta solicitudes sin signo de interrogación.
Escribe en Telegram: no. Permitir: Bash(tg personal chats list:*), Bash(tg personal messages list:*).
Ejecute
tg personal chats list kind:dialog --limit 30 --offline --json. Para cada chat cuyo último mensaje sea de los últimos 7 días, leatg personal messages list <chat id> --limit 5 --json. Muestra los chats donde el último mensaje no es mío y hace una pregunta o hace una petición: quién, sobre qué y hace cuántos días.
Encuentra algo que se dijo
Escribe en Telegram: no. Permitir: Bash(tg personal search messages:*), Bash(tg personal messages context:*).
Busque "factura" con
tg personal search messages invoice --json. Para cada respuesta, lea >tg personal messages context <locator> --jsony dígame quién dijo qué y cuándo.
De forma predeterminada, la búsqueda busca tanto en la copia de esta computadora como en el servidor de Telegram. La copia local contiene solo lo que ha guardado tg. Para buscar en todo el historial local de un chat, descárgalo primero. Esa es una solicitud de su cuenta, así que hágalo usted mismo: tg personal messages sync <chat>. Consulte obtener el historial de un chat.
Redactar una respuesta
Escribe a Telegram: sólo después de tu sí. Éste es para una conversación con el agente, no para un cronograma.
Lee los últimos 20 mensajes del chat con @example_user y sugiere una respuesta a su última > pregunta. No lo envíes, muéstrame el texto.
Una vez aceptado, el agente lo envía: tg personal messages send @example_user "…". Un cliente MCP se conecta con tg personal mcp serve. Deje tg_write sin aprobar en el cliente y le preguntará antes de cada envío. Los permisos del perfil aún limitan lo que puede escribir. Consulte el servidor MCP.
Un grupo que diriges
Escribe en Telegram: sólo si las reglas del grupo lo permiten. Permitir: Bash(tg personal review:*), Bash(tg personal chats events:*), Bash(tg personal chats members list:*), Bash(tg personal chats moderate:*).
Ejecute
tg personal review 'chat:Hiking' --unanswered 4h --json,tg personal chats events "Hiking" "time>=7d" --jsonytg personal chats moderate "Hiking" --dry-run --json. Brevemente: qué preguntas esperan respuesta, de quién y desde cuándo; quién se unió o fue agregado esta semana y por quién; lo que encontró el cheque en contra de las reglas del grupo y lo que sugiere. No responda ni elimine a nadie: enumere los comandos que lo harían si estoy de acuerdo.
Con planes --dry-run, chats moderate únicamente. Sin él, actúa hasta donde lo permiten las reglas del grupo, así que deje a Bash(tg personal chats moderate:*) fuera de la lista si el agente nunca debe actuar. Cada escenario para un grupo: grupos que ejecuta.
Colecciones similares
Recetas ajenas para Telegram y un agente. Sus solicitudes funcionan con tg una vez que reemplaza las herramientas con comandos:
- Telegram MCP: la guía completa: un pase matutino por la bandeja de entrada, borradores de respuestas, un resumen del canal, una búsqueda en varios chats.
- pioh/tg — un agente de IA con una cuenta personal de Telegram: un resumen cada N minutos, "recuérdame si no he respondido a mamá en 15 minutos", observando personas y chateando.
- Libro de cocina de Gorgias MCP — recetas para atención al cliente, pero bien hechas: cada uno dice si escribe algo y qué cambiar usted mismo.