Cómo conectar la memoria del agente TencentDB a OpenClaw: memoria local a largo plazo, compresión de registros y recuperación rastreable

Una vez que una tarea larga de OpenClaw abarca varias rondas de llamadas a herramientas, generalmente surgen dos problemas: el contexto se atasca con registros o las nuevas sesiones requieren una reinterpretación de las convenciones del proyecto. TencentDB Agent Memory proporciona memoria local a largo plazo y compresión de registros a corto plazo para OpenClaw: SQLite + sqlite-vec se utiliza de forma predeterminada para organizar jerárquicamente información a largo plazo; Una vez habilitada la descarga, el resultado completo de la herramienta se guarda en un archivo externo y solo se inyecta en el contexto un estado simbólico optimizado. Almacén oficial del proyecto

Este artículo sólo trata sobre el acceso a OpenClaw. El objetivo clave no es “hacer que el agente recuerde todo”, sino que pueda recuperar datos cuando sea necesario y permitirle rastrear resúmenes de alto nivel hasta la conversación original o el registro de la herramienta.

Confirma dos cosas antes de la instalación.

1. Actualmente OpenClaw puede iniciar y ejecutar conversaciones básicas con normalidad; Primero resuelva los problemas de modelo, permiso o puerta de enlace y luego agregue el complemento de memoria.
2. Conoce la ubicación de la copia de seguridad y los límites de acceso a los datos locales. La memoria puede contener contexto del proyecto, registros de tareas y resultados de herramientas y no debe tratarse como una memoria caché temporal y no relacionada.

Al acceder por primera vez, se recomienda habilitar primero solo la memoria a largo plazo y luego habilitar la compresión de registros después de confirmar que la recuperación es correcta. De esta manera, una vez que ocurre un error, se puede determinar claramente si se debe a la extracción, recuperación o configuración de descarga de memoria.

Instalar y habilitar complementos

Instale usando el comando del complemento nativo OpenClaw:

1
2

openclaw plugins install @tencentdb-agent-memory/memory-tencentdb
openclaw gateway restart

Las actualizaciones posteriores también deben utilizar el comando de actualización de complementos de OpenClaw para evitar que los complementos se deshabiliten debido al rango de versión semántica:

1

openclaw plugins update @tencentdb-agent-memory/memory-tencentdb

Habilitado en ~/.openclaw/openclaw.json:

1
2
3
4
5

{
  "memory-tencentdb": {
    "enabled": true
  }
}

El archivo README oficial indica que el backend predeterminado es SQLite + sqlite-vec local. Cuando está habilitado, el complemento captura conversaciones, extrae recuerdos, agrega escenas, genera personajes y recuerda antes de la siguiente ronda; no requiere llamadas adicionales a API externas para la función de memoria.

Pruebe la memoria a largo plazo con un conjunto de hechos verificables

No se limite a preguntar: “¿Te acuerdas de mí?” Realice una prueba con respuestas y revisabilidad:

1
2
3

第 1 轮：告诉 Agent 当前项目的包管理器、测试命令和一条明确的输出约定。
第 2 轮：让它执行一个与这些约定相关的小任务。
新会话：询问测试命令和输出约定，并要求说明信息来源或不确定项。

Pasar la norma no significa que recitó más contenido, sino que recuperó correctamente los hechos y no agregó información que no existía sin autorización. Si los compromisos del proyecto han cambiado, los recuerdos antiguos deben actualizarse o borrarse en lugar de esperar que el modelo determine automáticamente cuáles están desactualizados.

Habilitar la compresión de registros a corto plazo (descarga)

La salida de herramientas, los resultados de búsqueda y las pilas de errores suelen ser las principales fuentes de sobrecarga de tokens para tareas largas. La función de descarga del proyecto moverá el registro completo a un archivo externo, dejando el diagrama de estado comprimido de Mermaid en contexto. Los requisitos oficiales requieren que las versiones de OpenClaw y del complemento sean al menos 0.3.4.

Abrir en la configuración del complemento:

1
2
3
4
5
6
7
8
9

{
  "memory-tencentdb": {
    "config": {
      "offload": {
        "enabled": true
      }
    }
  }
}

Luego registre la ranura del motor de contexto y deje que OpenClaw entregue la solicitud de descarga de contexto al complemento:

1
2
3
4
5
6
7

{
  "plugins": {
    "slots": {
      "contextEngine": "memory-tencentdb"
    }
  }
}

Finalmente, ejecute el parche proporcionado por el proyecto para que el mensaje after-tool-call pueda desinstalarse y restaurarse:

1

bash scripts/openclaw-after-tool-call-messages.patch.sh

Este parche sólo necesita ejecutarse una vez por instalación de OpenClaw; será necesario volver a aplicarlo después de una actualización de OpenClaw.

Cómo funciona la recuperación rastreable

La compresión de registros no debería equivaler a una pérdida de detalles. El enlace a corto plazo de TencentDB Agent Memory es:

1
2
3
4
5

完整工具日志 → refs/*.md
              ↓
步骤摘要 → jsonl 索引
              ↓
Mermaid 状态图（带 node_id）→ 注入 Agent 上下文

Cuando el Agente o usted necesitan verificar una conclusión, el resumen correspondiente y el registro original se pueden encontrar en el diagrama de estado de Mermaid en node_id. La memoria a largo plazo sigue una relación de profundización similar: Persona → Scenario → Atom → Conversation. Por lo tanto, al solucionar el problema “por qué el Agente lo recordó incorrectamente”, primero debe volver a la evidencia original en lugar de simplemente modificar el resumen final.

Tres comprobaciones de aceptación que deben realizarse después de la activación.

1. Recuerdo a largo plazo: recuperar correctamente un hecho de prueba en una nueva sesión y poder admitir elementos inciertos.
2. Rastreo de registros: ejecute una tarea de llamada de múltiples herramientas y confirme que la salida original aún se puede encontrar a través de node_id después de la compresión.
3. Protección contra fallas: Deje que una llamada a una herramienta falle deliberadamente y verifique si el mensaje de error, los registros originales y la siguiente ronda de recuperación aún son comprensibles.

Si solo ve el contexto abreviado pero no puede rastrear la información original, la descarga no debe usarse para tareas de producción importantes. La premisa de la compresión es ser recuperable, no reducir el token en sí.

Límites de seguridad para configuración y datos

El uso predeterminado del almacenamiento local no significa que se pueda ignorar la seguridad. Sugerencias:

1. Incorpore el directorio de datos de la memoria en el simulacro de copia de seguridad y recuperación cifrado.
2. No coloque claves en conversaciones, registros de herramientas o personas que no deban guardarse a largo plazo.
3. Después de actualizar OpenClaw o los complementos, utilice una sesión de prueba para confirmar que la extracción, recuperación y descarga de memoria no se degradan.
4. Revise periódicamente personas, escenarios y compromisos de proyectos antiguos para eliminar información desactualizada o confidencial.

Si desea implementar modelos locales compatibles con Hermes, Docker Gateway u OpenAI al mismo tiempo, puede leer [Descripción general de la implementación local de la memoria del agente TencentDB] (/es/2026/07/15/tencentdb-agent-memory-local-deployment-ollama-guide/).

Preguntas frecuentes

Si aún olvida el acuerdo del proyecto después de habilitarlo, ¿dónde debe verificar primero?

Primero confirme que el complemento esté habilitado, que la puerta de enlace se haya reiniciado y pruebe si realmente abarca una nueva sesión; luego verifique el momento de activación de la extracción de memoria y los permisos del directorio de almacenamiento. No confundas tus pruebas; utilice comandos, rutas o convenciones de salida verificables.

¿Por qué no puedo ver el registro completo después de la descarga?

El registro completo debe guardarse en un registro externo como refs/*.md sin inyectar completamente el contexto. Retroceda a través de node_id y el índice resumido en el diagrama de Sirena; Si el archivo no existe o no se puede leer, primero verifique si la ruta, los permisos y el parche se han aplicado correctamente.

¿Es necesario habilitar la descarga?

No. Sólo la memoria a largo plazo se puede utilizar para tareas breves o en las primeras etapas de depuración. Active la descarga solo si la salida de la herramienta realmente está causando un aumento del contexto y ha verificado que el vínculo de retroceso está intacto.

Resumen

La secuencia segura para acceder a la memoria del agente TencentDB es: primero instalar y habilitar el complemento OpenClaw, probar la recuperación a largo plazo con hechos verificables, luego activar la descarga según sea necesario, registrar el motor de contexto, aplicar parches y finalmente verificar si node_id puede regresar al registro original. El resultado es un sistema de memoria local auditable en lugar de un resumen automático no interpretable.