EvoClaw

Log experiences and generate governance-approved SOUL.md updates.

86|5|Updated Feb 13, 2026
One-click install
npx skills add https://github.com/slhleosun/EvoClaw --skill evoclaw
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: EvoClaw
Source: https://github.com/slhleosun/EvoClaw/tree/main/evoclaw
Command: npx skills add https://github.com/slhleosun/EvoClaw --skill evoclaw

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python3, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill addresses the challenge of AI agents having static, unevolving identities, leading to agents that don't learn from experience or adapt their core beliefs and behaviors over time.

Core Features & Use Cases

  • Structured Identity: Organizes an AI's beliefs, values, and boundaries into SOUL.md with [CORE] (immutable) and [MUTABLE] (evolvable) tags.
  • Experience-Driven Evolution: Logs interactions, polls social feeds, and uses this data to trigger reflections.
  • Proposal Pipeline: Generates and manages proposals for SOUL updates, subject to configurable governance levels (Autonomous, Advisory, Supervised).
  • Use Case: An AI assistant that learns from user feedback and conversations, gradually refining its communication style, ethical boundaries, and understanding of user preferences over time, all while maintaining a transparent and auditable evolution log.

Quick Start

Instruct your agent to install and load EvoClaw by reading evoclaw/SKILL.md and evoclaw/configure.md.

Frequently Asked Questions about EvoClaw

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I make an AI agent evolve its identity from past interactions?

To make an AI agent evolve its identity, you use a structured experience logging and reflection pipeline that updates a SOUL document. This framework logs interactions and triggers proposal-based updates to core beliefs and behaviors.

What is a SOUL document for AI self-reflection and governance?

A SOUL document is a structured file organizing an AI's beliefs and boundaries using CORE and MUTABLE tags. It enforces AI governance by separating immutable traits from evolvable ones, ensuring transparent and auditable evolution.

How do I implement a proposal pipeline for AI agent evolution?

You implement a proposal pipeline by configuring governance levels like Autonomous, Advisory, or Supervised. The pipeline generates proposals for SOUL document updates based on tiered memory logs and structured reflection data.

Can I use Python to build an AI identity framework with tiered memory?

Yes, this AI identity framework requires Python3 to manage tiered memory, reflection pipelines, and social feed integration. It uses Python scripts to facilitate structured experience logging and governance protocol enforcement.

What are the limitations of autonomous AI governance for agent evolution?

Autonomous AI governance allows agents to update their evolvable traits without human oversight, risking unexpected behavioral shifts. Using Advisory or Supervised modes mitigates this by requiring human review of proposed SOUL document updates.

How does an AI assistant learn from social feeds and user feedback?

An AI assistant learns by polling social feeds and logging user feedback into a tiered memory system. This data triggers structured reflections that generate proposals for updating the agent's mutable boundaries and communication style.