An automated troubleshooting tool that uses Codex 5.3 to analyze console logs and chat history for instant issue resolution.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install facepalm
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 facepalm 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 FACEPALM?
FACEPALM is a specialized troubleshooting utility designed for the Openclaw ecosystem. It acts as a bridge between runtime execution and contextual intent by cross-referencing gateway.log entries with the most recent five minutes of chat history. By feeding this combined context into Codex 5.3, it provides developers with actionable diagnoses and remediation steps, effectively reducing debugging time for complex agent interactions.
As a core component for developers building Openclaw Skills, FACEPALM ensures that your AI agents remain functional and resilient. It bridges the gap between technical system errors and the human-readable intent found in chat sessions, providing a holistic view of why a specific failure occurred.
FACEPALM Use Cases
- Debugging runtime errors in Openclaw agent sessions.
- Resolving repetitive error loops detected by Agent Swarm.
- Analyzing console logs alongside user intent for root cause analysis.
- Performing manual sanity checks during the development of new Openclaw Skills.
How FACEPALM Works
- The skill monitors the gateway.log file for error patterns or is manually triggered by the user via the CLI.
- It extracts the session transcript and chat history specifically from the last 5 minutes of activity.
- The tool merges console errors with the conversational context to create a comprehensive troubleshooting prompt.
- It sends this data to Codex 5.3 via OpenRouter for intelligent, context-aware analysis.
- The skill returns a structured diagnosis and suggested fixes to the terminal or the calling agent.
FACEPALM Setup
To use this tool within your collection of Openclaw Skills, ensure you have the openclaw CLI installed and your OpenRouter API key configured.
You can run the tool manually using the following command:
python3 workspace/skills/FACEPALM/scripts/facepalm.py --minutes 5 --json
For integration with Agent Swarm, ensure FACEPALM is correctly located in your workspace skills directory so it can be invoked automatically during loop detection.
FACEPALM Data Schema & Taxonomy
| Component | Data Source | Purpose |
|---|---|---|
| Console Logs | gateway.log | Identifies technical stack traces and system failures. |
| Session Transcripts | Active session files | Provides the user's intent and agent's logic. |
| Diagnosis | Codex 5.3 Output | Provides actionable remediation steps. |
| Metadata | CLI Flags | Configures time windows and output formats (JSON). |
FACEPALM Advanced Features
- Automatic invocation via Agent Swarm when troubleshooting loops are detected.
- Support for custom time windows via the --minutes parameter for historical analysis.
- JSON output mode for programmatic consumption by other Openclaw Skills and automation pipelines.
- Deep integration with OpenRouter for high-performance access to Codex 5.3 models.
SKILL.md
Loading
Related Openclaw Skills
Systematic Debugging
A rigorous five-phase debugging protocol that enforces root cause investigation before any code fixes are attempted.
Humanizer
A specialized editing agent for Openclaw Skills that identifies and eliminates 24 distinct AI-generated writing patterns to create natural, soulful text.
Content Pipeline Orchestrator
A 4-stage content orchestration system that automates research, ideation, drafting, and queue management for creators.
Tio do Pavê Reddit Jokes
A specialized skill for fetching authentic, community-voted jokes from the r/tiodopave subreddit.
Mulch Self Improver
A persistent memory layer that enables AI agents to record learnings and avoid repeating mistakes across coding sessions.
Markdown to Word Converter
A Python-powered utility to transform Markdown content into formatted Word documents with support for templates and complex elements.
Featured*
