hector-bot/knowledge-base
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
knowledge-base/wiki/architecture/sqlite-pages-7.2.md

5.1 KiB
Raw Blame History

title category tags source created
SQLite-Refactor & Pages-Konzept — OpenClaw 7.2 architecture
openclaw
sqlite
pages
ui
architecture
7.2
clawcast-folge-5 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

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.