A comprehensive maintenance suite for Openclaw agents that automates GitHub backups, system updates, and session database optimization.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install heleni-maintenance
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 heleni-maintenance 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 Workspace Maintenance?
The Workspace Maintenance skill is an essential utility for developers looking to ensure the reliability and longevity of their AI agent environments. It provides a unified framework for managing the health of the system by automating the backup of the entire workspace to GitHub, keeping the core platform and all installed skills up to date, and preventing performance bottlenecks through session database cleanup. This skill is a core component for anyone managing production-grade Openclaw Skills deployments.
By centralizing these administrative tasks, the skill minimizes the risk of data loss and ensures that agents are always running the most secure and feature-rich versions of their underlying software. Whether triggered manually via natural language or automatically via scheduled cron jobs, it maintains a clean and efficient workspace without requiring constant developer oversight.
Workspace Maintenance Use Cases
- Automatically backing up MEMORY.md and custom skill configurations to a remote repository every six hours.
- Ensuring the OpenClaw platform and all ClawHub extensions are running the latest versions via a weekly maintenance window.
- Pruning large sessions.json files that have grown due to high-frequency cron run history to restore agent responsiveness.
- Pushing local workspace changes to GitHub immediately after completing significant development milestones.
How Workspace Maintenance Works
- The skill first checks for GitHub authentication by inspecting git remote URLs, environment variables, or local credential files.
- When triggered for backup, it executes a git add, commit, and push sequence using a standardized UTC timestamp for the commit message.
- For system updates, it invokes the openclaw update and clawhub update commands to synchronize the local environment with the latest stable releases.
- During the weekly maintenance cycle, it calculates the size of the sessions database and runs a specialized Python script to remove stale entries if the file exceeds a 10MB threshold.
- Upon completion, the skill provides a summary report of updated versions and backup status, or remains silent for background cron operations.
Workspace Maintenance Setup
To get started with this maintenance skill, ensure your local git repository is connected to a GitHub remote and that a Personal Access Token is configured. You can then schedule the automated workflows using the following commands:
# Schedule 6-hourly workspace backups
openclaw cron add --name "workspace-backup" --every 6h --session isolated --message "Run the maintenance skill: backup workspace to git."
# Schedule weekly system and skills updates
openclaw cron add --name "weekly-update" --cron "0 3 * * 0" --session isolated --message "Run maintenance: update openclaw and clawhub."
Workspace Maintenance Data Schema & Taxonomy
The skill manages several key data paths and metadata taxonomies to ensure system integrity:
| Component | Location | Function |
|---|---|---|
| Workspace Directory | /opt/ocana/openclaw/workspace |
The primary source for git version control and backups. |
| Session Store | .../sessions/sessions.json |
JSON database containing session logs and cron history. |
| Credentials | ~/.credentials/ |
Secure storage for GitHub PAT tokens (e.g., github-token.txt). |
| Versioning | OpenClaw & ClawHub | Tracks semantic versioning for platform and Openclaw Skills updates. |
Workspace Maintenance Advanced Features
- Isolated session execution for cron jobs to prevent interference with active user interactions.
- Intelligent database pruning that specifically targets :run: entries in the session store to reduce file size without losing core context.
- Multi-channel reporting capabilities, allowing maintenance summaries to be sent via WhatsApp or other configured communication channels.
- Integrated error handling for git conflicts, automatically suggesting rebase operations if the remote has diverged.
SKILL.md
Loading
Related Openclaw Skills
Feishu File Renamer
An AI-powered utility to automatically restore original filenames from hashed Feishu/Lark download links.
Personal CRM
An automated Personal CRM for monday.com that tracks contacts and meeting history using Google Calendar and Gmail data.
Memory Architecture Skill
An advanced tiered memory framework for AI agents that distinguishes between explicit facts and deduced behavioral patterns to maintain high-quality context.
Self-Learning Skill
An autonomous learning loop that transforms user corrections and task failures into permanent behavioral updates for AI agents.
NicheStarter Weekly Report Preview
An AI agent skill that fetches and summarizes the latest NicheStarter weekly pain-point reports into actionable market digests.
Meetings Skill
An end-to-end meeting management tool that handles calendar coordination between agents and extracts structured action items from transcripts.
Featured*
