GI Error Handling für Openclaw

Ein technisches Framework zur Implementierung einer standardisierten Ausnahmebehandlung und Protokollierung nach projektspezifischen Konventionen.

laimiaohua
v1.0.0
Mar 17, 2026
0
826
0

Installieren & Herunterladen

1. ClawHub CLI

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

npx clawhub@latest install gi-error-handling

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, gi-error-handling ü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 GI Error Handling?

Die GI Error Handling Skill bietet eine robuste Architektur zur Verwaltung des Anwendungsflusses durch strukturierte Ausnahmen und umfassende Protokollierung. Sie konzentriert sich auf die Verwendung des ApiException-Musters, um sicherzustellen, dass Fehler nicht nur abgefangen, sondern mit entsprechenden Statuscodes und benutzerfreundlichen Nachrichten effektiv an das Frontend kommuniziert werden.

Durch die Nutzung dieses Openclaw Skills Assets können Entwickler Konsistenz in ihrer Codebasis gewährleisten, was das Debugging erheblich erleichtert und die Gesamtzuverlässigkeit des Systems verbessert. Es schließt die Lücke zwischen Backend-Fehlern und Frontend-Antworten durch ein einheitliches Datenformat.

GI Error Handling Anwendungsfälle

  • Effektive Verwaltung von API-Ausnahmen und Geschäftslogikfehlern.
  • Hinzufügen detaillierter Protokollierung zur Fehlerbehebung und Problemlokalisierung.
  • Implementierung standardisierter Parametervalidierung und Antworten bei nicht gefundenen Ressourcen.
  • Umwandlung von Low-Level-Systemausnahmen in sichere High-Level-API-Antworten.

So funktioniert GI Error Handling

  1. Der Entwickler identifiziert einen Fehlerpunkt oder einen Bedarf für die Protokollierung innerhalb der Anwendungslogik.
  2. Standardisierte ApiException-Klassen werden aus den Kern-Ausnahmemodulen des Projekts importiert.
  3. Die Skill löst spezifische Fehlercodes (z. B. 400, 401, 404) basierend auf dem Geschäftskontext aus.
  4. Logging-Decorators oder manuelle Protokolleinträge erfassen kritische Kontexte wie User IDs und Request IDs, während sensible Daten bereinigt werden.
  5. Das System erstellt ein konsistentes JSON-Antwortformat für Erfolgs- und Fehlerzustände.

GI Error Handling Einrichtung

Um dieses Muster mit Openclaw Skills in Ihr Projekt zu integrieren, stellen Sie sicher, dass die Core-Ausnahmebibliothek verfügbar ist:

# Ensure the tkms internal library is installed or accessible
pip install tkms-exception-framework

Konfigurieren Sie Ihren Logger an Ihrem Einstiegspunkt:

import logging
logger = logging.getLogger(__name__)

GI Error Handling Datenschema & Taxonomie

Die Skill erzwingt ein spezifisches Antwortschema, um die Konsistenz im gesamten Openclaw Skills-Ökosystem zu wahren:

Feld Typ Beschreibung
code Integer HTTP-Statuscode oder geschäftlicher Fehlercode (0 für Erfolg)
message String Benutzerorientierte Fehlerbeschreibung oder 'success'
data Object Die bei erfolgreichen Anfragen zurückgegebene Nutzlast

Beispiel für ein Fehlerschema:

  • {"code": 400, "message": "User does not exist"}

GI Error Handling Erweiterte Funktionen

  • Mehrstufiges Abfangen von Ausnahmen: Unterscheiden Sie zwischen ConnectionError und allgemeinen Ausnahmen, um nuanciertes Benutzerfeedback zu geben.
  • Maskierung sensibler Daten: Automatische Richtlinien zum Ausschluss von Passwörtern und Tokens aus Protokollen.
  • Kontextbezogene Protokollierung: Unterstützung für den Parameter extra in Loggern, um user_id und request_id für eine bessere Rückverfolgbarkeit einzuschließen.

SKILL.md


Laden

Verwandte Openclaw-Skills

METADATA

Github Stars: 0
forks: 0

Hervorgehoben*