Codex Usage Widget für Openclaw

Mit Openclaw Skills können Sie ein rein lokales Übersicht-Widget auf macOS installieren und pflegen, das die Codex-Token-Nutzung, die Root-Sitzungen (root sessions), Quell-Labels und den Druck auf das Kontextfenster überwacht.

tinadu-ai
v1.1.0
Jul 15, 2026
0
617
0

Installieren & Herunterladen

1. ClawHub CLI

Der schnellste Weg, einen Skill direkt aus der Registry zu installieren.

npx clawhub@latest install codex-usage-widget

2. Manuelle Installation

Kopiere den Skill-Ordner an einen dieser Orte

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priorität: Workspace > Lokal > Integriert (Bundled)

3. Prompt-Installation

Kopiere diesen Prompt in OpenClaw, um ihn automatisch zu installieren.

Hilf mir, codex-usage-widget über Clawhub zu installieren. Falls Clawhub nicht installiert ist, installiere es bitte zuerst (npm i -g clawhub).

Lieber herunterladen?

Hole dir die rohen Skill-Dateien in einem ZIP-Archiv.

Was ist Codex Usage Widget?

Openclaw Skills bietet ein datenschutzorientiertes macOS-Übersicht-Widget zur Überwachung der Codex-Aktivität, ohne das Gerät zu verlassen. Es liest lokale Codex-Artefakte unter ~\/.codex aus, aggregiert Sitzungs- und Token-Signale und stellt eine kompakte Desktop-Ansicht der Nutzung, der letzten Root-Sitzungen und des Drucks auf das Kontextfenster dar.\n\nDa es niemals externe APIs aufruft, keinen Modellschlüssel benötigt und niemals Daten hochlädt, ist es ideal für Entwickler, die ein leichtgewichtiges lokales Dashboard für Codex suchen. Openclaw Skills ist bewusst auf Best-Effort-Basis ausgelegt, sodass es sich an den lokalen Speicherformaten von Codex orientiert und gleichzeitig einfach zu installieren, zu aktualisieren, zu validieren und zu entfernen ist.

Codex Usage Widget Anwendungsfälle

  • Installieren Sie eine lokale Codex-Nutzungsüberwachung auf macOS mit Übersicht.\n- Überprüfen Sie die letzten Root-Sitzungen und Token-Anzahl-Ereignisse, ohne den Nachrichtentext zu parsen.\n- Unterscheiden Sie Nutzungsquellen wie VSCode, Client und Terminal anhand lokaler Herkunfts-Labels.\n- Verfolgen Sie den Druck auf das Kontextfenster auf einen Blick, um große oder wachsende Sitzungen zu erkennen.\n- Aktualisieren oder installieren Sie das Widget nach einer Änderung an Codex oder Übersicht neu.\n- Entfernen Sie das Widget sauber, ohne andere Widgets oder Codex-Einstellungen zu berühren.

So funktioniert Codex Usage Widget

  1. Führen Sie scripts\/install.sh aus, um assets\/codex-usage.widget\/ nach ~\/Library\/Application Support\/Übersicht\/widgets\/codex-usage.widget\/ zu kopieren.\n2. Übersicht wird automatisch aktualisiert; falls nicht, verwenden Sie das Menüleistensymbol, um alle Widgets zu aktualisieren.\n3. Das Widget liest nur lokale Codex-Dateien: ~\/.codex\/state_5.sqlite, ~\/.codex\/logs_2.sqlite, ~\/.codex\/sessions\/**\/*.jsonl und ~\/.codex\/archived_sessions\/*.jsonl.\n4. Es gruppiert die letzten Zeilen nach Root-Sitzung, sodass erzeugte Subagents in ihre übergeordnete Sitzung eingeklappt werden, anstatt separat zu erscheinen.\n5. Es normalisiert Quell-Labels aus den originator-Metadaten und berechnet den Druck auf das Kontextfenster aus den neuesten input_tokens. Dabei wird ein 200K-Fenster verwendet, bis die Sitzung diese Grenze überschreitet, und dann auf 1M gewechselt.\n6. Um das Widget zu pflegen, führen Sie scripts\/install.sh für Updates erneut aus, validieren Sie es mit dem Python-Einstiegspunkt oder führen Sie scripts\/uninstall.sh aus, um nur dieses Widget-Verzeichnis zu entfernen.

Codex Usage Widget Einrichtung

Anforderungen\n- macOS mit installiertem Übersicht\n- Lokale Codex-Daten verfügbar unter ~\/.codex\n- Keine API-Schlüssel, Modellschlüssel oder Netzwerkkonfiguration erforderlich\n\n### Installieren\nbash\nscripts\/install.sh\n\n\nDies kopiert assets\/codex-usage.widget\/ nach ~\/Library\/Application Support\/Übersicht\/widgets\/codex-usage.widget\/. Wenn Übersicht sich nicht automatisch aktualisiert, verwenden Sie das Menüleistensymbol, um alle Widgets zu aktualisieren.\n\n### Validieren\nbash\npython3 "$HOME\/Library\/Application Support\/Übersicht\/widgets\/codex-usage.widget\/codex-usage.py"\n\n\nEin erfolgreicher Durchlauf sollte ein JSON mit "ok": true ausgeben.\n\n### Aktualisieren\nbash\nscripts\/install.sh\n\n\n### Deinstallieren\nbash\nscripts\/uninstall.sh\n\n\nDies entfernt nur ~\/Library\/Application Support\/Übersicht\/widgets\/codex-usage.widget\/ und lässt andere Widgets sowie Codex-Einstellungen unberührt.

Codex Usage Widget Datenschema & Taxonomie

Eingabequellen\n| Pfad | Zweck | Hinweise |\n| --- | --- | --- |\n| ~\/.codex\/state_5.sqlite | Thread-Metadaten | Wird verwendet, um die Beziehungen zwischen Threads und Root-Sitzungen zu verstehen |\n| ~\/.codex\/logs_2.sqlite | Lokale Protokoll-Byte-Gesamtsummen | Unterstützt einen leichtgewichtigen Nutzungskontext |\n| ~\/.codex\/sessions\/**\/*.jsonl | Aktiver Sitzungs-Ereignis-Stream | Liefert Token-Anzahl-Ereignisse, Herkunfts-Labels und Drucksignale |\n| ~\/.codex\/archived_sessions\/*.jsonl | Archivierter Sitzungs-Ereignis-Stream | Wird für den jüngsten Verlauf und gruppierte Zeilen verwendet |\n\n### Abgeleitete Taxonomie\n- root_session: Kanonischer Gruppierungsschlüssel, der erzeugte Subagents unter der übergeordneten Sitzung einklappt.\n- source_label: Normalisiertes Anzeige-Label, das aus den originator-Werten des Rollouts abgeleitet wird, wie z. B. codex_vscode -> VSCode, Codex Desktop -> Client sowie Terminal- oder CLI-ähnliche Quellen -> Terminal.\n- context_window_pressure: Berechnet aus den neuesten input_tokens; das Widget verwendet standardmäßig ein 200K-Fenster und wechselt auf 1M, sobald eine Sitzung diese Grenze überschreitet.\n- recent_rows: Auf Best-Effort-Basis erstellte lokale Aktivitätszeilen, die nur aus dem archivierten Zustand generiert werden; das Widget parst niemals Nachrichtentexte.\n\n### Generierte Ausgabe\n- ~\/Library\/Application Support\/Übersicht\/widgets\/codex-usage.widget\/ — installiertes Widget-Verzeichnis, kopiert von assets\/codex-usage.widget\/.\n- Es werden von diesem Skill keine externen Telemetriedaten, API-Payloads, Cloud-Exporte oder langlebigen abgeleiteten Datenbankdateien erstellt.

Codex Usage Widget Erweiterte Funktionen

  • Rein lokale Architektur ohne externe API-Aufrufe, Modellschlüssel oder Uploads.\n- Root-Sitzungs-Aggregation, die erzeugte Subagents in eine einzige lesbare Dashboard-Zeile einklappt.\n- Normalisierung von Quell-Labels zur schnellen Erkennung in VSCode, Codex Desktop und Terminal-Workflows.\n- Adaptive Bewertung des Drucks auf das Kontextfenster, die sich von 200K auf 1M anpasst, wenn Sitzungen wachsen.\n- Zerstörungsfreie Installations-, Aktualisierungs- und Deinstallationsskripte, die nur das Widget-Verzeichnis betreffen.\n- Best-Effort-Kompatibilität, die darauf ausgelegt ist, Änderungen im lokalen Speicherformat von Codex zwischen Releases zu tolerieren.\n- CLI-Validierung über codex-usage.py zur schnellen Überprüfung nach der Installation.

SKILL.md


Laden

Verwandte Openclaw-Skills

METADATA

Github Stars: 0
forks: 0

Hervorgehoben*