Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Automates logging of deployments, incidents, changes, and decisions into a searchable ops journal with incident timelines and postmortem generation.
Automates logging of deployments, incidents, changes, and decisions into a searchable ops journal with incident timelines and postmortem generation.
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
Structured operational journal that captures deployments, incidents, changes, and decisions. Creates a searchable ops log with incident timeline reconstruction and automated postmortem generation.
# Initialize journal python3 scripts/journal.py init # Log an event python3 scripts/journal.py log "Upgraded nginx to 1.25" --category deploy python3 scripts/journal.py log "Disk cleanup, freed 5GB" --category maintenance --tags storage # Start an incident python3 scripts/journal.py incident open "API latency spike" --severity high # Resolve an incident python3 scripts/journal.py incident resolve INC-001 "Root cause: disk full on /var" # Search logs python3 scripts/journal.py search "nginx" --since 7d python3 scripts/journal.py search --category incident --severity high # Generate reports python3 scripts/journal.py summary --period week python3 scripts/journal.py timeline INC-001 # Export python3 scripts/journal.py export --format markdown --since 30d
CategoryDescriptionAuto-loggeddeployDeployments, upgrades, rollbacksVia hooksincidentIncidents, outages, degradationsVia watchdog integrationconfigConfiguration changesVia hooksmaintenanceScheduled maintenance, cleanupManual or cronsecuritySecurity events, audits, patchesVia security skillsnoteGeneral observations, decisionsManual
info โ Normal operations (default) warn โ Something worth noting high โ Important event requiring attention critical โ Major incident or outage
python3 scripts/journal.py log "message" [--category CAT] [--severity SEV] [--tags tag1,tag2]
python3 scripts/journal.py incident open "description" [--severity SEV] python3 scripts/journal.py incident resolve ID "resolution" python3 scripts/journal.py incident list [--status open|resolved|all] python3 scripts/journal.py incident show ID
python3 scripts/journal.py search [query] [--category CAT] [--severity SEV] [--since Nd|Nw|Nm] [--limit N]
python3 scripts/journal.py summary [--period day|week|month] [--json]
python3 scripts/journal.py timeline ID [--format markdown|json]
python3 scripts/journal.py export [--format markdown|json|csv] [--since Nd] [--output file]
python3 scripts/journal.py stats [--period month]
Human: Colored terminal output with category icons and severity highlighting JSON: Machine-readable output for integration (--json) Markdown: Report-ready markdown for sharing (--format markdown) CSV: Spreadsheet-compatible export (--format csv)
When infra-watchdog detects an issue, ops-journal can auto-log it: # In a cron or hook: python3 scripts/journal.py log "Monitor CRITICAL: Gateway down" --category incident --severity critical
# Daily summary at 09:00 python3 scripts/journal.py summary --period day --json # Weekly digest on Monday python3 scripts/journal.py summary --period week
All data stored in ~/.openclaw/workspace/ops-journal/: journal.db โ SQLite database with all entries incidents/ โ Individual incident files (markdown)
scripts/journal.py โ Main journal engine SKILL.md โ This file
Code helpers, APIs, CLIs, browser automation, testing, and developer operations.
Largest current source with strong distribution and engagement signals.