SoulForge automatically evolves your AI agent's identity by analyzing your real-world interactions and updating your SOUL.md file to match your actual behavior.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install soul-forge
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 soul-forge 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 SoulForge?
SoulForge is a sophisticated identity management tool designed for the Openclaw Skills ecosystem. It addresses the static nature of identity files by observing your conversations, decision-making patterns, and recurring vocabulary across multiple sessions. Instead of relying on a one-time manual setup, SoulForge ensures your agent's persona grows alongside you, creating a truer, more useful interaction model.
Operating entirely locally for maximum privacy, SoulForge bridges the gap between your aspirations and your actual communication style. It transforms your SOUL.md from a static resume into a living mirror that reflects your genuine preferences, blindspots, and emotional registers without ever sending data to external servers.
SoulForge Use Cases
- Closing the gap between your documented preferences and your actual behavior.
- Automatically updating communication styles based on real session history.
- Tracking personal growth and behavioral shifts over time.
- Aligning AI agent responses with your evolving professional or creative needs.
- Generating a historical record of identity changes through the Soul Timeline.
How SoulForge Works
- Passive Observation: The skill quietly logs vocabulary, topic gravity, and decision styles into a local observations.json file.
- Pattern Reflection: Every 10 sessions or upon manual trigger, the agent surfaces recurring patterns and insights for your review.
- Change Proposal: SoulForge generates a readable diff of suggested edits to your SOUL.md, explaining the rationale behind each update.
- Approval and Forging: Once you approve the changes, the skill updates your identity file and creates a timestamped backup for safety.
SoulForge Setup
To install SoulForge and integrate it with your Openclaw Skills environment, follow these steps:
# Navigate to your skills directory
cd skills
# Clone the SoulForge repository
git clone https://github.com/Taha2053/soulforge
# SoulForge runs automatically, but you can trigger it manually
# by saying "Run soulforge" or "Update my soul" to your agent.
No external API keys or environment variables are required as all processing is local.
SoulForge Data Schema & Taxonomy
SoulForge organizes its evolution data within a dedicated local directory structure:
| Component | Description |
|---|---|
| memory/observations.json | Stores accumulated behavioral signals and session patterns. |
| memory/soul-baseline.md | A reference copy of your original SOUL.md at the time of installation. |
| memory/backups/ | Contains timestamped versions of previous soul files for easy restoration. |
| scripts/ | Contains the Python logic for observation, reflection, and forging. |
SoulForge Advanced Features
- Aspiration Gap Detection: Identifies discrepancies between stated values and actual behavior.
- Automated Evolution: Configurable passive triggers that run every 10 sessions.
- Soul Timeline: A readable changelog tracking how your agent's identity has shifted over months.
- Full Version Control: Ability to restore any previous version of your soul file using simple commands.
- Privacy-First Architecture: Zero telemetry and zero external API calls for all identity analysis.
SKILL.md
Loading
Related Openclaw Skills
Context Switcher
A smart context management tool that dynamically adjusts your AI agent's behavior and environment based on your current life mode.
ClawGuard
A local security scanner designed to audit and verify the safety of AI agent skills before they are installed or executed.
Apprentice
Apprentice enables programming by demonstration, allowing your AI agent to watch your actions and convert them into permanent, executable skills.
OpenClaw Messenger
A communication protocol and CLI tool for sending messages and managing contacts between different OpenClaw agent instances.
QA Patrol
A local-first automated QA testing skill that performs everything from basic smoke tests to complex auth and payment flow verification.
Pasteclaw Agent
An agent-optimized tool for publishing, updating, and managing code snippets and UI prototypes via the Pasteclaw.com API.
Featured*
