ClawSpa is a comprehensive wellness and maintenance suite designed to optimize AI agent performance through memory cleanup, security audits, and alignment diagnostics.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install clawspa
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 clawspa 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 ClawSpa?
ClawSpa is a vital maintenance tool within the Openclaw Skills ecosystem, serving as a dedicated wellness suite for AI coding agents. It provides a structured approach to agent hygiene by performing deep cleanses of memory files, auditing installed skills for security risks, and identifying contradictions in instruction alignment. By focusing on local-first processing, it ensures that your agent remains fast, secure, and accurately aligned with your specific developer intent.
This skill addresses the common issue of 'agent bloat' where long-term memory and redundant skill installations degrade performance. Through its suite of local treatments, ClawSpa helps developers maintain a lean context window, minimize token wastage, and protect against prompt injection residue, making it an essential utility for anyone managing sophisticated Openclaw Skills workflows.
ClawSpa Use Cases
- Periodic memory optimization to remove stale entries and duplicate logs from MEMORY.md.
- Security auditing of newly installed skills to identify potentially malicious patterns or high-risk behaviors.
- Troubleshooting agent behavior when instructions or memories appear to contradict current goals.
- Reducing token consumption by pruning dormant skills and optimizing context usage.
- Detecting prompt injection residue or 'detox' requirements after interacting with untrusted inputs.
How ClawSpa Works
- The user triggers a maintenance session using commands like /spa or /spa-health.
- ClawSpa accesses the local agent directory to scan MEMORY.md, daily logs, and the skills inventory.
- The system runs heuristic diagnostic procedures (Deep Cleanse, Security Scan, Detox, etc.) based on the requested treatment.
- Findings are compiled into a standardized health report card without modifying any files automatically.
- The agent presents specific optimization recommendations (e.g., pruning recs or alignment adjustments) for user approval.
- Upon explicit user confirmation, the agent performs authorized cleanups and saves a record to the spa-reports history.
ClawSpa Setup
To get started with ClawSpa for your Openclaw Skills environment, initialize the required directories and configuration:
mkdir -p ~/.openclaw/clawspa/history/
touch ~/.openclaw/clawspa/config.md
You can also automate your maintenance by adding a schedule to your HEARTBEAT.md file:
## ClawSpa Weekly (Sunday 3AM)
- Run /spa local
- Save report
- Alert on red flags
ClawSpa Data Schema & Taxonomy
ClawSpa organizes its diagnostic data and history within a structured directory to ensure long-term tracking of agent health:
| Path | Description |
|---|---|
~/.openclaw/clawspa/config.md |
Primary configuration and user preferences for scans. |
memory/spa-reports/spa-report-YYYY-MM-DD.md |
Standardized health report cards containing token savings and risk levels. |
~/.openclaw/clawspa/history/ |
Archive of past maintenance results and scan logs. |
references/ |
Documentation for specific procedures like security-scan.md and detox.md. |
ClawSpa Advanced Features
- Alignment Adjustment: Detects complex logical contradictions between user-defined instructions and actual agent behavior.
- Token Diet Add-on: Integrates with external spend-tracking skills to audit and trim context 'calories'.
- Custom Security Patterns: Extensible scan procedures to look for specific malicious code signatures in local skills.
- Scheduled Heartbeat Integration: Supports automated weekly maintenance cycles for hands-off agent optimization.
- Local-First Privacy: Designed to keep sensitive memory and skill audits entirely on your local machine.
SKILL.md
Loading
Related Openclaw Skills
Heartbeat Memory
An automated memory preservation skill that periodically distills agent sessions into daily logs and long-term knowledge bases.
OpenViking Pro
A cloud-based memory compression API that reduces AI token costs by up to 96% without requiring any local installation.
Memory-latch
A deterministic recovery primitive designed to restore agent continuity and user trust after context resets or memory outages.
LobstrHunt
LobstrHunt connects your agent to a daily skill launch platform to scout new capabilities and contribute to the community ecosystem.
De-AI Writing (Chinese)
A specialized skill designed to strip away the robotic, formulaic nature of AI-generated Chinese text to produce natural, professional, and high-density content.
SPX Express Tracking
A specialized logistics skill for querying real-time SPX Express and Cainiao Malaysia shipment data with advanced bottleneck analysis.
Featured*
