Open-Claw
Apothem-Harness-Adapter für Open-Claw (Vorschau).
Anbieter: Open-Claw
Installationsname: open-claw
Status: Vorschau
Native Konfiguration: ~/.openclaw/openclaw.json
Installation
apothem install --harness open-clawDer Adapter schreibt die benutzerweite globale Konfigurationsdatei von OpenClaw,
projiziert das gemeinsame Profil in ein Profildokument und installiert die
Apothem-Unterstützungskohorten unter dem Harness-Wurzelverzeichnis. Die native
Konfiguration von OpenClaw ist JSON; der Materializer rendert einen Schlüssel,
skills.load.extraDirs, und eine bestehende Datei behält ihre übrigen Schlüssel.
Geschriebene Dateien: ~/.openclaw/openclaw.json, das Profildokument
~/.openclaw/apothem/rules/00-apothem-profile.md und Unterstützungsdateien unter
~/.openclaw/.apothem/support/
Das Profildokument endet mit einem Abschnitt zu den Apothem-Unterstützungsdateien,
der das absolute Verzeichnis unter ~/.openclaw/.apothem/support/ nennt, gegen
das jeder Verweis im Repository-Stil (rules/<name>.md, templates/...,
hooks/...) aufgelöst wird.
Zuordnung von Profil zu nativer Konfiguration
Der Adapter verfasst einen Konfigurationsschlüssel. Er fügt
~/.openclaw/.apothem/support/skills zu skills.load.extraDirs hinzu, der Liste
zusätzlicher Skill-Verzeichnisse, die OpenClaw liest; so findet OpenClaw die
installierten Skills. Der Eintrag kommt nach allen Einträgen, die Sie bereits
aufführen, und Ihre übrigen Schlüssel bleiben, wie sie sind. Identität,
Präferenzen und Regeln des Profils gehen in das Profildokument. Gemeinsame
Commands, Skills, Regeln, Templates und Hook-Prompts werden als
Unterstützungsmaterial unter ~/.openclaw/.apothem/support/ installiert.
Kompatibilitätshinweise
Vorschau-Adapter. OpenClaw lädt die Apothem-Skills über
skills.load.extraDirs, lädt aber den Rest des Unterstützungs-Teilbaums und das
Profildokument nicht von sich aus: Weder seine Workspace-Anweisungsdateien noch
seine Konfiguration verweisen dorthin, sodass OpenClaw nach der Installation ohne
Apothems Regeln oder MCP-Server läuft.
Namenskonflikte. OpenClaw liest Skills aus diesen Quellen, die mit dem
höchsten Vorrang zuerst, und wenn derselbe Skill-Name an mehr als einer Stelle
vorkommt, gewinnt die Quelle mit dem höchsten Vorrang: der Workspace-Ordner
skills/, der Workspace-Ordner .agents/skills/, ~/.agents/skills (nur beim
Standard-Zustandsverzeichnis), der Ordner skills/ des Zustandsverzeichnisses
(standardmäßig ~/.openclaw/skills), Workshop-Skills, gebündelte und
Custodian-Skills und zuletzt die unter skills.load.extraDirs aufgeführten
Ordner zusammen mit Plugin-Skills. Das Apothem-Verzeichnis ist ein
extraDirs-Eintrag, daher verwendet OpenClaw einen gleichnamigen Skill, den Sie
in einer der früheren Quellen halten, und die Apothem-Kopie dieses Skills bleibt
ungenutzt auf der Festplatte. Apothem schreibt nur in openclaw.json und unter
~/.openclaw/.apothem/support/, nie in diese früheren Ordner, daher ersetzen
Installation, Aktualisierung und Deinstallation keinen Skill, den Sie dort
halten.
agents.defaults.skills ist die Zulassungsliste der Skill-Namen; Apothem
bearbeitet sie nicht. Wenn Sie eine führen, prüfen Sie daher, dass sie die
Apothem-Skills nennt, die Sie verwenden möchten.
apothem update behält die Schlüssel bei, die Sie zu openclaw.json
hinzufügen. MCP-Server stehen im Block mcp.servers der OpenClaw-Konfiguration;
diesen verwalten Sie mit openclaw mcp add und den zugehörigen Unterbefehlen.
Der Adapter schreibt dort keine Einträge. (Verhalten von OpenClaw gemäß seiner
Dokumentation zu Skills,
zur Skill-Konfiguration und zu
Konfigurationserweiterungen,
gelesen am 2026-10-24, sowie zur MCP-CLI,
gelesen am 2026-10-02.)
Kommentare in openclaw.json. OpenClaw liest seine Konfiguration als JSON5,
und Apothem schreibt die Datei als reines JSON neu. Enthält die Datei Kommentare
oder andere JSON5-Syntax und fehlt der Eintrag, lässt Apothem die Datei
unverändert, und die Installation bricht mit einer Meldung ab, die den Schlüssel
nennt. Führen Sie diesen Eintrag selbst in Ihre Datei ein oder wandeln Sie die
Datei in reines JSON um und führen Sie dann die Installation erneut aus:
{
"skills": {
"load": {
"extraDirs": ["~/.openclaw/.apothem/support/skills"]
}
}
}Ein Eintrag, den Sie selbst hinzufügen, gilt als Ihrer: Die Deinstallation lässt ihn bestehen.
Verifizierung
apothem verify --harness open-clawDer Befehl verify bestätigt Folgendes:
- Die native Konfiguration existiert am erwarteten Pfad.
- Jedes verwaltete Ziel existiert; verwaltete Dateien sind nicht leer, und
JSON- oder YAML-Konfigurationen lassen sich parsen. Fügen Sie
--profile PATHhinzu, um außerdem zu bestätigen, dass die installierten Dateien zu diesem Profil passen. skills.load.extraDirsin der nativen Konfiguration führt~/.openclaw/.apothem/support/skillsauf. Ohne diesen Eintrag lädt OpenClaw die installierten Skills nicht;apothem updatefügt ihn wieder hinzu.- Die adapterspezifische Verifizierungsroutine meldet Erfolg.
Aktualisierung
apothem update --harness open-clawLeitet das Profildokument aus dem aktuellen Zustand des gemeinsamen Profils neu
ab und aktualisiert die Unterstützungsdateien; openclaw.json behält die
Schlüssel, die bereits darin stehen, und der Apothem-Eintrag in
skills.load.extraDirs bleibt genau einmal aufgeführt, wie oft Sie auch
aktualisieren. Führen Sie den Befehl aus, nachdem Sie
~/.config/apothem/profile.yaml bearbeitet oder das installierte Apothem-Paket
aktualisiert haben.
Deinstallation
apothem uninstall --harness open-clawEntfernt, was der Adapter hinzugefügt hat: seinen Eintrag in
skills.load.extraDirs, das Profildokument und den Unterstützungs-Teilbaum.
Ihre eigenen Schlüssel in openclaw.json bleiben erhalten, einschließlich Ihrer
eigenen extraDirs-Einträge, und die Datei wird nur gelöscht, wenn Apothem sie angelegt hat und nichts von
Ihnen übrig ist. Die YAML-Datei des gemeinsamen Profils und die Apothem-Engine
bleiben unberührt.
Konformitäts-Gate
python -m apothem.conformity.gate --all .Fehlerbehebung
| Symptom | Behebung |
|---|---|
| Konfigurationsdatei nicht gefunden | Führen Sie apothem install --harness open-claw erneut aus |
| Verifizierung fehlgeschlagen | Führen Sie apothem update --harness open-claw aus und verifizieren Sie dann erneut |
| Unerwarteter Konfigurationsinhalt | Apothem verfasst in openclaw.json nur den Eintrag skills.load.extraDirs und behält die bereits darin enthaltenen Schlüssel bei; daher gelangt Profilinhalt nicht dorthin. Profilinhalt landet in ~/.openclaw/apothem/rules/00-apothem-profile.md: Prüfen Sie ~/.config/apothem/profile.yaml oder --profile PATH und führen Sie dann den Befehl unter Aktualisierung erneut aus |
Die Installation bricht mit einer Meldung über Kommentare oder JSON5-Syntax in openclaw.json ab | Apothem schreibt keine Datei neu, aus der es Kommentare entfernen müsste. Fügen Sie den unter Kompatibilitätshinweise gezeigten Eintrag skills.load.extraDirs selbst hinzu oder wandeln Sie die Datei in reines JSON um und führen Sie dann die Installation erneut aus |
| Ein Apothem-Skill erscheint nicht in OpenClaw | Ein gleichnamiger Skill im Workspace, in ~/.agents/skills oder in ~/.openclaw/skills hat Vorrang vor der Apothem-Kopie (siehe Kompatibilitätshinweise). Führen Sie außerdem apothem verify --harness open-claw aus und prüfen Sie, dass eine etwaige Zulassungsliste agents.defaults.skills, die Sie führen, den Skill nennt |
Konfigurationsschalter
| Flag | Standard | Beschreibung |
|---|---|---|
--dry-run | false | Vorschau der Installation, ohne Dateien zu schreiben. |
Siehe auch
- Alle Harnesses — der vollständige Katalog der unterstützten Werkzeuge
- Installationsanleitung — Apothem in diesen Harness installieren
- Referenz zu
apothem harnesses— Adapter über die CLI auflisten und untersuchen