knowledge-base/wiki/architecture/sqlite-pages-7.2.md

79 lines
5.1 KiB
Markdown
Raw Normal View History

---
title: "SQLite-Refactor & Pages-Konzept — OpenClaw 7.2"
category: architecture
tags: [openclaw, sqlite, pages, ui, architecture, 7.2]
source: clawcast-folge-5
created: 2026-07-24
---
# SQLite-Refactor & Pages-Konzept — Perspektivische Analyse
## Kontext
ClawCast Folge 5 (22.07.2026) mit Kevin (OpenAI, OpenClaw-Maintainer) und Patrick (OpenClaw Dev Team). Ankündigung für OpenClaw 7.2 (Beta 4, Release Ende Juli 2026).
## SQLite-Refactor
### Status Quo
- Transkripte und Session-Daten liegen als `transcript.jsonl` (append-only JSONL) im State-Directory
- Struktur: `~/.openclaw/transcripts/YYYY-MM-DD/<session>/transcript.jsonl`
- Pro Session eine JSONL-Datei — wächst ungebremst mit jedem Turn
- Nach 3 Monaten Betriebszeit: 200MB+ pro aktiver Session
- JSONL ist ineffizient für Queries, Suchen, GC — kein Index, kein Schema, kein Transactional Safety
### Was der Refactor bringt
- **Migration JSONL → SQLite**: Session-Transkripte werden in SQLite-Tabellen gespeichert statt in flachen JSONL-Files
- **Bereits vorhanden**: SQLite wird für per-agent runtime state verwendet (`agents/<agentId>/agent/openclaw-agent.sqlite`) — Backup nutzt bereits `VACUUM INTO` für sichere Snapshots
- **Auf den Transkript-Store erweitert**: Dieselbe Infrastruktur wird auf Session-Transkripte ausgeweitet
### Perspektivische Bedeutung
1. **Portabilität**: Eine `.sqlite`-Datei pro Session/Agent statt Tausender JSONL-Fragments. Kopierbar, migration-fähig, inspect-fähig.
2. **Query-fähig**: SQL-Queries statt `grep`/`awk` auf JSONL. Transkript-Suche, Message-Filterung, Zeitbereich-Queries — alles index-basiert.
3. **GC & Compression**: `VACUUM`, WAL-Checkpointing, Row-Level-Deletion statt "ganze Datei löschen oder behalten". Alte Turns können selektiv bereinigt werden.
4. **Transactional Safety**: ACID-Transaktionen — kein halb geschriebener Turn bei Crash, kein korrupter JSONL-Eintrag.
5. **Performance**: Index-basierte Lookups statt Full-Text-Scan. Besonders relevant bei langen Sessions (200MB+).
6. **Enterprise-Ready**: Backup-Mechanismus (VACUUM INTO) bereits etabliert. SQLite ist die Standard-Einbettungs-DB für Enterprise-Anwendungen.
### Was sich für User ändert
- **Kein manuelles JSONL-Cleanup mehr** — SQLite kümmert sich um GC
- **Schnellere Session-Loads** — nur relevante Rows werden geladen, nicht die ganze Datei
- **Bessere Backup-Story** — eine Datei pro Agent, nicht Tausende Fragmente
- **Tooling**: `sqlite3` CLI reicht für Inspektion, keine JSONL-Parser nötig
## Pages-Konzept
### Status Quo
- Control UI: Chat, Activity Tab, Split View, Sessions-Liste, Config-Editor
- Canvas (macOS) als Preview-Feature
- Keine persistenten Agent-Generated-UI-Widgets
- Agent-Output ist primär Text + Tool-Cards — flüchtig, nicht pinnbar
### Was das Pages-Konzept bringt
- **Agent-Generated Widgets**: Agenten generieren UI-Widgets (Excalidraw-Diagramme, Code-Snippets, Task-Boards, Metriken)
- **Persistente Seiten**: Widgets werden auf Seiten gepinnt — überleben Session-Ende
- **MCP Apps als Widget-Quelle**: Künftig können MCP-Server UI-Widgets beisteuern — Drittanbieter-Ecosystem
### Perspektivische Bedeutung
1. **OpenClaw wird vom Chat-Interface zum Agent-Generated-Dashboard**: Der Agent baut sich seine eigene UI basierend auf dem Task. Nicht mehr nur "Antworten lesen" — sondern "Dashboard betrachten".
2. **Multi-Modal-UI**: Excalidraw für Diagramme, Code-Widgets für Snippets, Task-Boards für Projekt-Tracking, Metriken-Widgets für Monitoring — alles auf einer Seite.
3. **MCP-Ecosystem**: Jeder MCP-Server kann ein Widget beisteuern. Das öffnet den Markt für Drittanbieter-UIs — ähnlich wie Notion-Embeds oder Obsidian-Canvas-Plugins.
4. **Enterprise-Ready**: Persistente Dashboards für Teams — nicht nur flüchtige Chat-Sessions. Ein Team kann eine "Seite" haben, die der Agent kontinuierlich pflegt.
5. **Identitätsstiftend**: Das ist die Eigenleistung von OpenClaw gegenüber reinen Harnesses (Codex). Harness = Motor. OpenClaw = Auto + Dashboard + Navigation. Pages sind das UX-Differenzierungsmerkmal.
### Was sich für User ändert
- **Agent-Output wird greifbar**: Statt Text im Chat-Verlauf zu suchen, wird das Ergebnis auf einer Seite gepinnt
- **Kontinuierliche Projektdashboards**: Agent pflegt eine Seite mit aktuellem Status, Diagrammen, Tasks
- **Drittanbieter-Widgets**: MCP-Server liefern nicht nur Tool-Results, sondern auch UI-Komponenten
## Querverweis: Stable Channel
- Monatliche stabile Version — nur Security- & Reliability-Fixes
- Für Enterprise mit längeren Upgrade-Zyklen
- Ankündigung Ende Juli 2026
- Siehe auch: [ClawCast Folge 5 Raw](../raw/youtube/2026-07-22_clawcast-folge5-sqlite-pages.md)
## Fazit
SQLite-Refactor und Pages-Konzept sind die beiden architektonischen Schritte, die OpenClaw von einem "Chat-basierten Agent-Runner" zu einer "Agent-Plattform mit persistenter UI und Enterprise-Grade Storage" machen. SQLite löst das Storage-Problem (JSONL-Bloat, GC, Portabilität), Pages löst das UI-Problem (flüchtige Chat-Outputs → persistente Agent-Generated-Dashboards). Beide zusammen machen OpenClaw Enterprise-ready.