← Back to Skills Marketplace
78
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install soul-evolver
Description
soul-evolver - AI Agent Memory Evolution System. Automatically analyzes memory files and evolves SOUL.md, USER.md, IDENTITY.md, and other workspace identity...
Usage Guidance
What to check before installing:
- Understand data flow: this skill will read your workspace memory files (memory/*.md, .learnings/) and send extracted excerpts to the configured MiniMax API. Only install if you trust the MiniMax provider and are comfortable sending that data off-host.
- Required env var: set MINIMAX_API_KEY (and optionally MINIMAX_BASE_URL). Note the package metadata shown earlier omitted this — rely on SKILL.md/code which do require the key.
- Test with --dry-run first to see proposed changes without writing. Review outputs before allowing it to run automatically.
- Scheduling: SKILL.md includes a scheduled hook (every 120m). If you enable automated scheduling, the skill will periodically analyze and may append updates; if you prefer manual control, do not enable the cron/hook.
- Review workspace and backups: backups are stored under derived .soulforge-* directories inside the workspace; confirm the workspace path is correct so backups stay isolated.
- Path/name mismatch: documentation refers to both 'soul-forge' and 'soul-evolver' locations; confirm the actual installed path and update commands accordingly.
- If you need higher assurance, audit the full analyzer/evolver code (the network call and prompt composition are visible in analyzer.py) and consider running the skill in an isolated test workspace containing non-sensitive data first.
Capability Analysis
Type: OpenClaw Skill
Name: soul-evolver
Version: 1.0.1
The soul-evolver skill is a legitimate memory management system designed to analyze an agent's conversation logs and learning files to update its identity and behavioral guidelines (e.g., SOUL.md, USER.md). The code is well-structured, follows its stated purpose, and includes safety features such as incremental file appends (never overwriting), timestamped backups, and a dry-run mode. While it sends memory data to the MiniMax API (api.minimax.chat) for analysis, this is the core documented functionality and is handled via standard environment variables. No evidence of malicious intent, unauthorized data exfiltration, or harmful prompt injection was found.
Capability Tags
Capability Assessment
Purpose & Capability
The skill's name/description, runtime code, and instructions consistently implement a memory-analysis → MiniMax → file-update workflow. Requiring python3 and a MiniMax API key is coherent with that purpose. However, the registry-level metadata shown at the top of the report claims no required environment variables, while SKILL.md and the code require MINIMAX_API_KEY — this mismatch is an incoherence in the packaging/metadata.
Instruction Scope
SKILL.md and the code instruct the agent to read memory/*.md, .learnings/, and optionally a hawk-bridge vector store, then build prompts containing memory excerpts and send them to the configured MiniMax endpoint. That behavior matches the described purpose but does mean potentially sensitive workspace memory is transmitted to an external LLM provider. The skill also includes a scheduled hook (every 120m) which, if enabled, will run periodically without manual approval. Instructions and code otherwise remain within the stated scope (no access to unrelated system paths or unrelated credentials).
Install Mechanism
This is an instruction-only skill (no external download/install spec). Code files are bundled in the skill itself; there is no separate install-from-URL step. That keeps installation risk low. Minor inconsistency: SKILL.md/README refer to paths like ~/.openclaw/skills/soul-forge/scripts/... while other documentation and the publish slug use 'soul-evolver' or 'soulforge' — path/name inconsistencies may cause user confusion but are not an active install risk.
Credentials
The code and SKILL.md require a single external credential (MINIMAX_API_KEY) and optionally accept MINIMAX_BASE_URL; that is proportionate to the stated functionality. The top-level registry metadata (in the provided summary) not listing MINIMAX_API_KEY is inconsistent with the skill instructions and code, which do require it. No unrelated secrets or excessive environment variables are requested.
Persistence & Privilege
The skill does not set always: true and does not request elevated system privileges. It can be scheduled via an agentTurn hook (every 120m) which would run autonomously if the environment/scheduler enables the hook; that autonomy combined with sending memory to an external API is a convenience-risk tradeoff but not an outright privilege escalation.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install soul-evolver - After installation, invoke the skill by name or use
/soul-evolver - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
Multi-agent isolation
v1.0.0
Initial release
Metadata
Frequently Asked Questions
What is Tmp Soul Evolver?
soul-evolver - AI Agent Memory Evolution System. Automatically analyzes memory files and evolves SOUL.md, USER.md, IDENTITY.md, and other workspace identity... It is an AI Agent Skill for Claude Code / OpenClaw, with 78 downloads so far.
How do I install Tmp Soul Evolver?
Run "/install soul-evolver" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Tmp Soul Evolver free?
Yes, Tmp Soul Evolver is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Tmp Soul Evolver support?
Tmp Soul Evolver is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Tmp Soul Evolver?
It is built and maintained by Gao.QiLin (@relunctance); the current version is v1.0.1.
More Skills