MensajeríaTelegram

Descarga y exporta el historial de chats de Telegram

Comprueba qué mensajes de Telegram están guardados, descarga el historial que falte y exporta lo necesario.

Guarda el historial de los chats que necesitas para encontrar mensajes antiguos y recordar acuerdos. Esta guía te ayuda a elegir el periodo, comprobar lo guardado y exportar una copia cuando haga falta.

tg guarda cada mensaje que lee en su computadora. Esta página es para cuando desea que el historial guardado esté completo y actualizado: para buscar meses atrás, para permitir que su agente responda sin conectarse o para exportar un chat a un archivo.

Después de leerlo, sabrás qué guarda tg y dónde, cómo descargar el historial anterior de un chat, cómo mantener el archivo local actualizado mientras estás fuera, cómo exportarlo y hacer una copia de seguridad, y cómo verificar que esté en buen estado.

Términos utilizados en esta página:

  • Almacenamiento local (también llamado archivo): un archivo de base de datos SQLite en esta computadora que contiene los chats, mensajes y contactos que tg ha visto. Busca, exporta y --offline responde desde él sin consultar Telegram.
  • Recuperar: descarga el historial anterior de un chat en el archivo local, página por página. Leer un chat guarda solo lo que lees; ir a buscar llena el resto.
  • Cobertura: qué tramos del historial de un chat el archivo local mantiene sin espacios.
  • serve: un proceso tg que permanece conectado y guarda nuevos mensajes, ediciones y eliminaciones a medida que ocurren.

Qué puedes hacer

TareaComando
Vea cuánto se guarda de cada chattg personal store status
Descargue el historial de un chat o el de cada chattg personal messages sync <chat>, tg personal messages sync --all
Ejecute una descarga larga en segundo planotg personal messages sync <chat> --background, tg personal store jobs list
Mantengal archivo local actualizado todo el tiempotg personal server start, tg personal server install
Leer chats sin conectarsetg personal --offline messages list <chat>
Exportar un chat a líneas JSON o Markdowntg personal store export <chat> --output <file>
Preparar mensajes para el informe de un agentetg personal messages evidence <chat>
Verificar, realizar copias de seguridad y restaurar el archivo localtg personal store check, tg personal store backup, tg personal store restore

Comprueba y completa un chat

Comprueba qué se ha guardado antes de descargar más. Limita la descarga al chat y periodo que necesitas.

Tu petición:

Usa tg CLI. Comprueba el historial guardado de Book club. Descarga los últimos 30 días de ese chat y dime si quedan lagunas.

Consultar el historial guardado:

tg personal store status "Book club" --json

Descargar el periodo elegido:

tg personal messages sync "Book club" --since-time 30d --json

Comprobar de nuevo:

tg personal store status "Book club" --json

Ejemplo de respuesta del agente:

ComprobaciónAntesDespués
Mensajes guardados30300
Historial solicitado de 30 díasLagunasGuardado sin lagunas

Este resultado cubre el periodo elegido, no todo el pasado del chat.

Si la descarga se detiene por un límite o una espera del servidor, repítela para continuar y comprueba la cobertura. Que el comando termine no demuestra por sí solo que el historial esté completo. Los recuentos son ficticios.

Qué se guarda

  • Cada lectura. Los chats vistos por chats list, los mensajes leídos por messages list, messages context e inbox, y los mensajes que envías.
  • Lo que recibe serve: nuevos mensajes, ediciones, eliminaciones y reacciones mientras está activo (más abajo). watch también guarda lo que imprime.
  • Lo que descargas expresamente: el historial de un chat con tg personal messages sync y tus contactos con tg personal contacts sync.

Mantiene el texto completo de cada mensaje que ha visto. El archivo solo lo puede leer su usuario y no está cifrado (lo que llega al disco).

Es un único archivo para todas las cuentas y CLI de mensajería que utilizan la misma biblioteca, como max-cli:

~/.local/share/WireCat/wirecat.db             # Linux and macOS; MESSAGING_STORE moves it

tg personal session end cierra sesión y deja intacto el archivo local.

Cuánto hay guardado

tg personal store status         # per chat: messages stored, the oldest and newest, the stretches held completely
tg personal store status "Book club"  # one chat

Un tramo «completo» es una secuencia de mensajes sin huecos. Leer mensajes sueltos deja huecos; messages sync los rellena.

Descargar el historial de un chat

tg personal messages sync "Book club" --dry-run  # what a full fetch would still cost; asks Telegram nothing
tg personal messages sync "Book club"           # fetch it, newest to oldest
tg personal messages sync "Book club"           # run again to continue where it stopped
tg personal messages sync "Book club" --since-time 30d  # only back to 30 days ago
tg personal messages sync "Book club" --last 5000  # only until the newest 5000 are held
tg personal messages sync "Book club" --limit 5000  # up to 5000 messages in this run
tg personal messages sync --all                 # every chat, most recently active first: the last 90 days
tg personal messages sync --all --since-time 365d  # every chat, back to a year ago

messages sync lee y guarda el historial por páginas, empezando por lo más reciente. Puede reanudarse: después de cada página registra lo que ya contiene, por lo que detenerlo no pierde datos. Ctrl-C, --timeout, el límite --limit, --since-time, --last y una espera larga exigida por Telegram detienen la descarga; la siguiente ejecución omite lo que ya está guardado. --since-time y --last indican hasta dónde retroceder: utiliza una de las dos, no ambas. Un fallo permanente antes de la primera página guardada termina con un error; si ya hay progreso, un fallo puede devolver lo guardado con un issue.

Cada página es una petición desde tu cuenta, de hasta 100 mensajes. La ejecución se detiene al alcanzar --limit mensajes (1000 por defecto); --page-size define los mensajes por petición (100 por defecto) y --pause separa las páginas (1 segundo por defecto; 500ms, 30s, 2m). Si Telegram exige una espera corta, el comando espera; si supera cinco minutos, se detiene para que lo ejecutes más tarde. Consulta primero --dry-run: calcula a partir del archivo y no envía peticiones.

Respeta los límites del historial. Por defecto omite un grupo de más de 50 personas y lee un grupo 365 días atrás y un chat individual 1095 días atrás; la respuesta indica lo que dejó fuera en limited, y tg personal store status muestra esos chats. tg personal messages sync "Book club" --full-history lee un chat más allá de los límites y lo guarda completo a partir de entonces; los ajustes history_* cambian los límites para todos los chats (configuración). Los mensajes en directo de serve se guardan igualmente.

Para buscar y llenar los espacios vacíos dentro del historial guardado de un chat y preparar la búsqueda de temas inmediatamente después de una búsqueda (--catch-up), consulte cuando no se encuentra nada.

En segundo plano

Una descarga larga puede ejecutarse como una tarea que continúa después de finalizar el comando. No tiene el plazo predeterminado de 30 segundos; un --timeout explícito sigue limitándola:

tg personal messages sync "Book club" --background  # prints the job id
tg personal store jobs list                 # background jobs, newest first
tg personal store jobs list state:failed    # only failed ones: running, done, partial, failed, cancelled or died
tg personal store jobs show                 # the newest job, and what the store now holds of its chat
tg personal store jobs show <job>
tg personal store jobs cancel <job>         # stops after the current page; a later fetch resumes
tg personal store jobs retry <job>          # a failed or died job again, as a new job with the same options
tg personal store jobs retry --failed       # every chat whose newest job failed or died
tg personal store jobs clear                # forget finished jobs and their logs; a running job stays

Buscar

tg personal search messages encuentra mensajes almacenados por palabras, remitente, chat, fecha, archivos, enlaces y sus propias etiquetas. Las búsquedas de palabras también solicitan Telegram de forma predeterminada; --backend archive solo lee mensajes guardados. --sync-first recupera primero los mensajes nuevos. Búsqueda de mensajes es la guía, con búsquedas y recuentos guardados. Una respuesta vacía significa "no en este archivo local": busca primero el chat.

Conversaciones dentro de un grupo

Un grupo ocupado mezcla varias conversaciones a la vez. tg personal conversations los separa de los mensajes almacenados y los encuentra según su contenido en esta computadora: búsqueda de tema.

Exportar

tg personal store export "Book club" --jsonl > book-club.jsonl  # one message per line, oldest first
tg personal store export "Book club" --json > book-club.json  # { "items": [...] }
tg personal store export "Book club" --format markdown > book-club.md  # a transcript: a heading per day, replies and forwards quoted
tg personal store export "Book club" --output book-club.jsonl --since-time 7d  # the last week, into a file only you can read

La exportación solo escribe lo guardado y nunca consulta Telegram. Comprueba primero tg personal store status y descarga el historial si lo necesitas completo.

--output <file> escribe líneas JSON, o una transcripción con --format markdown, en un archivo nuevo que solo tú puedes leer. Indica la ruta y el número de mensajes. Nunca sobrescribe un archivo. --since-time acepta una fecha ISO 8601 o un intervalo anterior como 30m, 2h, 1d.

En una carpeta, y solo lo que ha cambiado

tg personal store export "Book club" "Work" --output-dir ~/tg-export  # a JSON-lines file per chat, and manifest.json
tg personal store export --include group --output-dir ~/tg-groups  # every stored group
tg personal store export --all --output-dir ~/tg-all   # every stored chat of this account

Si vuelves a ejecutarlo en la misma carpeta, solo añade lo que ha cambiado desde la última vez: mensajes nuevos, ediciones (también de mensajes antiguos) y eliminaciones. Un mensaje eliminado se escribe sin su texto, como { "id", "chat_id", "deleted": true }. Se rechaza una carpeta que contenga otros archivos o que se haya exportado desde otra cuenta. Un cambio solo en las reacciones no cuenta como cambio.

Con contraseña

--encrypt en store export (con --output o --output-dir) y en store backup comprime el archivo y lo cifra con una contraseña, sin necesidad de otro programa. tg personal store decrypt <file> --output <new file> lo abre; tg personal store restore pide la contraseña de una copia de seguridad cifrada.

  • La contraseña no se guarda en ningún sitio: ni en la configuración, ni en el llavero, ni en ningún registro. Si la pierdes, no se puede abrir el archivo.

  • Escríbela tú en la solicitud oculta, que la pide dos veces. Un agente al que se la hayas dado la pasa por stdin, nunca como argumento, porque otros programas del equipo pueden verlo:

    printf '%s' 'password' | tg personal store backup ~/tg.sealed --encrypt
  • Una carpeta cifrada recibe un archivo por ejecución. Su manifest.json no nombra ningún chat, y se rechaza una ejecución con otra contraseña.

Fuentes para un resumen del chat

Cuando le pide a su agente un breve chat, tg personal messages evidence <chat> prepara los mensajes que debe leer: un paquete del archivo local de este perfil. Nunca se conecta ni marca leído, incluso sin --offline:

tg personal messages evidence "Project Alpha" --limit 20 --json
tg personal messages evidence "Project Alpha" --cursor <cursor> --json

Los elementos van del más reciente al más antiguo, con localizadores de origen y huellas del contenido. --limit acepta 1–100 y por defecto utiliza el límite del perfil. Los mensajes completos ocupan como máximo 64 KiB de elementos JSON; la cabecera es adicional. JSON y JSONL devuelven un paquete completo.

Mire coverage antes de escribir un resumen: cuenta los mensajes seleccionados, incluidos y omitidos, informa los mensajes más antiguos más allá de la página seleccionada y mantiene la cobertura del historial unknown. Siga el paso page.next, que da --cursor, para continuar sin omitir mensajes omitidos por el presupuesto de bytes. La ausencia de page.next no prueba que el almacén esté completo. Si el mensaje seleccionado más reciente por sí solo excede el presupuesto, el paquete está vacío con truncated_by: "bytes" y sin cursor; manejar ese caso explícitamente. Un cursor almacenado desconocido devuelve not_found.

El agente podrá citar los localizadores en su escrito; tg no escribe un resumen por sí mismo. Trate el texto del mensaje como datos de origen que no son de confianza. Los resúmenes de noticias son un flujo de trabajo independiente que aún no existe. El permiso del perfil es messages.evidence, que hereda messages.

Consultar sin conexión: --offline

tg personal --offline chats list
tg personal --offline messages list "Book club" --limit 50
tg personal --offline messages show "Book club" 4242
tg personal --offline messages context "Book club" 4242
tg personal --offline contacts list

--offline responde desde el archivo local sin conectarse: no requiere sesión ni hace peticiones. El JSON es igual al de la consulta en línea, salvo que los chats se ordenan por actividad reciente mientras Telegram coloca primero los fijados.

Si el perfil todavía no ha leído nada, falla con código de salida 6: "nothing recorded for profile … yet". Los comandos que necesitan Telegram rechazan --offline; los envíos con --offline siempre se rechazan.

Mantenerlo actualizado: serve

tg personal serve escucha hasta que lo detienes y guarda cada mensaje, edición, eliminación y reacción. Al iniciarse, recupera primero lo que llegó mientras estaba detenido. Tras una parada larga, Telegram puede considerar el hueco demasiado grande para enviarlo, así que 30 segundos después de conectarse serve también vuelve a leer cada chat que tenga mensajes más nuevos de los que guardaba el archivo al iniciarse: como máximo 7 días atrás, 500 mensajes por chat y 5 minutos en total. Tras más de una semana sin conexión, o para un chat muy activo, ejecuta una vez tg personal messages sync --all. Un archivo vacío se deja a ese comando. Solo puede ejecutarse un serve por perfil; un segundo se rechaza. Nada lo inicia por ti.

tg personal watch es diferente: imprime mensajes nuevos a partir de ahora y no se pone al día con lo que se perdió (mensajes nuevos a medida que llegan).

En segundo plano

tg personal server start  # start serve in the background; answers once it listens
tg personal server status  # whether it runs, since when, who started it
tg personal server logs -n 50  # its latest log lines
tg personal server stop
tg personal server restart

Como servicio

Para mantenerlo activo entre inicios de sesión, instálalo como servicio de usuario: unidad de usuario systemd en Linux o agente launchd en macOS.

tg personal server install  # writes ~/.config/systemd/user/tg-serve-<profile>.service and enables it; starts nothing
tg personal server start  # starts it — through the unit, now that there is one
tg personal server status  # starts_at_login says whether it starts at the next login

En macOS, el agente se guarda en ~/Library/LaunchAgents/. install habilita la unidad, así que se inicia en cada inicio de sesión y tras un reinicio; una unidad instalada por un tg anterior no queda habilitada hasta que vuelvas a ejecutar server install. Una unidad instalada desde una copia de desarrollo (con sus propias carpetas TG_*_DIR) se escribe, pero no se habilita.

  • La unidad ejecuta el node y el tg usados al instalarla. Vuelve a instalarla si cambias su ubicación, por ejemplo al cambiar de versión de Node.
  • Recibe el perfil y las variables TG_*_DIR y MESSAGING_STORE de la terminal que ejecutó server install, y ninguna otra.
  • Compruébalo después de server start: tg personal server logs. El servicio obtiene la aplicación del llavero. Si este permanece bloqueado hasta iniciar sesión, el servicio falla; systemd lo reintenta cada 30 s y los registros indican la causa.
  • Una sesión ya revocada impide el inicio. serve lo comprueba antes de indicar que está listo y termina con el código 4; la unidad instalada queda detenida. Inicia sesión con tg personal session start y después ejecuta tg personal server start. Si la sesión se revoca mientras el servicio funciona, también termina con el código 4, en unos 15 minutos. Si las credenciales de la aplicación no están disponibles y existe una sesión guardada, serve termina con el código 12 y systemd lo reintenta. En macOS, el agente no se reinicia tras ningún fallo, porque launchd no puede excluir un código de salida concreto; vuelve a iniciarlo con tg personal server start. Ejecuta de nuevo tg personal server install para actualizar una unidad antigua.
  • tg personal server uninstall deshabilita y elimina la unidad. Detén el servicio primero.
  • En macOS, server stop descarga el agente hasta el próximo inicio de sesión, igual que en Linux; server uninstall evita que vuelva a iniciarse.
  • tg upgrade reinicia el servidor activo para que no siga usando la versión anterior.

Las respuestas automáticas de serve siguen tus reglas y la audiencia elegida; consulta las respuestas automáticas.

Comprobación, copia de seguridad y restauración

tg personal store info                 # where the file is, its size, its schema, how many rows; changes nothing
tg personal store check                # integrity, search indexes, disk, and which chats are behind; changes nothing
tg personal store backup ~/tg-store.db  # a copy of the store, while it is in use; --encrypt for a password
tg personal store restore ~/tg-store.db  # put a backup in place of the store
tg personal store migrate              # bring the store up to this version's schema
tg personal store clear --left --allow-dangerous  # delete the chats you have left, with their messages
  • backup nunca sobrescribe archivos: indica una ruta nueva. Copia la base de datos mientras otros comandos y serve siguen utilizándola.
  • restore conserva el archivo sustituido junto al nuevo e indica dónde. Rechaza la restauración si hay un serve activo en cualquier perfil: ejecuta primero tg personal server stop. Comprueba que la copia sea legible y no esté dañada. Después reinicia todos los procesos serve y mcp serve activos de ambos CLI para que lean el archivo restaurado.
  • Un chat del que has salido desaparece de chats list --offline la próxima vez que tg personal chats list lea la lista completa; sus mensajes permanecen guardados. Si vuelves a unirte, reaparece. store clear --left elimina esos chats y mensajes. Sin --allow-dangerous, solo indica cuántos eliminaría. No se puede volver a descargar un chat del que has salido.
  • migrate solo es necesario si info o check indica que el archivo usa un esquema anterior. Haz una copia primero. Después normaliza los mensajes antiguos por lotes; detenerlo no pierde datos.

Reparación y mantenimiento de índices

tg personal store migrate crea índices sin terminar; tg personal store rebuild los reconstruye. store info y store check muestran si el índice de palabras y el índice de raíz de palabras están listos. La búsqueda utiliza raíces (la parte de una palabra que permanece igual en sus formas) para encontrar formas de palabras; exact: y --exact seleccionan formas exactas.

tg config set search_stemmers.cyrillic russian y search_stemmers.latin english,spanish configuran las raíces del archivo local compartido: el latín toma english, spanish o ambos (el valor predeterminado, por lo que una palabra latina coincide con las raíces de ambos) y none desactiva una; ejecute store rebuild según su propia elección. Cuando una actualización de tg cambia el valor predeterminado, las raíces se reconstruyen por sí mismas: hasta que estén listas, una búsqueda coincide con las formas exactas de las palabras y lo dice, tg personal serve las finaliza en segundo plano y store migrate de inmediato. La configuración afecta tanto a los servicios de mensajería como a todos los perfiles; un proceso con perfil bloqueado no puede cambiarlo.

tg personal store repair --dry-run --json obtiene una vista previa de una reparación estructural y la revierte. store repair lo aplica sin eliminar datos: las tablas que no coinciden se mantienen como copias y las filas o columnas que quedan allí se nombran en la respuesta. Inspeccione las copias antes de eliminar una con store copies delete <exact name>; store repair los nombra en su respuesta. Detenga los procesos que utilizan el archivo local antes de una reparación.

El archivo local y otras versiones

El esquema del archivo tiene una versión. Un tg más reciente u otro CLI pueden actualizarlo; un tg anterior seguirá funcionando mientras el cambio sea compatible. Si deja de serlo, cada comando que abre el archivo indica:

the message store was written by a newer version (schema N, needs at least M; this one speaks K) — upgrade this tool

La copia local compartida usa wirecat.db. El antiguo messages.db no se migra: al abrir el almacén predeterminado se elimina junto con sus archivos -wal y -shm. Si necesitas notas, alias, etiquetas, tareas o transcripciones antiguas, cierra los programas que usan ese archivo y cópialo, con los archivos auxiliares que tenga, a otra carpeta antes de ejecutar la nueva versión por primera vez. Definir MESSAGING_STORE desactiva esta limpieza; un archivo abierto por otro proceso permanece hasta una apertura posterior del almacén. tg personal messages sync --all recupera mensajes de Telegram; los datos que solo existían localmente no se pueden descargar del servidor. El inicio de sesión se conserva por separado. Actualiza tg y max juntos para que usen el mismo almacén.

Para actualizar el esquema de wirecat.db, ejecuta tg upgrade después de conservar cualquier archivo antiguo necesario.

Reglas de respuesta

Respuestas automáticas es la guía para las reglas de respuesta. Esta sección es la referencia detallada de cómo serve los aplica.

tg personal replies test [rule] --since-time 7d --json simula qué mensajes almacenados recibirían; nunca envía. Las reglas se encuentran en el archivo de respuestas del perfil. replies status, pause y resume los inspeccionan/controlan. Las respuestas reales compartidas serve requieren un permiso replies.send:allow explícito y van a todos los que coincidan con una regla a menos que la audiencia las limite. El envío está denegado de forma predeterminada. Se ignoran las ediciones, los mensajes anteriores al inicio y los mensajes ya respondidos. ask no puede realizar envíos desde un servicio desatendido.

Cree una regla deshabilitada con tg personal replies add away, edítela con replies edit away --template y luego use replies on away o off away. Las reglas de respuesta habilitadas necesitan una plantilla que no esté vacía. La edición cambia solo los campos con nombre; las listas son reemplazos separados por comas, una cadena vacía borra una. Las opciones incluyen --do reply,task, --kinds, --allow-chats, --deny-chats, --words, --question / --no-question, --mentions-me / --no-mentions-me, --allow-people, --deny-people, --contacts-only / --no-contacts-only, --as-reply / --no-as-reply, --per-chat, --per-person y los campos de horas --outside, --days, --timezone (--no-hours los borra). La primera configuración de horas requiere los tres campos. Las ediciones no válidas conservan el archivo, otras reglas, la audiencia y el historial de respuestas.

tg personal replies audience muestra la audiencia del perfil; --reply all|listed, --allow-people, --allow-chats, --deny-people y --deny-chats reemplazan sus campos nombrados. Negar gana; listado con una lista de permitidos vacía no responde a nadie; un nuevo archivo responde a todos los que coinciden con una regla. La tarea local de una regla puede abrirse incluso cuando una respuesta está prohibida.

Las plantillas usan las variables Liquid sender.firstName, sender.name, chat.title, chat.kind y now en la zona horaria del horario de trabajo de la regla (UTC si no hay ninguna), con filtros como default y date. Se rechazan las variables y filtros desconocidos; se prohíben las etiquetas de archivos y el acceso a prototipos, y se limitan el tiempo de renderizado, la asignación de memoria y la longitud de salida. El mensaje entrante nunca es una variable. Solo un bloque ai puede llamar a un modelo; su contenido es la instrucción y el mensaje se envía por separado como datos:

Thanks, {{ sender.firstName | default: "there" }}.
{% ai %}Briefly acknowledge this; I will answer tomorrow.{% else %}I will answer tomorrow.{% endai %}

La salida del modelo sustituye solo su bloque y no se analiza de nuevo. Si faltan configuración o consentimiento, si una llamada falla o se rechaza la salida, se usa la rama else; sin ella se omite la respuesta. El texto externo sigue siendo el del propietario con sus sustituciones habituales. Los marcadores antiguos y los archivos may-reword conservan su alternativa literal rellenada con advertencias; los archivos nuevos no necesitan un campo model.

Elige models.replies.provider, .model y, opcionalmente, .base_url; models.default es la alternativa y provider off desactiva un propósito. Los ajustes de análisis existentes siguen admitidos. config set / unset aceptan campos con notación de puntos; config show indica el origen de cada uno. Las claves siguen en models keys set; los endpoints personalizados usan su clave de host y puerto, nunca la de un proveedor público.

tg personal replies consents show|grant|revoke controla el consentimiento para el modelo por separado del permiso de envío. Grant permite explícitamente que los datos entrantes se envíen al proveedor configurado en todo este perfil, salvo los identificadores nativos de chats excluidos con replies consents deny; allow elimina una exclusión sin conceder consentimiento. Las exclusiones se conservan tras grant/revoke. Otro endpoint necesita un nuevo consentimiento. Los cambios de consentimiento, configuración, pausa, regla y audiencia durante una llamada al modelo se comprueban antes de enviar.

tg personal replies test muestra las instrucciones y la alternativa sin llamar a un modelo. tg personal replies test --ai envía explícitamente datos de mensajes almacenados al modelo autorizado por consentimiento, pero no envía una respuesta al servicio de mensajería ni cambia el historial de respuestas; no se puede combinar con --offline.

Siguiente paso

  • Búsqueda de mensajes: encuentra lo que tiene el archivo local.
  • Recetas: busca y exporta en el trabajo diario de tu agente.
  • Seguridad: qué significa el archivo local para la privacidad de tus mensajes.

Copias independientes de archivos

Usa un archivo de medios independiente cuando los archivos deban sobrevivir a mensajes borrados o enlaces de descarga caducados. Guarda los bytes en una carpeta que eliges, con un manifiesto que registra la identidad, el tamaño y la suma de verificación SHA-256 de cada archivo. Pídele a tu agente: «Haz una copia de los archivos del grupo Example group en mi archivo de medios y luego verifica las copias».

Telegram solo puede devolver los mensajes y archivos que siguen disponibles para tu cuenta. Esta orden no puede recuperar mensajes borrados ni archivos que ya no están disponibles.

Guarda todos los chats disponibles o repite --chat para elegir varios. --since-time incluye los mensajes desde una marca de tiempo ISO con zona horaria, inclusive:

tg personal attachments download ~/media-archive --chat "Example group" --since-time 2026-10-01T00:00:00Z --timeout 6h
tg personal attachments check ~/media-archive --offline --json

El resultado informa de los archivos guardados, las copias existentes verificadas y los chats visitados. Una nueva ejecución verifica cada copia existente y descarga las identidades que faltan. Los archivos tienen nombres .bin basados en su identidad; sus manifiestos identifican el chat, el mensaje y la posición del adjunto. En un manifiesto no se guarda ninguna URL de descarga, clave de medios ni nombre de archivo original. Estas copias independientes no se registran como rutas conservadas en el almacén de mensajes; usa el messages download habitual para los archivos que quieras que encuentren attachments show o la extracción de texto.

Una ejecución interrumpida conserva los archivos completados. Ejecuta de nuevo la misma orden: un archivo interrumpido empieza desde el byte cero, porque los flujos del mensajero no ofrecen los validadores necesarios para añadir datos con seguridad. Una descarga fallida se detiene con un error; un archivo no disponible no cuenta como guardado. Si falta un archivo archivado o ha cambiado, la verificación falla con un código de salida distinto de cero y se detiene el archivado. Elige un destino nuevo; los archivos existentes nunca se sobrescriben. complete: true abarca el historial disponible para el lector seleccionado, no demuestra que todos los archivos de origen antiguos sigan existiendo.

Copia diaria en Linux

Las copias diarias están desactivadas hasta que instales y arranques un temporizador de usuario de systemd. La instalación no inicia nada:

tg personal attachments jobs install ~/media-archive --chat "Example group" --at 03:00 --timezone UTC
tg personal attachments jobs start ~/media-archive
tg personal attachments jobs status ~/media-archive

El temporizador se ejecuta con el ejecutable, el perfil y las ubicaciones de archivos capturados, un límite de seis horas y permisos de archivo solo para el propietario. Por defecto son las 03:00 UTC; --timezone Europe/Madrid elige esa hora local. La configuración de servicios de usuario de tu sistema determina si se ejecuta con la sesión cerrada; las ejecuciones perdidas se recuperan cuando el temporizador vuelve a arrancar. macOS y Windows pueden ejecutar la orden de descarga manualmente.

tg personal attachments jobs stop ~/media-archive
tg personal attachments jobs uninstall ~/media-archive

Detener evita las ejecuciones futuras; una descarga en curso termina. Desinstalar exige un temporizador desactivado e inactivo y un servicio inactivo, y conserva el archivo. Usa el mismo perfil y destino en estas órdenes. Para cambiar el horario o el ejecutable, detén, desinstala e instala de nuevo; los archivos de unidad editados se conservan.

Tras una copia, attachments check debería informar de que todos los archivos son válidos. Para obtener texto buscable de las descargas habituales, continúa con los archivos adjuntos.

Mover imágenes antiguas a otro archivo

Para mantener pequeña la carpeta activa, mueve las imágenes anteriores a una fecha de mensaje elegida a otro archivo verificado. Usa otro disco para liberar espacio en el disco original. Primero haz una vista previa:

tg personal attachments move ~/media-archive /mnt/archive/older-images --before-time 2026-10-01T00:00:00Z --dry-run
tg personal attachments move ~/media-archive /mnt/archive/older-images --before-time 2026-10-01T00:00:00Z --timeout 6h
tg personal attachments check ~/media-archive --offline

El corte usa la fecha del mensaje, no la de la descarga, y excluye las imágenes exactamente en el corte. Se mueven las fotos y los archivos con tipo MIME de imagen; los demás se quedan. El destino se copia y verifica antes de eliminar los bytes locales de las imágenes. En la carpeta original quedan pequeños registros de traslado para que las comprobaciones sigan las copias y las descargas posteriores no las vuelvan a obtener. No se contacta con el mensajero.

Mantén el otro archivo disponible en su ruta registrada. Si está sin conexión o una copia cambia, las comprobaciones fallan y las descargas se detienen en lugar de duplicar archivos en silencio. Repite un traslado interrumpido para terminarlo. Las imágenes de borradores de archivo anteriores sin fecha de mensaje se quedan donde están y se cuentan como undated; complete: false significa que esas imágenes no se pudieron seleccionar por antigüedad. Nunca se usan las fechas de modificación de los archivos como sustituto. La vista previa informa de recuentos y bytes sin crear la carpeta de destino.