Esquemas de bases de datos

​

Distribución de las bases de datos

​

Contrato de versionado

• PRAGMA user_version es la versión del esquema SQLite.
• La fila principal de schema_meta registra role, agent_id, schema_version y app_version. app_version es la compilación de OpenClaw que escribió por última vez los metadatos del esquema.

​

Historial del esquema de agentes

​

Historial del esquema de estado

​

Comprobaciones de integridad

​

Solución de problemas

​

Por qué no se puede volver atrás después de actualizar a 2026.7.2

1. Restaure una copia de seguridad creada antes de la actualización. Cree y verifique copias de seguridad antes de realizar actualizaciones importantes.
2. Ejecute la compilación anterior con un directorio de estado distinto (OPENCLAW_STATE_DIR). Se iniciará desde cero; los datos migrados permanecerán intactos para cuando vuelva a la compilación más reciente.
3. Siga el procedimiento manual de reversión que se describe a continuación. No se admite y conlleva riesgo de pérdida de datos si no se dispone de una copia de seguridad verificada.

​

El Gateway se niega a iniciarse debido a un error de versión de esquema más reciente

​

Una base de datos se pone en cuarentena tras fallar la verificación de integridad

​

No se admiten las reversiones

1. Lea el esquema y las migraciones de la versión de destino.
2. En una sola transacción, elimine todas las tablas, índices, desencadenadores y columnas introducidos después de la versión de destino.
3. Establezca PRAGMA user_version y schema_meta.schema_version en la versión de destino.
4. Ejecute la verificación completa de la base de datos de la versión de destino antes de iniciar el Gateway.

​

Ejemplo: esquema de agentes 11 a 9

BEGIN IMMEDIATE;

DROP TABLE IF EXISTS heartbeat_outcomes;
DROP TABLE IF EXISTS conversation_deliveries;
DROP TABLE IF EXISTS state_leases;
DROP TABLE IF EXISTS session_transcript_active_events;

ALTER TABLE session_transcript_index_state DROP COLUMN active_event_count;
ALTER TABLE session_transcript_index_state DROP COLUMN active_message_count;
ALTER TABLE conversations DROP COLUMN delivery_target;

PRAGMA user_version = 9;
UPDATE schema_meta
SET schema_version = 9,
    updated_at = unixepoch('now') * 1000
WHERE meta_key = 'primary';

COMMIT;