Veritabanı şemaları

​

Veritabanı düzeni

​

Sürümleme sözleşmesi

• PRAGMA user_version, SQLite şema sürümüdür.
• Birincil schema_meta satırı; role, agent_id, schema_version ve app_version değerlerini kaydeder. app_version, şema meta verilerini en son yazan OpenClaw derlemesidir.

​

Agent şema geçmişi

​

Durum şeması geçmişi

​

Bütünlük denetimleri

​

Sorun giderme

​

2026.7.2 sürümüne güncelledikten sonra neden geri dönemezsiniz?

1. Güncellemeden önce alınmış bir yedeği geri yükleyin. Büyük güncellemelerden önce yedekleri oluşturun ve doğrulayın.
2. Eski derlemeyi ayrı bir durum diziniyle (OPENCLAW_STATE_DIR) çalıştırın. Temiz bir başlangıç yapar; daha yeni derlemeye döndüğünüzde kullanabilmeniz için taşınmış verileriniz değiştirilmeden kalır.
3. Aşağıdaki elle sürüm düşürme prosedürünü izleyin. Bu prosedür desteklenmez ve doğrulanmış bir yedek olmadan veri kaybı riski taşır.

​

Gateway, daha yeni şema sürümü hatasıyla başlamayı reddediyor

​

Bütünlük doğrulaması başarısız olduktan sonra bir veritabanı karantinaya alındı

​

Sürüm düşürmeler desteklenmez

1. Hedef sürümün şemasını ve geçişlerini okuyun.
2. Tek bir işlem içinde, hedef sürümden sonra eklenen tüm tabloları, dizinleri, tetikleyicileri ve sütunları kaldırın.
3. PRAGMA user_version ve schema_meta.schema_version değerlerini hedef sürüme ayarlayın.
4. Gateway’i başlatmadan önce hedef sürümün tam veritabanı doğrulamasını çalıştırın.

​

Örnek: agent şeması 11’den 9’a

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;