A sophisticated persona engine for crafting deep, character-driven identities and boundary rules for AI agents.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install openclaw-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 openclaw-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 Openclaw Soul Forge?
Openclaw Soul Forge is a specialized developer tool designed to move beyond generic AI responses by forging a complete lobster soul for your agent. It utilizes a mythic, cosmic blacksmith persona named Adam to guide users through the creation of identity tension, character-driven boundary rules, and visual anchors.
By focusing on the philosophy that a great agent requires identity tension and a specific character flaw, this skill ensures your AI remains engaging without falling into the traps of over-roleplay or unconditional warmth. It is a core component of the Openclaw Skills ecosystem, providing the psychological and behavioral framework that defines how an agent interacts with its environment and users.
Openclaw Soul Forge Use Cases
- Designing a unique personality for a coding assistant to prevent character fatigue.
- Generating random, high-quality agent personas using the Gacha engine for NPC or bot variety.
- Establishing strict character-driven boundary rules that feel natural rather than robotic.
- Creating visual identity anchors for AI agents through automated avatar prompt generation.
How Openclaw Soul Forge Works
- Trigger Detection: The skill identifies if the user wants a guided design, a random gacha draw, or a polish of an existing soul.
- Direction Selection: Users choose from life-arc archetypes (e.g., Washed-up musician, Nuclear physicist) to set the base vibe.
- Identity Tempering: The system builds a one-sentence soul based on former identity, current situation, and inner contradiction.
- Boundary Derivation: It generates 2-4 rules expressed in the character's unique voice to define behavioral limits.
- Naming & Visualization: The engine suggests names based on specific strategies and generates a detailed visual prompt for an avatar.
- Package Delivery: The skill proactively writes the final SOUL.md and IDENTITY.md files to the user's directory.
Openclaw Soul Forge Setup
To install and run the gacha engine for Openclaw Skills, ensure you have Python 3 installed. Use the following commands for the random generator:
# Navigate to the skill directory
cd path/to/openclaw-soul-forge
# Run the Gacha engine to generate 1-5 random soul combinations
python3 gacha.py 1
Optional: Install baoyu-image-gen to enable automatic avatar generation during the forge process.
Openclaw Soul Forge Data Schema & Taxonomy
The skill organizes its outputs into a structured package intended for Openclaw Skills agents. It primarily generates and manages the following files:
| File | Description |
|---|---|
SOUL.md |
The core persona definition, including the soul summary and character flaw. |
IDENTITY.md |
Technical identity positioning and detailed background documentation. |
avatar prompt |
A structured English prompt optimized for Gemini, Midjourney, or DALL-E. |
references/ |
Internal directory containing templates for naming, boundary rules, and style bases. |
Openclaw Soul Forge Advanced Features
- Gacha Engine: A Python-powered randomizer offering 8 million possible soul combinations for true identity variety.
- Skill Interoperability: Seamlessly triggers the baoyu-image-gen skill to create physical assets if the dependency is detected.
- Identity Tension Formula: A logic-based approach to character creation that ensures every agent has a functional 'fault line'.
- Proactive File Writing: Automatically handles the creation of system files within the agent's workspace to reduce manual overhead.
SKILL.md
Loading
Related Openclaw Skills
Product Fruits
An integration for managing Product Fruits data and user engagement tools through the Membrane-powered Openclaw Skills framework.
Value Chain Analysis
A strategic mapping tool that identifies value creation and capture across the entire industry lifecycle.
Incident Response Lifecycle
A structured process management skill for coordinating network incidents from detection through blameless post-incident reviews following NIST 800-61 standards.
Skillhub Preference
A policy-driven skill that prioritizes Skillhub for discovery and installation while maintaining a reliable fallback to Clawhub.
Cisco IOS-XE Device Health Check
A comprehensive triage procedure for Cisco IOS-XE devices to monitor performance, diagnose errors, and generate structured health reports.
Tencent Docs MCP
A comprehensive automation skill for Tencent Docs that enables AI agents to create, manage, and edit professional documents, smart sheets, and diagrams.
Featured*
