Lược đồ cơ sở dữ liệu

​

Bố cục cơ sở dữ liệu

​

Hợp đồng lập phiên bản

• PRAGMA user_version là phiên bản lược đồ SQLite.
• Hàng schema_meta chính ghi lại role, agent_id, schema_version và app_version. app_version là bản dựng OpenClaw gần nhất đã ghi siêu dữ liệu lược đồ.

​

Lịch sử lược đồ tác nhân

​

Lịch sử lược đồ trạng thái

​

Kiểm tra tính toàn vẹn

​

Khắc phục sự cố

​

Tại sao không thể quay lại sau khi cập nhật lên 2026.7.2

1. Khôi phục bản sao lưu được tạo trước khi cập nhật. Tạo và xác minh bản sao lưu trước các bản cập nhật lớn.
2. Chạy bản dựng cũ hơn với một thư mục trạng thái riêng (OPENCLAW_STATE_DIR). Nó sẽ khởi động mới hoàn toàn; dữ liệu đã di chuyển của bạn vẫn nguyên vẹn để dùng khi quay lại bản dựng mới hơn.
3. Làm theo quy trình hạ cấp thủ công bên dưới. Quy trình này không được hỗ trợ và có nguy cơ mất dữ liệu nếu không có bản sao lưu đã được xác minh.

​

Gateway từ chối khởi động với lỗi phiên bản lược đồ mới hơn

​

Cơ sở dữ liệu bị cách ly sau khi xác minh tính toàn vẹn thất bại

​

Không hỗ trợ hạ cấp

1. Đọc lược đồ và các quá trình di chuyển của bản phát hành đích.
2. Trong một giao dịch, xóa mọi bảng, chỉ mục, trình kích hoạt và cột được bổ sung sau phiên bản đích.
3. Đặt PRAGMA user_version và schema_meta.schema_version thành phiên bản đích.
4. Chạy quy trình xác minh toàn bộ cơ sở dữ liệu của bản phát hành đích trước khi khởi động Gateway.

​

Ví dụ: lược đồ tác nhân 11 xuống 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;