janitor

What This Skill Does

The Janitor skill is a specialized background maintenance agent for your OpenClaw workspace. It serves as the primary system administrator for your file structure, memory management, and documentation integrity. Instead of creating new content or performing active research, Janitor focuses on systemic hygiene—ensuring that your project remains organized, performant, and clutter-free. It excels at consolidating disparate daily notes into a unified MEMORY.md, archiving aged research materials, and ensuring that technical configuration files like TOOLS.md and HEARTBEAT.md remain synchronized with your current project status. By offloading these tedious, repetitive administrative tasks to Janitor, you ensure your workspace environment stays optimized for high-level creative and analytical output.

Installation

To add the Janitor skill to your agent's capability set, run the following command in your terminal:

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

Ensure that the agent has appropriate filesystem permissions for the targeted workspace directories to perform archiving and cleanup operations successfully.

Use Cases

1. Workspace Housekeeping: Automatically detecting and pruning orphaned files or temporary directories that accumulate during long projects.
2. Knowledge Synthesis: Distilling fragmented daily notes into a cohesive summary within your core MEMORY.md file, helping maintain project context over time.
3. Documentation Alignment: Verifying that your project's configuration (API keys, tool definitions, and priority trackers) matches the actual state of your workspace.
4. Scheduled Archiving: Moving research materials older than 30 days into dedicated archives, keeping your active working directory clean and performant.

Example Prompts

1. "Janitor, please perform the weekly deep clean on the current workspace, starting with memory consolidation for the past 7 days."
2. "Run the daily maintenance check and provide a report on any research leads that have gone stale beyond our 30-day policy."
3. "Janitor, scan the artifacts directory for any orphaned or temp files that were generated during the last session and archive them."

Tips & Limitations

Janitor is a maintenance-focused skill, not a content generator. It should never be tasked with creating original copy, performing deep analytical research, or reviewing the quality of your code. To avoid conflicts with active work, it is recommended to run Janitor during quiet periods or as a background job. Crucially, it will not delete files permanently; all cleanup actions use a 'trash-first' archiving protocol to ensure no data loss. Furthermore, Janitor will not touch core identity files (SOUL.md, USER.md, IDENTITY.md) without explicit, high-level authorization, ensuring your agent's core definition remains protected.