← Back to Skills Marketplace
Memory Maintenance
by
Max Hutchinson
· GitHub ↗
· v1.0.0
1988
Downloads
6
Stars
9
Active Installs
1
Versions
Install in OpenClaw
/install memory-maintenance
Description
Intelligent memory management for OpenClaw agents. Reviews daily notes, suggests MEMORY.md updates, maintains directory health, and auto-cleans old files. Recommended for agents with growing memory footprints.
Usage Guidance
Key things to consider before installing:
- Privacy: The review script builds a prompt containing your recent daily notes, MEMORY.md, and USER.md and sends it to the Gemini CLI (external model). If those files contain sensitive data (passwords, tokens, personal data), they will be included in requests to an external service. Only install if you're comfortable with that or you sanitize files first.
- .env export: The scripts source and export all variables from workspace/.env. Ensure that file does not contain other secrets you don't want exported or sent to the model. Consider giving GEMINI_API_KEY a restricted key or setting it only for this skill's runtime.
- Hardcoded paths & portability: Several scripts use /Users/maxhutchinson/.openclaw/workspace hardcoded. This will likely fail or behave unexpectedly on other machines. Inspect and fix these paths (replace with OPENCLAW_WORKSPACE or $HOME/.openclaw/workspace) before installing broadly.
- Review and test first: Run the review script in a safe test workspace (with non-sensitive sample files) to confirm behavior. Check where files are moved (archive/.trash) and verify the retention behavior meets your expectations.
- Code quality issues: There are bugs (argument parsing in apply.sh mis-indents the --all handling) and rough edges; treat this as alpha software and review scripts before granting production use.
- If you proceed: backup your workspace (or at least agents/memory and MEMORY.md), remove unrelated secrets from workspace/.env, and run install in a controlled environment. If you need strict privacy, do not use an external LLM or run the LLM step locally with a model you trust.
Capability Analysis
Type: OpenClaw Skill
Name: memory-maintenance
Version: 1.0.0
The OpenClaw AgentSkills skill bundle 'memory-maintenance' is classified as benign. Its core functionality involves reading agent memory files (daily notes, MEMORY.md, USER.md) and sending them to the Gemini LLM API for analysis, using the provided GEMINI_API_KEY. While this involves handling sensitive data and interacting with an external service, it is explicitly stated as the skill's purpose and is not exfiltrated to an unauthorized endpoint. The skill implements robust safety features, including human review for content suggestions, dry-run modes, explicit confirmation for risky file operations, and moving deleted files to a trash directory for recovery. All file system operations and cron job additions are aligned with the stated memory maintenance and cleanup goals, without evidence of malicious intent or obfuscation.
Capability Assessment
Purpose & Capability
The declared requirements (gemini CLI, jq, GEMINI_API_KEY) align with the stated purpose of running LLM-based reviews and JSON processing. Requiring GEMINI_API_KEY is appropriate for calling Gemini. The binaries and config referenced are proportionate to a memory-review skill.
Instruction Scope
The runtime instructions and scripts read lots of user-local files (memory/YYYY-MM-DD.md, MEMORY.md, USER.md) and package their contents into a prompt sent to the Gemini CLI. That is expected for a review tool, but it means potentially sensitive local data is transmitted to an external model. Also the scripts export and source a workspace .env (see env/credential concerns below).
Install Mechanism
Installation is script-based (no remote download), which reduces supply-chain risk, but the scripts copy themselves into the user's workspace and add a cron job. Multiple scripts contain hardcoded absolute paths pointing at /Users/maxhutchinson/.openclaw/workspace instead of relying consistently on the configurable OPENCLAW_WORKSPACE or $HOME. That hardcoding is an implementation bug and causes incoherence (would fail or operate on the wrong path on other systems).
Credentials
The skill only declares GEMINI_API_KEY, which is reasonable. However the scripts source $WORKSPACE/.env with set -a (exporting all variables), making all .env entries available in the environment when the Gemini CLI runs. That raises the risk that unrelated secrets in .env could be present in the process environment and (depending on how the gemini CLI handles environment data or logs) could be exposed. The skill does not request other unrelated credentials, which is good, but the behavior of exporting an entire .env is disproportionate without explicit guidance.
Persistence & Privilege
The skill installs cron jobs and copies executable scripts into the workspace so it will run daily (persistent presence). always:false is set, so it is not forcibly injected into every agent, but the install creates a scheduled, autonomous job — this is expected for a maintenance tool but worth noting because it gives the skill recurring execution privileges on the host.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install memory-maintenance - After installation, invoke the skill by name or use
/memory-maintenance - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: Intelligent memory management for OpenClaw agents
Metadata
Frequently Asked Questions
What is Memory Maintenance?
Intelligent memory management for OpenClaw agents. Reviews daily notes, suggests MEMORY.md updates, maintains directory health, and auto-cleans old files. Recommended for agents with growing memory footprints. It is an AI Agent Skill for Claude Code / OpenClaw, with 1988 downloads so far.
How do I install Memory Maintenance?
Run "/install memory-maintenance" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Memory Maintenance free?
Yes, Memory Maintenance is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Memory Maintenance support?
Memory Maintenance is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Memory Maintenance?
It is built and maintained by Max Hutchinson (@maxlauriehutchinson); the current version is v1.0.0.
More Skills