El almacén local

wa mantiene sus mensajes de WhatsApp en tu ordenador y cada lectura responde desde allí. Esta página es para cuando desea que el historial guardado esté actualizado: para buscarlo, para permitir que tu agente responda sin conectarse o para exportar un chat a un archivo.

Después de leerlo, sabrá qué guarda wa y dónde, cómo solicitarle a tu teléfono el historial anterior, cómo mantener actualizada el almacén local mientras está fuera, cómo exportarla 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 personas que wa ha visto. Cada uno lee, busca y exporta respuestas sin preguntarle a WhatsApp.
• History push: la copia de tus chats recientes que el teléfono envía una vez, segundos después de vincularse (linking).
• Cobertura: qué tramos del historial de un chat mantiene el almacén local sin espacios.
• serve: un proceso wa que permanece conectado y guarda nuevos mensajes, ediciones y eliminaciones a medida que ocurren.

De dónde viene la historiaCopy Anchor Link

WhatsApp no tiene solicitud de "chats". Tres cosas llenan el almacén local y nada más:

• El envío del historial justo después de vincular. wa <profile> session start y setup mantienen la conexión abierta y la guardan hasta que el teléfono haya estado en silencio durante 45 segundos.
• serve, mientras se ejecuta: mensajes nuevos, ediciones, eliminaciones y reacciones, y los mensajes que envías. Una edición mantiene el tiempo, la respuesta y las reacciones del mensaje; solo la edición de un mensaje que falta en el almacén local se guarda con el tiempo de edición. Un chat que lees por teléfono obtiene un recuento de no leídos de 0 y cada mensaje nuevo de otra persona agrega uno. Se guardan archivar, silenciar (con su fin) y marcar un chat como no leído en el teléfono; fijar, eliminar o borrar un chat no lo es.
• messages sync <chat>: mensajes antiguos de un chat, solicitados en tu teléfono (abajo).

Entonces, un chat contiene lo que el teléfono presionó y lo que llegó mientras se ejecutaba serve. Es posible que aún aparezca un mensaje que llegó mientras no había nada conectado cuando serve comience nuevamente.

Historial más antiguo desde tu teléfonoCopy Anchor Link

WhatsApp no ​​guarda ninguna copia de tus chats en sus servidores: la única copia completa está en tu teléfono. Así que no hay descarga, sólo una petición al teléfono: "mándame los 50 mensajes de este chat antes de este". wa cuenta hacia atrás desde el mensaje más antiguo del chat que el almacén local ya contiene, por lo que no se puede preguntar sobre un chat del que el almacén local no tiene nada.

Primero abre WhatsApp en tu teléfono. El teléfono responde mientras la aplicación está abierta; en segundo plano mantiene la solicitud y responde la próxima vez que la abra. Una solicitud que no responde en 25 segundos falla con timeout; la respuesta tardía aún llega y un serve en ejecución la guarda, por lo que no se pierde nada. Una respuesta vacía significa que el chat comienza allí.

wa personal messages sync <chat> realiza esta solicitud, página tras página, con al menos 2 segundos de diferencia, hasta llegar a --limit o al inicio del chat. Cuando el teléfono envía una página corta, wa pregunta una o dos veces más por el resto, con un segundo de diferencia. Pregunta sobre un chat a la vez: --all se rechaza, ya que WhatsApp no ​​tiene una lista de chats para recorrer.

Qué puedes hacerCopy Anchor Link

Lo que guardaCopy Anchor Link

• El push del historial, y lo que escuchan serve y watch: mensajes, ediciones, eliminaciones y reacciones. Se guarda la reacción más reciente de cada persona, por lo que un mensaje muestra cuántas personas reaccionaron con cada emoji y cuál es el tuyo. Una reacción retirada se descarta, y un empujón anterior nunca devuelve una reacción modificada desde entonces. Tus reacciones desde el teléfono se almacenan; uno que envías con reactions add va a WhatsApp pero no se almacena.
• Los mensajes que envías con wa.
• Si la otra persona recibió y leyó tu mensaje, en un chat uno a uno: delivery es delivered una vez que llegó a tu teléfono, y read una vez que lo abrió (una nota de voz reproducida cuenta). Sólo avanza. Proviene de los recibos serve, watch y de cualquier otro comando que se escuche, y del push del historial. Los mensajes de un grupo no tienen ninguno: WhatsApp informa de un grupo una persona a la vez. wa no envía ninguna confirmación de lectura propia para esto.
• Llamadas hacia ti que serve o watch escucha, como mensaje en el chat del llamante o en el grupo: "Llamada de voz entrante" mientras suena, luego, cuando finaliza, "Llamada de voz" (respondida, también por teléfono), "Llamada de voz rechazada" (también por teléfono) o "Llamada de voz perdida" (sonó, o quien llamó colgó primero, según el el teléfono lo muestra). Se mantiene como perdida una llamada que sonó mientras wa no estaba conectado y cuyo final WhatsApp no ​​reenvía. Una llamada que finalizó por un motivo que wa desconoce muestra "Llamada de voz" sin outcome. Una llamada está marcada como "action": "call" en provider_metadata, con video, outcome y una duración en segundos solo cuando wa escuchó tanto la respuesta como el final; una llamada contestada por teléfono no tiene ninguno. Una llamada de grupo se mantiene sólo cuando suena. Las llamadas que realice desde el teléfono y las llamadas realizadas antes de vincular wa no se conservan.
• Chats y personas como los nombra WhatsApp: una persona con un id …@lid, un grupo con un id …@g.us.

Mantiene el texto de cada mensaje que ha visto. Para una foto, nota de voz o archivo, conserva su nombre, tamaño y tipo, y las claves que WhatsApp necesita para recuperarlo (messages download), no el archivo en sí; las claves nunca aparecen en una respuesta. Los mensajes guardados antes de que wa manejara los archivos no tienen ninguno, y ninguno tiene una foto o video para ver una vez (archivos adjuntos). La tienda solo es legible por su usuario y no está cifrada (seguridad).Es un archivo para cada cuenta y cada CLI de Messenger creado en la misma biblioteca, como tg y max:

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

wa personal session end desvincula el dispositivo y deja el almacén local como está.

¿Cuánto se guarda?Copy Anchor Link

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

wa personal store status "Book club"  # one chat

wa personal store status [email protected]  # one chat, by its id

Un tramo "retenido por completo" es una serie de mensajes sin intervalos. La brecha entre el impulso de la historia y el día en que comenzó serve sigue siendo una brecha.

Manteniéndolo actualizado: serveCopy Anchor Link

wa personal serve permanece conectado hasta que se detiene y guarda cada mensaje nuevo, edición, eliminación y reacción. Se ejecuta un serve por perfil. Nada lo inicia por ti.

Mientras se ejecuta serve, mantiene la única conexión del dispositivo, por lo que un envío, una edición o una reacción para el mismo perfil pasa por serve y usa esa conexión (una conexión por dispositivo). Las lecturas nunca se conectan, por lo que funcionan junto a ellas. Una lectura sin serve detrás advierte que el almacén local puede estar desactualizada.

wa personal watch imprime nuevos mensajes a medida que llegan. Mientras se ejecuta serve, escucha a través de serve; sin serve, mantiene la conexión en sí.

En el fondoCopy Anchor Link

wa personal server start  # start serve in the background; answers once it listens

wa personal server status  # whether it runs, since when, who started it

wa personal server logs -n 50  # its latest log lines

wa personal server stop

wa personal server restart

Como servicioCopy Anchor Link

Para que siga funcionando en todos los inicios de sesión, instálelo como un servicio de usuario: una unidad de usuario systemd en Linux, un agente de lanzamiento en macOS.

wa personal server install  # writes the unit for this profile; starts nothing

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

wa personal server status

En Linux, systemctl --user enable con el nombre de la unidad hace que se inicie cada vez que inicia sesión. En macOS, el agente ingresa a ~/Library/LaunchAgents/.

• La unidad ejecuta el node y el wa que lo instaló. Instálelo nuevamente después de mover cualquiera de los dos, por ejemplo, después de cambiar las versiones de Node.
• Obtiene el perfil y las variables WA_*_DIR y MESSAGING_STORE del shell que ejecutó server install, y nada más.
• Compruébelo una vez después de server start: wa personal server logs.
• wa personal server uninstall retira la unidad. Detenlo primero.
• wa upgrade reinicia un servidor en ejecución, por lo que no sigue ejecutando la versión anterior.

BuscarCopy Anchor Link

wa personal search messages encuentra mensajes almacenados por palabras, remitente, chat, fecha y sus propias etiquetas. Buscar es la guía, con búsquedas y recuentos guardados. Una respuesta vacía significa "no en esta tienda", no "nunca enviada".

ExportarCopy Anchor Link

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

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

wa personal store export "Book club" --format markdown > book-club.md  # a transcript: a heading per day

wa personal store export "Book club" --output book-club.jsonl --since-time 7d  # the last week, a file only you read

Export escribe solo lo que contiene el almacén local y nunca pregunta a WhatsApp. Verifique primero wa personal store status.--output <file> escribe líneas JSON, o la transcripción con --format markdown, en un archivo nuevo que solo ti puede leer e imprime dónde fue y cuántos mensajes contiene. Nunca sobrescribe un archivo. --since-time toma un tiempo ISO 8601 o hace 30m, 2h, 1d.

En una carpeta, y solo lo que cambióCopy Anchor Link

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

wa personal store export --include group --output-dir ~/wa-groups  # every stored group

wa personal store export --all --output-dir ~/wa-all   # every stored chat of this account

Ejecútelo nuevamente en la misma carpeta y agregará solo lo que cambió desde la última ejecución: mensajes nuevos, ediciones (también mensajes antiguos) y eliminaciones. Un mensaje eliminado se escribe sin su texto, como { "id", "chatId", "deleted": true }. Se rechaza una carpeta que contenga otros archivos o uno exportado desde otra cuenta. Un cambio en las reacciones por sí solo no cuenta como un cambio.

Con una contraseñaCopy Anchor Link

--encrypt en store export (con --output o --output-dir) y en store backup comprime el archivo y lo cifra con una contraseña; no se necesita ningún otro programa. wa personal store decrypt <file> --output <new file> abre uno; wa personal store restore solicita la contraseña de una copia de seguridad cifrada.

• La contraseña no se guarda en ninguna parte: ni en la configuración ni en ningún registro. Si lo pierde, el archivo no podrá abrirse.

• Escríbalo ti mismo en el mensaje oculto, que le preguntará dos veces. Un agente al que se lo entregó lo canaliza en la entrada estándar, nunca como un argumento, que otros programas en la máquina pueden ver:

  Copy Text

  printf '%s' 'password' | wa personal store backup ~/wa.sealed --encrypt

• Una carpeta cifrada requiere un archivo por ejecución. Su manifest.json no nombra ningún chat y se rechaza una ejecución con una contraseña diferente.

Evidencia para un resumen de chatCopy Anchor Link

Cuando le pide a tu agente un breve chat, wa personal messages evidence <chat> prepara los mensajes que debe leer: un paquete del almacén local de este perfil. Nunca se conecta ni marca leído:

wa personal messages evidence "Project Alpha" --limit 20 --json

Los elementos son los más nuevos primero, con localizadores de fuentes y huellas digitales de contenido. --limit acepta del 1 al 100 y de forma predeterminada utiliza el límite del perfil. Los mensajes completos ocupan como máximo 64 KiB de elementos JSON; el encabezado del paquete es adicional. JSON y JSONL devuelven cada uno 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 repite el comando con --cursor y el cursor de este paquete, para continuar sin omitir mensajes omitidos por el presupuesto de bytes. No page.next no prueba que el almacén local esté completa. 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. Un cursor almacenado desconocido devuelve not_found.

El agente podrá citar los localizadores en su escrito; wa no escribe un resumen por sí mismo. Trate el texto del mensaje como datos de origen que no son de confianza. El permiso del perfil es messages.evidence, que hereda messages.

Leer sin conectarseCopy Anchor Link

wa personal chats list

wa personal messages list "Book club" --limit 50

wa personal messages show [email protected] 3EB0A1B2C3D4E5F6A7B8

wa personal messages context [email protected] 3EB0A1B2C3D4E5F6A7B8

Cada lectura responde del almacén local, con o sin --offline; no se realiza ninguna solicitud y no se marca nada como leído. Antes de que el perfil tenga algo almacenado, falla una lectura con el código de salida 6: "no hay nada registrado para el perfil... todavía" (solución de problemas). Un envío con --offline siempre se rechaza.

Su salud, una copia de seguridad, una restauración.Copy Anchor Link

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

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

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

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

wa personal store migrate              # bring the store up to this version's schema

• backup nunca sobrescribe un archivo: nombre uno nuevo. Copia mientras otros comandos y serve siguen usando el almacén local.
• restore mantiene el almacén local que reemplaza al lado y dice dónde. Se niega mientras se ejecuta serve para cualquier perfil (primero wa personal server stop) y verifica que la copia de seguridad sea un almacén legible y sin daños. Luego, reinicie cada serve y mcp de cualquier CLI de WireCat que se estuviera ejecutando, para que lean el almacén restaurado.
• migrate es necesario solo cuando info o check indican que el archivo está detrás de esta versión. Primero haga una copia de seguridad. Luego normaliza los mensajes más antiguos en lotes; detenerlo no pierde nada.
• Aquí nada regresa de WhatsApp. Un mensaje perdido del almacén local no se puede recuperar nuevamente; mantenga una copia de seguridad.

Reparación y mantenimiento de índicesCopy Anchor Link

wa personal store migrate crea índices sin terminar; wa 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.

Los lematizadores de la tienda son una configuración compartida: wa config set searchStemmers.latin english,spanish (el valor predeterminado) y searchStemmers.cyrillic russian; none desactiva uno. Ejecuta store rebuild según su propia elección. La configuración afecta a cada CLI de WireCat y a cada perfil; un proceso con perfil bloqueado no puede cambiarlo.

wa 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>. Detenga los procesos que utilizan el almacén local antes de una reparación.

La tienda y otras versionesCopy Anchor Link

El diseño de la tienda tiene una versión. Un wa más nuevo u otra CLI WireCat pueden actualizar el archivo; un wa más antiguo sigue funcionando con él mientras el cambio lo permita. Cuando no es así, cada comando que abre el almacén local dice:

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

Actualice wa, tg y max juntos para que usen la misma tienda.

SiguienteCopy Anchor Link

• Buscar: encuentra lo que contiene el almacén local.
• Recetas: busca y exporta en el trabajo diario de tu agente.
• Seguridad: qué significa el almacén local para la privacidad de tus mensajes.

Mantén copias de medios independientesCopy Anchor Link

Usa un archivo multimedia independiente cuando los archivos deban sobrevivir a mensajes eliminados o enlaces de descarga caducados. Mantiene los bytes en una carpeta que ti elija, con un manifiesto que registra la identidad, el tamaño y la suma de comprobación SHA-256 de cada archivo. Pregúntele a tu agente: "Haga una copia de seguridad de los archivos del grupo Ejemplo en mi archivo multimedia y luego verifique las copias".

WhatsApp sólo archiva los mensajes ya recibidos en el historial local. Mantén wa personal serve ejecutándose para recibir nuevos mensajes. Es posible que sea necesario volver a cargar una copia del servidor caducada en el teléfono, lo que puede fallar; no existe ninguna garantía de retención medida.

Guarde todos los chats disponibles o repita --chat para seleccionar varios. --since-time incluye mensajes en o después de una marca de tiempo ISO con una zona horaria:

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

El resultado informa los archivos guardados, las copias verificadas existentes y los chats visitados. Una nueva ejecución verifica todas las copias existentes y descarga las identidades faltantes. Los archivos tienen nombres .bin basados ​​en identidad; sus manifiestos identifican el chat, el mensaje y la posición del archivo adjunto. No se guarda ninguna URL de descarga, clave multimedia ni nombre de archivo original en un manifiesto. Estas copias independientes no se registran como rutas retenidas en el almacén de mensajes; utilice messages download normal para los archivos que desea que encuentre attachments show o extracción de texto.

Una ejecución de corte mantiene los archivos completos. Ejecuta el mismo comando nuevamente: un archivo interrumpido se reinicia desde el byte cero, porque las transmisiones de Messenger no proporcionan los validadores necesarios para agregarlos de manera segura. Una descarga fallida se detiene con un error; un archivo no disponible no se cuenta como guardado. Un archivo archivado faltante o modificado hace que la verificación falle con un código de salida distinto de cero y detiene el archivado posterior. Elige un nuevo destino; Los archivos existentes nunca se sobrescriben. complete: true cubre el historial disponible para el lector seleccionado, no prueba que todos los archivos fuente antiguos todavía existan.

Realice una copia de seguridad diaria en LinuxCopy Anchor Link

Las copias de seguridad diarias están desactivadas hasta que instale e inicie un temporizador de usuario de systemd. La instalación no comienza nada:

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

El temporizador se ejecuta con el ejecutable capturado, el perfil y las ubicaciones de los archivos, un tiempo de espera de seis horas y permisos de archivos exclusivos del propietario. El valor predeterminado es las 03:00 UTC; --timezone Europe/Madrid elige esa zona horaria local. La configuración del servicio de usuario de su sistema determina si se ejecuta mientras ti está desconectado; Las carreras perdidas se recuperan cuando el cronómetro comienza la próxima vez. macOS y Windows pueden ejecutar el comando de descarga manualmente.

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

Stop evita ejecuciones futuras; finaliza una descarga que ya se está ejecutando. La desinstalación requiere un temporizador inactivo y deshabilitado y un servicio inactivo y mantiene el archivo. Usa el mismo perfil y destino para estos comandos. Para cambiar la programación o el ejecutable, deténgalo, desinstale e instale nuevamente; Los archivos de unidades editados se conservan.

Después de una copia de seguridad, attachments check debería informar todos los archivos válidos. Para obtener texto buscable de descargas normales, continúe con archivos adjuntos.

Mover imágenes más antiguas a otro archivoCopy Anchor Link

Para mantener pequeña la carpeta activa, mueva las imágenes anteriores a la fecha del mensaje elegida a otro archivo verificado. Usa otro disco para liberar espacio en el disco original. Vista previa primero:

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

El límite utiliza la fecha del mensaje, no la fecha de descarga, y excluye las imágenes exactamente en el límite. Las fotos y archivos con imagen tipo MIME se mueven; otros archivos permanecen. El destino se copia y verifica antes de eliminar los bytes de la imagen local. Los registros de reubicación pequeños permanecen en la carpeta original, por lo que las comprobaciones siguen a las copias y las descargas posteriores no las recuperan nuevamente. No se contacta con ningún mensajero.

Mantén el otro archivo disponible en su ruta registrada. Si está fuera de línea o una copia cambia, las comprobaciones fallan y las descargas se detienen en lugar de duplicar archivos silenciosamente. Repite un movimiento interrumpido para finalizarlo. Las imágenes de archivos borradores anteriores sin fecha de mensaje permanecen vigentes y se cuentan como undated; complete: false significa que esas imágenes no se pudieron seleccionar por edad. Los tiempos de modificación de archivos nunca se utilizan como sustitutos. La vista previa informa recuentos y bytes sin crear la carpeta de destino.