Otto
08d21f8087
- tests/test_core.py: 6 Unit-Tests (alle grün) - README.md: Vollständige Dokumentation - HEARTBEAT.md: Proaktivitäts-Checkliste - Cron: Backup täglich 2 Uhr Closes #1, #6
89 lines
3.3 KiB
Markdown
89 lines
3.3 KiB
Markdown
# 🧠 Second Brain
|
|
|
|
Zweites Gehirn für OpenClaw - Langzeit- und Kurzzeitgedächtnis mit Bewertung, Proaktivität und Selbstheilung.
|
|
|
|
## Features
|
|
|
|
- **Engramme** - Gedächtniseinheiten mit Confidence, Korrektheit, Verknüpfungen
|
|
- **SQLite + FTS5** - Lokaler Speicher ohne externe Abhängigkeiten
|
|
- **Hybrid-Retrieval** - Keyword-Suche + Reranking (später + Embeddings)
|
|
- **Correctness-Tracking** - Richtig/Falsch-Feedback mit Lern-Loop
|
|
- **Proaktivität** - Heartbeat + Cron für selbständige Checks
|
|
- **Fehlerheilung** - Fehler als Engramme, Mustererkennung, Auto-Fix
|
|
- **Dashboard** - HTML-Visualisierung, kein Framework nötig
|
|
- **OpenClaw-Bridge** - Direkte Integration in Agent-Sessions
|
|
|
|
## Schnellstart
|
|
|
|
```bash
|
|
cd /root/.openclaw/workspace/second-brain
|
|
|
|
# Engramm hinzufügen
|
|
python3 -m src.cli add "Das ist wichtig" --tag wichtig --source user
|
|
|
|
# Suchen
|
|
python3 -m src.cli search "wichtig"
|
|
|
|
# Feedback geben
|
|
python3 -m src.cli confirm <id>
|
|
python3 -m src.cli reject <id>
|
|
|
|
# Dashboard öffnen
|
|
python3 -m src.dashboard
|
|
|
|
# Stats
|
|
python3 -m src.cli stats
|
|
|
|
# Backup
|
|
python3 -m src.openclaw_bridge backup
|
|
|
|
# Tests
|
|
python3 -m tests.test_core
|
|
```
|
|
|
|
## Architektur
|
|
|
|
```
|
|
┌─────────────────┐ ┌──────────────┐ ┌────────────────┐
|
|
│ OpenClaw │────▶│ Bridge │────▶│ Engram Store │
|
|
│ Agent │ │ (Session) │ │ (SQLite) │
|
|
└─────────────────┘ └──────────────┘ └────────────────┘
|
|
│ │
|
|
▼ ▼
|
|
┌─────────────────┐ ┌──────────────┐
|
|
│ Heartbeat │ │ Retriever │
|
|
│ (Cron/Check) │ │ (FTS + RR) │
|
|
└─────────────────┘ └──────────────┘
|
|
│
|
|
▼
|
|
┌──────────────┐
|
|
│ Dashboard │
|
|
│ (HTML) │
|
|
└──────────────┘
|
|
```
|
|
|
|
## Module
|
|
|
|
| Datei | Zweck |
|
|
|-------|-------|
|
|
| `src/engram.py` | Engramm-Modell, Confidence, Correctness |
|
|
| `src/store.py` | SQLite-CRUD, FTS5-Index, Backup/Export |
|
|
| `src/retriever.py` | Suche, Reranking, Verknüpfungen |
|
|
| `src/cli.py` | Kommandozeilen-Interface |
|
|
| `src/openclaw_bridge.py` | OpenClaw-Integration, Heartbeat, Fehler-Handling |
|
|
| `src/dashboard.py` | HTML-Dashboard-Generator |
|
|
|
|
## CI/CD
|
|
|
|
- **Repo**: http://192.168.6.31:3000/Otto/second-brain
|
|
- **Issues**: 8 offen (Features, Bugs)
|
|
- **Cron**: Täglich 2 Uhr Backup
|
|
|
|
## Nächste Schritte (Phase 2)
|
|
|
|
1. Vektor-Embeddings via sentence-transformers
|
|
2. ChromaDB-Store als Alternative zu SQLite
|
|
3. PyTorch Neural Scorer
|
|
4. Streamlit-Dashboard
|
|
5. Graph-Visualisierung (cytoscape.js)
|