SoulKeeper provides identity persistence for AI agents by auditing core rule files, detecting behavioral drift, and injecting context-aware reminders.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install soulkeeper
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 soulkeeper 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 SoulKeeper?
SoulKeeper is a specialized utility designed to solve the common problem of AI agents losing their unique persona or "soul" during long sessions. It prevents agents from drifting into generic behaviors or forgetting their available tools by formalizing identity into a structured, auditable framework. As one of the essential Openclaw Skills, it bridges the gap between static markdown instructions and active execution monitoring.
By leveraging three core tools—audit, drift, and remind—SoulKeeper ensures that an agent's tone, operational constraints, and tool knowledge remain consistent. It transforms abstract principles found in SOUL.md or TOOLS.md files into actionable data that can be used to score transcripts and provide real-time mental context before an agent responds.
SoulKeeper Use Cases
- Maintaining a specific brand voice or non-corporate persona across multiple chat sessions.
- Auditing agent transcripts to identify stylistic slips or violations of non-negotiable rules.
- Preventing agents from claiming they lack tools or permissions that have already been granted.
- Automated validation of agent outputs in a CI/CD pipeline to ensure compliance with identity protocols.
How SoulKeeper Works
- The audit tool parses markdown files (SOUL.md, TOOLS.md, etc.) into a structured soul_rules.json file.
- The drift tool analyzes conversation transcripts against the generated rules to assign a drift score based on severity.
- The reminder tool identifies the current task context and injects relevant identity prompts to the agent's mental model.
- Heartbeat checks are used at the start of sessions to refresh core rules and ensure the agent is fully aligned before acting.
SoulKeeper Setup
To begin using SoulKeeper within the ecosystem of Openclaw Skills, navigate to your skill directory and prepare the scripts:
cd /root/.openclaw/workspace/skills/soulkeeper
chmod +x audit.py drift.py remind.py
# Generate your identity rules
python audit.py --workspace /root/.openclaw/workspace --output soul_rules.json
You can also link the scripts to your local path for easier access:
ln -s /root/.openclaw/workspace/skills/soulkeeper/audit.py /usr/local/bin/soul-audit
SoulKeeper Data Schema & Taxonomy
SoulKeeper organizes agent identity data into a central soul_rules.json file with the following structure:
| Attribute | Type | Description |
|---|---|---|
stats |
Object | Breakdown of rules by category (tone, operational) and severity. |
rules |
Array | Detailed list of constraints, including violation patterns and source references. |
severity |
String | Classification of rules (Critical, High, Medium, Low) used for drift scoring. |
violation_patterns |
Array | Regex or string patterns that trigger a drift penalty. |
SoulKeeper Advanced Features
- Custom regex violation patterns for deep linguistic auditing and tone control.
- Dynamic drift scoring that triggers mandatory identity re-reads if thresholds (e.g., score > 50) are exceeded.
- Context-aware triggers that inject specific reminders based on the task type, such as coding or public communication.
- Headless CI mode for validating agent outputs via standard input with specific exit codes for failures.
SKILL.md
Loading
Related Openclaw Skills
Polymarket Whale Copier
An automated trading tool designed to track and replicate the positions of high-performing Polymarket wallets in real-time.
Memory Guard
Secure your agent's identity and memory files against injection attacks and unauthorized personality drift.
Image Nuke
A high-intensity image anonymization tool that strips all metadata and injects noise to defeat forensic tracking and reverse image search.
Crypto Alpha Scanner
A zero-dependency Python intelligence tool providing real-time crypto prices, sentiment analysis, and trending market data.
VidIQ
An AI-driven video intelligence tool for downloading, analyzing, and manipulating media from social platforms using ffmpeg and yt-dlp.
xAI Grok Search
A high-performance AI skill leveraging xAI's Grok API to provide real-time web access, X (Twitter) insights, and multi-modal media understanding.
Featured*
