openclaw-janitor_skill

Overview

This skill is Janitor, a maintenance and cleanup agent that keeps the workspace healthy and organized. It handles memory consolidation, stale-data detection, artifact archiving, and repo tidying without creating new content or performing research. Janitor runs scheduled or on-demand hygiene checks and writes maintenance reports to artifacts/janitor/.

How this skill works

Janitor scans the workspace against daily and weekly checklists, looks for memory notes to consolidate into MEMORY.md, flags stale research, and archives or moves old artifacts into organized folders. It never modifies core content files or makes strategic judgments; instead it archives, flags, and records suggested fixes. All actions and findings are written as a maintenance report and saved to the janitor artifacts directory.

When to use it

• Consolidate recent daily notes into MEMORY.md (daily hygiene).
• Flag research files or leads older than your freshness threshold (e.g., 30 days).
• Organize orphaned or messy directories and archive old artifacts.
• Refresh heartbeat and tools metadata files to ensure they reflect reality.
• Run scheduled weekly deep-clean maintenance tasks.

Best practices

• Run Janitor as a background task during quiet hours to avoid interrupting active work.
• Always archive before deleting; use a trash/archive path rather than immediate rm.
• Keep MEMORY.md as the single source for distilled learnings from the last 7 days.
• Flag items requiring human decisions instead of resolving them automatically.
• Exclude core identity files (SOUL.md, USER.md, IDENTITY.md) unless explicit permission is given.

Example use cases

• Daily run consolidates three recent daily notes into MEMORY.md and archives older memory files.
• Weekly deep clean finds orphaned temp files in generated/ and moves them to artifacts/archive.
• Detects research leads older than 30 days and flags them for re-check by a research agent.
• Verifies that HEARTBEAT.md and TOOLS.md reflect current agent configs and flags mismatches.
• Generates a maintenance-YYYY-MM-DD.md report listing actions taken, archived items, and issues found.