# OpenClaw

Conecte OpenClaw a través de su complemento de memoria nativo en ClawHub con guía complementaria de Skill para recall proactivo.

- Canonical: https://docs.xmemo.dev/es/docs/connect/openclaw
- Locale: es-ES
- Content-Locale: es-ES
- Canonical-Content-Digest: c1ce97e0231b187bac1701fceb894f880bb49f8d6d6dc391398e5decdaf4ff3f
- Edition-Digest: 837d8d72047c1df9329fd09e2a69a5145002909b67213dbe1e8e72ca76e6529b
- Source-Revision: sha256:8f465eb1d6ca0b120934289273aff9d3c032c43de12f628d3bf82b19ef4657b5

## 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:

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

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

## OpenClaw

Direct client: configure in ~/.openclaw/openclaw.json with XMEMO_KEY in the environment. Run npx @xmemo/client mcp add openclaw to install automatically.

```
{
  "mcpServers": {
    "XMemo": {
      "url": "https://xmemo.dev/mcp",
      "headers": {
        "Authorization": "Bearer ${env:XMEMO_KEY}",
        "X-Memory-OS-Agent-ID": "openclaw",
        "X-Memory-OS-Agent-Instance-ID": "${XMEMO_AGENT_INSTANCE_ID}"
      }
    }
  }
}
```