A specialized toolkit for monitoring, debugging, and analyzing the performance and costs of Clawdbot AI agent sessions.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install clawdbot-logs
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 clawdbot-logs 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 Clawdbot Logs & Diagnostics?
The clawdbot-logs skill provides deep visibility into the operational health of your AI agent gateway. As a crucial component of Openclaw Skills, it allows developers to track response times, validate configurations, and inspect real-time logs through systemd journals and JSONL session files. It is designed to help users maintain high availability and cost efficiency by identifying performance bottlenecks and token usage patterns across different AI models.
By synthesizing data from various log sources, this skill transforms raw diagnostic data into actionable insights. Whether you are troubleshooting a failed tool execution or auditing API spend, these tools provide the necessary transparency to manage complex agentic workflows effectively.
Clawdbot Logs & Diagnostics Use Cases
- Debugging slow response times or high latency in agent interactions.
- Auditing API costs and token usage per session to manage expenses.
- Validating configuration files to ensure the gateway starts correctly.
- Monitoring real-time tool execution and system state transitions.
- Recovering lost context or analyzing specific user-agent conversation history.
How Clawdbot Logs & Diagnostics Works
- Accesses the systemd journal logs to track gateway events and service status in real-time.
- Aggregates data from daily JSON logs located in temporary storage for detailed event analysis.
- Parses session-specific JSONL files to calculate token consumption and message flow using jq.
- Validates the core configuration file to ensure syntax and schema integrity before deployment.
- Generates summary statistics via specialized bash scripts for quick performance reviews and cost management.
Clawdbot Logs & Diagnostics Setup
Ensure you have jq installed on your system to handle JSON parsing. To verify your current Clawdbot configuration, run:
cat ~/.clawdbot/clawdbot.json | jq . > /dev/null && echo "Config valid" || echo "Config invalid"
To check the status of your gateway service, use:
systemctl --user status clawdbot-gateway.service --no-pager
Clawdbot Logs & Diagnostics Data Schema & Taxonomy
The skill interacts with several file types and locations to manage diagnostic data:
| Data Type | Path | Purpose |
|---|---|---|
| Gateway Logs | journalctl | Real-time session state and tool execution logs. |
| Session JSONL | ~/.clawdbot/agents/main/sessions/*.jsonl | Full conversation history and message metadata. |
| Meta JSON | ~/.clawdbot/agents/main/sessions/sessions.json | Global session state and total token counters. |
| Config File | ~/.clawdbot/clawdbot.json | Core gateway and agent configuration. |
Clawdbot Logs & Diagnostics Advanced Features
- Automated token usage alerts for sessions exceeding 30,000 tokens to prompt compaction.
- Category-specific log filtering for tools, telegram activity, and session states via grep patterns.
- Real-time diagnostic hooks to identify invalid config errors within the last 10 minutes.
- Historical response time tracking for performance benchmarking across various Openclaw Skills integrations.
SKILL.md
Loading
Related Openclaw Skills
System Integrity and Backup
A professional-grade security suite providing encrypted backups, integrity verification, and Greek legal retention enforcement.
System Health Check
A comprehensive diagnostic tool that validates file integrity, directory structures, and security permissions for your Openclaw Skills environment.
OpenClaw Greek Accounting Meta-Skill
A comprehensive orchestration layer that routes business commands across 18 specialized skills to automate the full Greek accounting lifecycle.
Memory and Feedback
A sophisticated learning and memory system that identifies failure patterns and proposes skill improvements via human-reviewed GitHub pull requests.
XMTP Agent Connectivity Skill
A bridge that connects AI agent runtimes to the XMTP open messaging network for secure, decentralized communication.
cloudphone
A specialized automation skill for executing AutoJS scripts and Android UI tasks on remote cloud devices using the mcporter CLI.
Featured*
