Zum Hauptinhalt springen

​
Warum Session-Disziplin wichtig ist

Sessions sind MineClawds Langzeitgedächtnis. Eine saubere Session-Praxis liefert bessere Antworten, weniger Kontextfehler und schnellere Wiederherstellung, wenn etwas schiefgeht.

​
Wie Sessions abgegrenzt sind

  • Sessions sind nach Owner-Key isoliert.
  • Spielerbefehle nutzen die Spieler-UUID als Owner-Key.
  • Konsolenbefehle verwenden den Namen der Befehlsquelle als Owner-Key.
  • Jeder Owner hat einen aktiven Session-Zeiger.
  • Alle Session-Befehle setzen OP-Berechtigungsstufe 2 voraus.

​
Täglicher Befehlsworkflow

ZielBefehlGUI-Alternative
Sauberen Kontext starten/mineclawd sessions newKlicke auf New Session in der Sessions-Ansicht.
Alle gespeicherten Sessions sehen/mineclawd sessions listÖffne Sessions im Overlay-Menü.
Aktiven Kontext wechseln/mineclawd sessions resume <session>Klicke auf eine Session-Zeile in der Sessions-Ansicht.
Veralteten Kontext entfernen/mineclawd sessions remove <session>—
Aktuellen Chatverlauf lesen/mineclawd historyScrolle im Overlay auf die Unterhaltung.
Fehlerhafte Vertex-Turns reparieren/mineclawd sessions repair [session]—
<session> akzeptiert entweder eine kurze ID wie 1a2b oder ein Token wie 1a2b-my-build-plan.
Bevorzuge die kurze Session-ID für Notizen, Skripte und Runbooks. Die ID bleibt stabil. Der Token-Titel kann sich nach einer besseren Generierung ändern.

​
Best practices für lange Aufgaben

  1. Nutze pro Ziel eine eigene Session, nicht eine für alles.
  2. Starte frische Sessions statt alten Verlauf endlos mitzunehmen.
  3. Führe /mineclawd sessions list vor resume, remove oder repair aus.
  4. Vermeide Änderungen an der Session, solange eine Anfrage noch läuft.
  5. Prüfe den Kontext mit /mineclawd history, bevor du etwas mit potenziell destruktiven Folgen machst.

​
/mineclawd history richtig nutzen

  • Das Verlauf-Buch zeigt Session-Token, Aktualisierungszeit und sichtbare Chat-Turns.
  • Der Befehl funktioniert nur für Spieler, nicht für die Konsole.
  • Die History-Buch-UI setzt MineClawd auf dem Client voraus.
  • Sehr lange Verläufe werden durch die Minecraft-Buchseiten begrenzt.
Wenn dein Client MineClawd nicht installiert hat, nutze sessions list plus aktuelle Chat-Logs als Fallback.

​
Recovery-Playbook

​
Anfrage fehlgeschlagen, Kontext soll bleiben

Nutze /mineclawd retry <token> aus der letzten Fehlermeldung. Retry-Tokens verfallen nach 30 Minuten.

​
Vertex-Function-Call-Mismatch

Führe aus: 
/mineclawd sessions repair
Oder ziele auf eine bestimmte Session: 
/mineclawd sessions repair <session>
repair normalisiert fehlerhafte Vertex-Funktionsaufrufe und speichert die reparierte Session.

​
Speicherorte der Session-Dateien

MineClawd speichert Sessions unter deinem Spielordner: 
mineclawd/
  sessions/
    <owner>/
      active.json
      <id>.json
  • active.json speichert die aktive Session-ID.
  • <id>.json enthält Metadaten und beide Provider-Verläufe (openAiHistory, vertexHistory).
  • Entfernst du die aktive Session, wählt MineClawd automatisch die zuletzt aktualisierte verbleibende Session. Gibt es keine mehr, wird der aktive Zeiger gelöscht.

​
Backup- und Bereinigungsstrategie

  1. Sichere mineclawd/sessions/, bevor du viele Sessions löschst.
  2. Entferne veraltete Sessions mit /mineclawd sessions remove <session>.
  3. Behalte pro Operator eine bekannte funktionierende Session für schnelles Rollback.
  4. Nutze /resources/technical-details, wenn du die Speicher-Interna prüfen musst.

​
Verwandte Seiten