---
created: 2026-06-16
updated: 2026-06-16
sources: []
tags: [decisions, architecture, infrastructure, docker, persistence]
---

# Entscheidung: Volume-Persistenz nach LanceDB-Havarie

> Datum: 2026-04-06 | Betroffen: Infrastruktur

## Problem

Drei Container-Resets (4.-6. April 2026) durch LanceDB-Installation ohne persistentes Volume → Workspace-Datenverlust.

## Entscheidung

1. **Volume `bot_workspace_2`** dauerhaft mounten auf `/home/node/workspace`
2. Provisioning-Reihenfolge: Volume → `chown -R node:node` → Stateful Plugins installieren
3. Alle persistenten Daten (Config, memory/, `.openclaw/`) müssen auf dem Volume liegen
4. ByteRover `.brv-cli` benötigt separates Volume für OAuth-Tokens (🔴 nie umgesetzt)

## Status

- ✅ Volume funktioniert, Permission-Fix dokumentiert
- ❌ `.brv-cli`-Volume nie deployed → OAuth-Token weiterhin Container-lebensdauer
- ❌ ByteRover Knowledge Mining blockiert seit 2026-04-11
## Hintergrund — Warum das passierte

Vor dieser Entscheidung lief der Bot-Container mit einem **ephemeren Filesystem** — kein persistentes Volume, kein Bind-Mount. Drei Probleme häuften sich in der ersten Aprilwoche:

1. **LanceDB-Installation am 2026-04-04** verursachte einen Container-Reset, weil das Datenverzeichnis `~/.lancedb` auf dem Container-Filesystem lag und beim Rebuild verloren ging.
2. **Memory-System (Schicht 3)** baute auf LanceDB auf — Reset bedeutete Totalverlust des Vektor-Index.
3. **OAuth-Tokens** (ByteRover `.brv-cli`, Subconscious-Plugin-Tokens) wurden gleich mitverloren.

Die Entscheidung am 2026-04-06 zog daraus die Konsequenz: **alles, was über Container-Lebensdauer hinaus leben soll, gehört auf ein gemountetes Volume** — nicht "manchmal" oder "für wichtige Daten", sondern ausnahmslos.

## Konsequenzen

Die strikte Volume-Pflicht wurde zur Grundlage für alle späteren Architekturentscheidungen: Memory-System, Wiki-Repository, Plugin-State. Siehe [[../architecture/container-volume-persistence.md]] für die allgemeinen Lessons Learned und [[../architecture/byterover-knowledge-mining.md]] für die konkrete Pipeline, die an genau dieser Lücke scheiterte.

## Verwandte Seiten

- [[../architecture/container-volume-persistence.md]] — ausführliche Lessons-Learned
- [[../architecture/memory-system.md]] — Memory-Schichten, die alle auf dem Volume liegen
- [[../architecture/byterover-knowledge-mining.md]] — Pipeline, die an fehlendem `.brv-cli`-Volume starb