# Descarga y exporta el historial de chats de Telegram (/es/docs/tg/archive)

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 [#qué-puedes-hacer]

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

## Comprueba y completa un chat [#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:**

```sh
tg personal store status "Book club" --json
```

**Descargar el periodo elegido:**

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

**Comprobar de nuevo:**

```sh
tg personal store status "Book club" --json
```

**Ejemplo de respuesta del agente:**

> | Comprobación | Antes | Después |
> | --- | --- | --- |
> | Mensajes guardados | 30 | 300 |
> | Historial solicitado de 30 días | Lagunas | Guardado 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 [#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](#keeping-it-current-serve)). `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](/llms.mdx/docs/es/tg/security/content.md#what-reaches-the-disk)).

**Es un único archivo para todas las cuentas y CLI de mensajería** que utilizan la misma biblioteca, como [max-cli](https://github.com/WireCatLabs/max-cli):

```text
~/.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 [#cuánto-hay-guardado]

```sh
tg personal store status         # per chat: messages stored, the oldest and newest, the stretches held completely
```

```sh
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 [#descargar-el-historial-de-un-chat]

```sh
tg personal messages sync "Book club" --dry-run  # what a full fetch would still cost; asks Telegram nothing
```

```sh
tg personal messages sync "Book club"           # fetch it, newest to oldest
```

```sh
tg personal messages sync "Book club"           # run again to continue where it stopped
```

```sh
tg personal messages sync "Book club" --since-time 30d  # only back to 30 days ago
```

```sh
tg personal messages sync "Book club" --last 5000  # only until the newest 5000 are held
```

```sh
tg personal messages sync "Book club" --limit 5000  # up to 5000 messages in this run
```

```sh
tg personal messages sync --all                 # every chat, most recently active first: the last 90 days
```

```sh
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](/llms.mdx/docs/es/tg/configuration-reference/content.md)). 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](/llms.mdx/docs/es/tg/search/content.md#when-nothing-is-found).

### En segundo plano [#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:

```sh
tg personal messages sync "Book club" --background  # prints the job id
```

```sh
tg personal store jobs list                 # background jobs, newest first
```

```sh
tg personal store jobs list state:failed    # only failed ones: running, done, partial, failed, cancelled or died
```

```sh
tg personal store jobs show                 # the newest job, and what the store now holds of its chat
```

```sh
tg personal store jobs show <job>
```

```sh
tg personal store jobs cancel <job>         # stops after the current page; a later fetch resumes
```

```sh
tg personal store jobs retry <job>          # a failed or died job again, as a new job with the same options
```

```sh
tg personal store jobs retry --failed       # every chat whose newest job failed or died
```

```sh
tg personal store jobs clear                # forget finished jobs and their logs; a running job stays
```

## Buscar [#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](/llms.mdx/docs/es/tg/search/content.md) 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 [#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](/llms.mdx/docs/es/tg/topic-search/content.md).

## Exportar [#exportar]

```sh
tg personal store export "Book club" --jsonl > book-club.jsonl  # one message per line, oldest first
```

```sh
tg personal store export "Book club" --json > book-club.json  # { "items": [...] }
```

```sh
tg personal store export "Book club" --format markdown > book-club.md  # a transcript: a heading per day, replies and forwards quoted
```

```sh
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 [#en-una-carpeta-y-solo-lo-que-ha-cambiado]

```sh
tg personal store export "Book club" "Work" --output-dir ~/tg-export  # a JSON-lines file per chat, and manifest.json
```

```sh
tg personal store export --include group --output-dir ~/tg-groups  # every stored group
```

```sh
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 [#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:

  ```sh
  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 [#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`:

```sh
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` [#consultar-sin-conexión---offline]

```sh
tg personal --offline chats list
```

```sh
tg personal --offline messages list "Book club" --limit 50
```

```sh
tg personal --offline messages show "Book club" 4242
```

```sh
tg personal --offline messages context "Book club" 4242
```

```sh
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` [#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](/llms.mdx/docs/es/tg/usage/content.md#new-messages-as-they-arrive)).

### En segundo plano [#en-segundo-plano-1]

```sh
tg personal server start  # start serve in the background; answers once it listens
```

```sh
tg personal server status  # whether it runs, since when, who started it
```

```sh
tg personal server logs -n 50  # its latest log lines
```

```sh
tg personal server stop
```

```sh
tg personal server restart
```

### Como servicio [#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.

```sh
tg personal server install  # writes ~/.config/systemd/user/tg-serve-<profile>.service and enables it; starts nothing
```

```sh
tg personal server start  # starts it — through the unit, now that there is one
```

```sh
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](/llms.mdx/docs/es/tg/replies/content.md).

## Comprobación, copia de seguridad y restauración [#comprobación-copia-de-seguridad-y-restauración]

```sh
tg personal store info                 # where the file is, its size, its schema, how many rows; changes nothing
```

```sh
tg personal store check                # integrity, search indexes, disk, and which chats are behind; changes nothing
```

```sh
tg personal store backup ~/tg-store.db  # a copy of the store, while it is in use; --encrypt for a password
```

```sh
tg personal store restore ~/tg-store.db  # put a backup in place of the store
```

```sh
tg personal store migrate              # bring the store up to this version's schema
```

```sh
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 [#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-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:

```text
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 [#reglas-de-respuesta]

[Respuestas automáticas](/llms.mdx/docs/es/tg/replies/content.md) 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:

```liquid
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 [#siguiente-paso]

- [Búsqueda de mensajes](/llms.mdx/docs/es/tg/search/content.md): encuentra lo que tiene el archivo local.
- [Recetas](/llms.mdx/docs/es/tg/recipes/content.md): busca y exporta en el trabajo diario de tu agente.
- [Seguridad](/llms.mdx/docs/es/tg/security/content.md): qué significa el archivo local para la privacidad de tus mensajes.

## Copias independientes de archivos [#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:

```sh
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 [#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:

```sh
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.

```sh
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](/llms.mdx/docs/es/tg/attachments/content.md).

### Mover imágenes antiguas a otro archivo [#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:

```sh
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.
