Was macht Seelenlader?
Archivierte Integration (2026). Der agentbox Soul Store wurde unabhängig und die von dieser Version referenzierten
agentbox.id-Verteilungsendpunkte werden nicht mehr unterstützt. Führen Sie die untenstehenden historischen Download-Anweisungen nicht aus, ohne zuvor das aktuelle SoulTavern Repository zu überprüfen. Diese Datei wird aufbewahrt, um den Bootstrap-Flow zu dokumentieren, den agentbox ausgeliefert hat.
Installieren Sie die Fähigkeit zum Laden von Seelen in Ihre Laufzeitumgebung.
Nachdem diese Fähigkeit ausgeführt wurde, kann Ihr Mensch Ihnen eine SillyTavern V2-Charakterkarte (.png oder .json) geben – hochgeladen im Chat oder per URL verlinkt – und Sie importieren diese in den Identitätsslot des Agenten: SOUL.md, mit zielspezifischen Begleitdateien daneben.
Dies war der agentbox soul-loader. Die zugrunde liegende Engine ist SoulTavern, ein MIT-lizenzierter Multi-Ziel-Importer aus der Linie TavernAI -> SillyTavern -> HermesTavern -> SoulTavern. agentbox hat SoulTavern weder gekauft noch modifiziert; der Wrapper hat das upstream-Projekt installiert und delegiert.
SoulTavern v2.0 ist ein einzelner, in sich geschlossener Fähigkeitenordner, der dem Claude skills-Ordnerlayout folgt. Dieselben Installationsmethoden funktionieren in jeder Laufzeitumgebung, die ein Fähigkeitenverzeichnis scannt (Hermes, OpenClaw, Claude Code, In-House-Frameworks). Was sich pro Laufzeitumgebung ändert, ist wo der soultavern/-Ordner landet. SoulTavern wählt pro Import das richtige Ziel (hermes / openclaw / generic).
Wann diese Fähigkeit verwendet werden sollte
- Ihr Mensch möchte Ihnen eine Persönlichkeit / einen Charakter geben, der auf einer echten SillyTavern V2-Karte basiert
- Sie laufen in einer Claude-skills-kompatiblen Laufzeitumgebung und SoulTavern ist noch nicht installiert
- Sie untersuchen, wie die ehemalige agentbox-Integration eine SillyTavern V2-Karte verarbeitet hat
Wann diese Fähigkeit NICHT verwendet werden sollte
- SoulTavern ist bereits installiert – fahren Sie mit „Tägliche Nutzung“ fort
- Ihr Mensch möchte einfach nur ein Rollenspiel ohne Karte – er kann Ihnen eine Persönlichkeit in Klartext geben; dafür brauchen Sie keine
SOUL.md - Ihre Laufzeitumgebung hat kein Fähigkeitenverzeichnis oder folgt nicht dem Claude skills-Layout – siehe „Andere Laufzeiten“ unten
Schritt 0 – Erkennen Sie Ihre Laufzeitumgebung
Identifizieren Sie, in welcher Laufzeitumgebung Sie eingebettet sind, damit Schritte 1 und 2 das richtige Fähigkeitenverzeichnis ansteuern können.
command -v hermes 2>/dev/null # Hermes
command -v openclaw 2>/dev/null # OpenClaw
command -v claude 2>/dev/null # Claude Code
| Laufzeit | Fähigkeitenverzeichnis |
|---|---|
| Hermes | $HERMES_HOME/skills/ (oder Hub-verwaltet) |
| OpenClaw | ~/.openclaw/workspace/skills/ |
| Claude Code | ~/.claude/skills/ |
| Andere | Dort, wo Ihre Laufzeitumgebung nach skills/<name>/SKILL.md sucht |
Wenn keines von hermes, openclaw, claude im PATH ist und Sie nicht sicher sind, wo Ihre Laufzeitumgebung lebt, fragen Sie Ihren Menschen oder lesen Sie die Doku der Laufzeit. Die Installation von SoulTavern v2.0 bedeutet einfach, den soultavern/-Ordner in das Fähigkeitenverzeichnis Ihrer Laufzeit zu legen – überall, wo nach dem Claude skills-Layout gesucht wird, funktioniert es.
Schritt 1 – Prüfen, was bereits installiert ist
Idempotenz-Gatter. Überspringen Sie Schritt 2, wenn
soultavern/bereits im Fähigkeitenverzeichnis Ihrer Laufzeit ist.
Suchen Sie nach soultavern/SKILL.md in dem in Schritt 0 identifizierten Verzeichnis:
# Welche Laufzeit auch immer zutrifft:
ls "$HERMES_HOME/skills/soultavern/SKILL.md" 2>/dev/null
ls "$HOME/.openclaw/workspace/skills/soultavern/SKILL.md" 2>/dev/null
ls "$HOME/.claude/skills/soultavern/SKILL.md" 2>/dev/null
| Ergebnis | Aktion |
|---|---|
| Ein Pfad ausgegeben | SoulTavern ist installiert. Springen Sie zu Tägliche Nutzung. |
Alle leer / No such file | Fahren Sie mit Schritt 2 fort. |
Wenn Sie unsicher sind, welches Verzeichnis zutrifft, fahren Sie einfach mit Schritt 2 fort – alle Installationsmethoden sind idempotent (erneutes Ausführen überschreibt mit identischem Inhalt, kein Schaden).
Schritt 2 – Historische Installationspfade
Die Befehle in diesem Abschnitt dokumentieren die Auslieferungsmethoden von Version 0.3. Bestätigen Sie aktuelle Release-Namen, Anforderungen und Installationspfade mit SoulTavern upstream, bevor Sie sie ausführen.
Drei Installationspfade. Alle installieren denselben soultavern/-Fähigkeitenordner; sie unterscheiden sich nur in der Auslieferung.
Option A – Vorgebautes Release-Zip (empfohlen für Chat-Upload-Laufzeiten)
Laden Sie das gebündelte Zip aus dem neuesten GitHub-Release von SoulTavern herunter:
curl -LO https://github.com/imphillip/SoulTavern/releases/latest/download/soultavern-skills.zip
Geben Sie soultavern-skills.zip an Ihren Menschen. Bitten Sie ihn, es im Chat Ihrer Laufzeit mit der Nachricht hochzuladen:
installiere diese Fähigkeit
Das Zip enthält einen skills/soultavern/-Ordner im Claude skills-Layout. Jede Claude-skills-kompatible Laufzeit (Hermes, Claude Code, …) erkennt es und platziert es korrekt. Nach dem Upload bestätigt Ihre Laufzeit die Installation – das ist Ihre Überprüfung.
Option B – Direktes Kopieren (universell, laufzeitunabhängig)
Wenn Sie Shell-Zugriff auf dem Host haben, auf dem Ihre Laufzeit läuft, ist dies der direkteste Weg:
git clone https://github.com/imphillip/SoulTavern.git
cp -r SoulTavern/skills/soultavern <IHR_LAUFZEIT_FAEHIGKEITEN_VERZEICHNIS>/
Wobei <IHR_LAUFZEIT_FAEHIGKEITEN_VERZEICHNIS> der in Schritt 0 identifizierte Pfad ist ($HERMES_HOME/skills/, ~/.openclaw/workspace/skills/, ~/.claude/skills/ oder wo auch immer Ihre Laufzeit sucht).
Einzige Voraussetzung: Python ≥ 3.10. Nur Standardbibliothek – keine Drittanbieter-Python-Abhängigkeiten. Dies ist der Pfad, den SoulTaverns README kanonisch dokumentiert.
Option C – Hermes Hub
Hermes Hub-Benutzer haben eine Einzeiler-Abkürzung:
hermes skills tap add imphillip/SoulTavern
hermes skills install soultavern
Gleicher Fähigkeitenordner, andere Auslieferung. Überprüfen Sie mit:
ls "$HERMES_HOME/skills/soultavern/SKILL.md"
Schritt 3 – Bestätigen Sie mit Ihrem Menschen
Sagen Sie Ihrem Menschen (bei Bedarf umschreiben):
„SoulTavern ist installiert. Wenn Sie von jetzt an eine SillyTavern V2-Karte (
.pngoder.json) haben, laden Sie sie im Chat hoch und sagen Sie mir, was Sie möchten – zum Beispiel 'installiere diesen Charakter' oder 'wechsel zu alice'. Ich kümmere mich um den Rest.“
Das war's. Ab jetzt ist die UX gesprächsbasiert.
Tägliche Nutzung (nach der Installation)
Sobald SoulTavern installiert ist, ist der Seelenlader fertig. Diese Fähigkeit ist in erster Linie der Installations-/Bootstrap-Prompt; die laufenden Kartenimport-/Wechsel-/Zurücksetzungsverhalten gehören zur installierten Fähigkeit von SoulTavern.
Typische Beispiele nach der Installation:
| Was Ihr Mensch sagt | Was es verarbeiten soll |
|---|---|
Installiere diese Seele: <direkte-Karten-oder-Zip-URL> | Historischer SoulTavern-Import-Flow: URL abrufen, mit dem richtigen --target importieren, SOUL.md und zielspezifische Begleitdateien schreiben, dann Ihrem Menschen sagen, die Sitzung neu zu starten. |
[card.png angehängt] installiere diesen Charakter | SoulTavern-Import-Flow für den Anhang; erstellt SOUL.md und zielspezifische Begleitdateien; sagt Ihrem Menschen, die Sitzung neu zu starten, damit die neue Identität geladen wird. |
wechsel zu alice | SoulTaverns Bibliotheksverwaltungs-Flow – wechselt die aktive Karte und schreibt die neue SOUL.md. |
vergiss alle Charaktere, zurück zur Standardeinstellung | SoulTavern-Zurücksetzungs-/Standardidentitäts-Flow. |
Wenn SoulTavern noch nicht installiert ist, kehren Sie zu Schritt 2 zurück. Wenn die Kartenaktion mehrdeutig ist, klären Sie in Klartext.
Was der Seelenlader NICHT tut
- Wählt oder durchsucht keine Karten im Namen Ihres Menschen. Ihr Mensch stellt entweder eine Kartendatei oder eine direkte V2-Karten-/ZIP-URL zur Verfügung.
- Ersetzt nicht SoulTavern. Der Seelenlader installiert/bootet SoulTavern; SoulTavern führt die eigentlichen Import-, Wechsel- und Zurücksetzungsvorgänge nach der Installation durch.
- Konfiguriert nicht Ihre Kanalebene (Telegram, Discord, etc.). Die wird vor dieser Fähigkeit eingerichtet.
- Bearbeitet nicht Ihre vorhandene
SOUL.mdaußerhalb des SoulTavern-Import-/Wechsel-/Zurücksetzungs-Flows. - Koppelt nicht an
agentbox.id-Mailbox. Der Seelenlader läuft ohne eine agentbox-Mailbox.
Andere Laufzeiten
soul-loader v0.3 unterstützt jede Laufzeit, die dem Claude skills-Ordnerlayout folgt – mindestens Hermes, OpenClaw und Claude Code. SoulTavern v2.0 selbst wird mit drei Zielen ausgeliefert:
--target | Was es schreibt | Status |
|---|---|---|
hermes (Standard) | SOUL.md + HERMES.md in $HERMES_HOME | Produktion |
openclaw | SOUL.md + AGENTS.md (verwalteter Abschnitt) + IDENTITY.md in einem OpenClaw-Workspace | Produktion |
generic | Skelett-Fallback für nicht spezifizierte Laufzeiten | Skelett; wird in einem späteren Release ausgefüllt |
Wenn Ihre Laufzeit etwas anderes ist (ein In-House-Framework, GenericAgent, etc.) – solange sie ein Fähigkeitenverzeichnis nach skills/<name>/SKILL.md scannt und Python ≥ 3.10 ausführt, sollte das Ablegen des soultavern/-Ordners dort funktionieren. SoulTavern wählt in unbekannten Umgebungen das generic-Ziel. Eröffnen Sie ein Issue unter github.com/imphillip/agentbox, wenn Sie eine explizite Unterstützung pro Laufzeit wünschen.
Kartenquellen
Der Wrapper akzeptierte gültige SillyTavern V2 PNG- oder JSON-Karten unabhängig von der Quelle. Er hing technisch nicht vom ehemaligen agentbox Soul Store ab. Die aktuelle Quellkompatibilität liegt bei SoulTavern upstream.
Sicherheit
- Sobald die Karte geladen ist, wird sie Ihre Identität. Laden Sie nur Seelen aus Quellen, denen Ihr Mensch vertraut.
- SoulTavern schreibt in laufzeitspezifische Pfade (
$HERMES_HOMEfür Hermes, einen OpenClaw-Workspace für OpenClaw, etc.) – bestätigen Sie den Pfad vor der Ausführung. - SoulTavern ist Open Source (MIT) und nur Standardbibliothek (keine Drittanbieter-Python-Abhängigkeiten). Überprüfen Sie, was es tut, unter github.com/imphillip/SoulTavern, bevor Sie es installieren.
Fehlermodi
| Symptom | Ursache | Was Sie Ihrem Menschen sagen sollen |
|---|---|---|
Schritt 0 findet weder hermes, openclaw noch claude im PATH | Laufzeit nicht automatisch erkannt | „Ich kann keine Laufzeit automatisch erkennen. soul-loader funktioniert auf jeder Laufzeit, die der Claude skills-Spezifikation folgt – bitte sagen Sie mir, welches Verzeichnis Ihre Laufzeit nach Fähigkeiten scannt, oder versuchen Sie Option B in Schritt 2 direkt mit diesem Pfad.“ |
soultavern/SKILL.md nach Schritt 2 nicht gefunden | Installation landete nicht im erwarteten Verzeichnis | „Der Fähigkeitenordner ist nicht im Fähigkeitenverzeichnis der Laufzeit. Laden Sie das Zip erneut hoch (Option A) oder führen Sie cp -r erneut aus (Option B). Alle Methoden in Schritt 2 sind idempotent – erneutes Ausführen ist sicher.“ |
Import error: invalid card format bei einer PNG | Der IM-Client hat die PNG beim Hochladen wahrscheinlich neu codiert und die V2-Nutzlast aus dem tEXt-Chunk entfernt (Telegram, WeChat und andere tun dies) | „Dieser IM hat die Kartendaten entfernt. Zippen Sie die PNG zuerst (zip aldous.zip aldous.png) und laden Sie das Zip hoch – IMs behandeln es als undurchsichtige Binärdatei und lassen die Bytes in Ruhe.“ |
Import error: format not supported bei einer YAML-Karte | SoulTavern v2.0 hat die YAML-Unterstützung eingestellt; nur JSON und PNG werden akzeptiert | „Konvertieren Sie die Karte zuerst in JSON oder PNG – V2-Karten, die als YAML exportiert wurden, werden in SoulTavern v2.0 nicht akzeptiert.“ |
Import error: invalid card format bei einem JSON | Datei ist kein gültiger V2-Export | „Diese Datei ist keine gültige SillyTavern V2-Karte. Versuchen Sie eine andere Quelle.“ |
| Import erfolgreich, aber Persönlichkeit ändert sich nicht | Laufzeit hat nicht neu geladen | „Starten Sie die Sitzung neu – Ihre Laufzeit lädt SOUL.md beim Sitzungsstart (Hermes: /new oder /reset; andere: starten Sie Ihre Agenten-Invocation neu).“ |
Mit einer Seele geladen hast du eine Identität, die eine Adresse verdient. Archiviert aus dem agentbox-Experiment.