OpenClaw

A quién va dirigido e interfaz concreta

Esta guía conecta agentes de OpenClaw a la memoria persistente de XMemo. OpenClaw opera a través de una arquitectura de dos capas: el complemento de memoria nativo de OpenClaw en ClawHub proporciona vinculación de herramientas en tiempo de ejecución, mientras que la Skill complementaria ofrece orientación de recall proactivo y puntos de control de sesión.

Requisitos previos

Asegúrese de que las siguientes dependencias y herramientas estén presentes antes de conectar:

• Tiempo de ejecución del agente OpenClaw instalado y operativo.
• Acceso a paquetes de ClawHub habilitado.
• Cuenta válida de XMemo en https://xmemo.dev.
• Tiempo de ejecución de Node.js versión 22.22.0 o superior al instalar la Skill complementaria.

Ruta recomendada: Complemento nativo más Skill complementaria

La ruta recomendada instala el complemento de memoria nativo de OpenClaw desde ClawHub y la Skill complementaria directamente a través de la gestión de paquetes de OpenClaw:

openclaw plugins install clawhub:@xmemo/openclaw-memory
openclaw skills install @xmemo/xmemo

Opciones de autorización y credenciales

Configure credenciales mediante variables de entorno o inicio de sesión interactivo de dispositivo. Nunca use inicio de sesión directo sin elegir primero su ruta de almacenamiento de credenciales:

• Credencial de entorno (recomendado): Establezca XMEMO_KEY en el shell o en el entorno de servicio que inicia OpenClaw.
• Inicio de sesión interactivo: Si utiliza la Skill complementaria, ejecute login con --allow-plaintext solo cuando secret-store XMEMO_KEY no esté disponible (tenga en cuenta que --allow-plaintext almacena la credencial sin cifrar en este equipo).
• Verificar credenciales: Ejecute openclaw plugins list para confirmar la activación del complemento y verifique el estado de autenticación con la Skill complementaria.

Ruta alternativa: Ejecutor de servicio headless

Para ejecutores de OpenClaw headless o canalizaciones de CI automatizadas, pase XMEMO_KEY directamente mediante variables de entorno al complemento sin solicitudes interactivas.

export XMEMO_KEY='<your-xmemo-token>'
openclaw run --plugin @xmemo/openclaw-memory

Comprobación de conexión (solo lectura)

Verifique siempre la conectividad con una solicitud de solo lectura antes de escribir datos. Esta comprobación no modifica el estado de la memoria.

• Comprobación: Inicie una sesión de prueba de OpenClaw y emita una consulta de recall activo para el contexto existente del proyecto.
• Señal de éxito: OpenClaw devuelve resultados de memoria estructurados con campos Reference y Location válidos desde el espacio de trabajo autorizado.

Primera tarea útil: Ciclo de vida de memoria sintética

Verifique la persistencia de la memoria, la transición de sesión sin estado, el recall con atribución de origen y la corrección:

• 1. Guardar hecho sintético: Almacene una convención de proyecto ("Demo project timestamps use UTC.") en "projects/demo-onboarding/conventions".
• 2. Transición sin estado: Finalice la conversación actual de OpenClaw e inicie una nueva sesión.
• 3. Recall con atribución de origen: Consulte "demo project timestamp format". Confirme Reference y Location devueltos.
• 4. Corregir memoria: Actualice la convención recordada con formato ISO 8601.
• 5. Limpieza opcional: Realice un borrado suave de la convención de demostración cuando se complete la verificación de incorporación.

Capacidades y flujos de trabajo de memoria

Los flujos de trabajo de OpenClaw agrupan acciones por resultado en todas las sesiones del agente:

• Recall activo proactivo: Inyecta automáticamente recuerdos duraderos relevantes en el contexto activo antes de planificar.
• Continuidad de sesión: Guarda y restaura instantáneas de reinicio, rastrea decisiones y mantiene TODOs a través de traspasos.
• Capa de resiliencia: Caché de recall de corta duración y bandeja de salida de escritura transitoria gestionan interrupciones breves de red.

Limitaciones y límites

Restricciones operativas para la integración de OpenClaw:

• Aislamiento del espacio de trabajo: Cada operación está estrictamente delimitada al espacio de trabajo del usuario autenticado.
• Disponibilidad de ClawHub: Los registros de terceros no probados o las bifurcaciones no oficiales del complemento se marcan como no probados.
• Ámbito del libro mayor: Los resúmenes mensuales del libro mayor y las herramientas de auditoría financiera requieren alcances comerciales dedicados.

Recuperación, actualización y eliminación

Procedimientos de solución de problemas y mantenimiento para OpenClaw:

• Recuperación (complemento no cargado): Ejecute openclaw plugins list y revise los registros de OpenClaw en busca de errores de inicialización.
• Recuperación (autenticación caducada): Vuelva a exportar un XMEMO_KEY válido o vuelva a autenticarse a través de la Skill complementaria.
• Actualización: Para actualizar los complementos y skills instalados, consulte la documentación de administración de complementos de OpenClaw.
• Eliminación: Para eliminar o deshabilitar complementos y skills instalados, consulte la documentación de administración de complementos de OpenClaw.