A technical framework for implementing standardized exception handling and logging following project-specific conventions.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install gi-error-handling
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install gi-error-handling using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is GI Error Handling?
The GI Error Handling skill provides a robust architecture for managing application flow through structured exceptions and comprehensive logging. It focuses on using the ApiException pattern to ensure that errors are not only caught but communicated effectively back to the frontend with appropriate status codes and user-friendly messages.
By leveraging this Openclaw Skills asset, developers can ensure consistency across their codebase, making debugging significantly easier and improving the overall reliability of the system. It bridges the gap between backend failure and frontend response through a unified data format.
GI Error Handling Use Cases
- Managing API exceptions and business logic errors effectively.
- Adding detailed logging for troubleshooting and issue localization.
- Implementing standardized parameter validation and resource-not-found responses.
- Transforming low-level system exceptions into safe, high-level API responses.
How GI Error Handling Works
- The developer identifies a point of failure or a need for logging within the application logic.
- Standardized ApiException classes are imported from the project's core exception modules.
- The skill triggers specific error codes (e.g., 400, 401, 404) based on the business context.
- Logging decorators or manual log entries capture critical context like user IDs and request IDs while scrubbing sensitive data.
- The system produces a consistent JSON response format for both success and failure states.
GI Error Handling Setup
To integrate this pattern into your project using Openclaw Skills, ensure you have the core exception library available:
# Ensure the tkms internal library is installed or accessible
pip install tkms-exception-framework
Configure your logger in your entry point:
import logging
logger = logging.getLogger(__name__)
GI Error Handling Data Schema & Taxonomy
The skill enforces a specific response schema to maintain consistency across the Openclaw Skills ecosystem:
| Field | Type | Description |
|---|---|---|
| code | Integer | HTTP status code or business error code (0 for success) |
| message | String | User-facing error description or 'success' |
| data | Object | The payload returned on successful requests |
Example Failure Schema:
{"code": 400, "message": "User does not exist"}
GI Error Handling Advanced Features
- Multi-level exception catching: Differentiate between ConnectionError and general exceptions to provide nuanced user feedback.
- Sensitive Data Masking: Automatic guidelines for excluding passwords and tokens from logs.
- Contextual Logging: Support for the
extraparameter in loggers to include user_id and request_id for better traceability.
SKILL.md
Loading
Related Openclaw Skills
Traffic Analysis
Analyze website traffic sources, solve attribution challenges, and mitigate dark traffic to optimize marketing spend and channel performance.
Xueqiu Hot Trend
A specialized financial intelligence skill for monitoring public market data and community trends on the Xueqiu platform.
Hospital Selection Assistant
An AI-powered medical facility navigator that matches patients with the most suitable hospitals based on symptoms, location, and healthcare tier rankings.
1688-shopkeeper
A professional AI assistant for sourcing products on 1688 and automating the listing process to downstream retail platforms.
Database Query Patterns (tkms)
Streamline database access layer development using standardized async SQL patterns and the tkms template.
Vue 3 Component Design Guide
A professional architectural guide for building robust Vue 3 components with the Composition API and Ant Design integration within the Openclaw Skills ecosystem.
Featured*
