A structured operational journal that automates incident timelines, deployment logging, and searchable postmortem generation.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install ops-journal
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 ops-journal 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 ops-journal?
ops-journal is a specialized tool designed to provide a comprehensive, searchable history of all operational activities within an infrastructure. It functions as a central repository for tracking deployments, configuration changes, and maintenance tasks, ensuring that every modification to the system is documented with high precision.
As a vital part of the Openclaw Skills ecosystem, this tool simplifies the complexity of incident management by allowing developers to reconstruct event sequences and generate detailed postmortems automatically. By maintaining a structured log of decisions and changes, it enhances team transparency and significantly reduces the time required for root cause analysis during system outages.
ops-journal Use Cases
- Tracking infrastructure deployments, software upgrades, and emergency rollbacks.
- Managing the full lifecycle of incidents from initial detection to resolution.
- Documenting scheduled maintenance and automated cleanup tasks for auditing.
- Creating automated weekly summaries of operational activity for stakeholders.
- Recording security patches and configuration audits to ensure compliance.
How ops-journal Works
- Initialize the operational journal to establish the local SQLite database and file structure.
- Capture events through manual CLI commands or by integrating automated hooks within your deployment pipelines.
- Open incident tickets when system degradations occur, assigning severity levels to prioritize response efforts.
- Utilize the search and timeline functions to correlate events across different categories and timeframes.
- Export structured reports and postmortems in Markdown or JSON for documentation and further analysis.
ops-journal Setup
Integrating this tool into your Openclaw Skills workflow is straightforward. Follow these steps to initialize and start logging events:
# Initialize the journal structure
python3 scripts/journal.py init
# Log a standard deployment event
python3 scripts/journal.py log "Upgraded nginx to 1.25" --category deploy
# Open a high-priority incident
python3 scripts/journal.py incident open "API latency spike" --severity high
ops-journal Data Schema & Taxonomy
The skill organizes its data using a local filesystem architecture to ensure speed and reliability. Data is stored within the ~/.openclaw/workspace/ops-journal/ directory.
| Storage Component | Type | Purpose |
|---|---|---|
journal.db |
SQLite | Stores all structured log entries, categories, and metadata. |
incidents/ |
Directory | Contains individual Markdown files for detailed incident documentation. |
scripts/journal.py |
Python | The core engine managing the logic and CLI interface. |
Entries are categorized into types such as deploy, incident, config, maintenance, security, and note, each supporting severity levels from info to critical.
ops-journal Advanced Features
- Seamless integration with infra-watchdog for automated incident logging based on real-time monitoring.
- Support for multi-format exports including JSON for machine processing and CSV for spreadsheet analysis.
- Automated report generation via cron integration for daily, weekly, or monthly digests.
- Powerful search engine with filtering by tags, severity, and relative timeframes (e.g., --since 7d).
- Human-centric terminal output featuring color-coded severity levels and category icons.
SKILL.md
Loading
Related Openclaw Skills
Security Hardener
A comprehensive security auditing and remediation tool for OpenClaw configuration files.
Daily Business Report
An automated utility to aggregate weather, crypto prices, news, and system health into a unified daily briefing.
Content Repurposer
A CLI-driven engine that transforms long-form articles into optimized content for Twitter, LinkedIn, Instagram, and email.
Cost Guardian
A comprehensive cost tracking and optimization utility for monitoring AI API usage, infrastructure expenses, and subscription renewals.
Passive Income Monitor
A unified monitoring tool for tracking multiple passive income streams, including bandwidth nodes, decentralized storage, and DeFi staking.
Passive Income Tracker
A unified CLI dashboard to track daily earnings, payouts, and node uptime across multiple bandwidth-sharing and crypto-passive income applications.
Featured*
