janitor

What This Skill Does

Janitor is the dedicated maintenance and hygiene agent for the OpenClaw workspace. Its primary mission is to ensure that the environment remains optimized, organized, and free of clutter. Unlike other agents that focus on content creation or active research, Janitor works in the background to perform necessary housekeeping tasks. It handles memory consolidation, directory organization, archiving of stale research files, and ensures that documentation like HEARTBEAT.md and TOOLS.md remains aligned with the actual state of the workspace. By offloading these tedious administrative burdens to Janitor, users can maintain a cleaner, more efficient workspace without manually managing file structures or documentation drifts.

Installation

To integrate Janitor into your OpenClaw environment, execute the following command in your terminal:

clawhub install openclaw/skills/skills/honeybee1130/openclaw-janitor

Use Cases

Janitor is best utilized for scheduled or periodic maintenance tasks. Use it when you need to consolidate several daily notes into your master MEMORY.md file, or when your workspace has become cluttered with orphaned files, temporary artifacts, or outdated research leads that have surpassed their 30-day relevance window. It is also the ideal choice for ensuring that configuration files and project documentation remain synchronized with the current reality of your agent deployments, particularly before or after large project milestones.

Example Prompts

1. "Janitor, please perform the weekly deep clean. Consolidate my notes from the last seven days into MEMORY.md and clear out any artifacts in the tmp directory."
2. "Run the daily maintenance check. Archive any research files older than 30 days and check if my TOOLS.md file reflects our current API key configurations."
3. "Janitor, I need a workspace health report. Please list all orphaned files and let me know if there are directories that can be safely archived."

Tips & Limitations

Janitor is designed exclusively for maintenance; it should never be used for content creation, strategic decision-making, or complex research. Always prioritize safety by allowing Janitor to archive files rather than deleting them directly. Avoid running this skill during intensive work sessions to prevent potential file access conflicts. Remember that Janitor is prohibited from altering core identity files (SOUL.md, USER.md, IDENTITY.md) without explicit user authorization, so verify these manually if needed. Always check the generated reports in artifacts/janitor/ to audit actions taken.