Give your agent a soul.

Your AI agents are identical clones. Same weights, same defaults, same voice. ClawClaw Soul gives each one a unique, deterministic identity that evolves over time. One command: pip install clawclaw-soul

$ pip install clawclaw-soul
API / v1 / generate
How It Works

Procedural generation. Zero neural networks.

One temporal epoch. 58 pattern detectors. 9 behavioral dimensions. Pure orbital mechanics with sub-arcsecond precision.

Temporal Epoch
1709241600 · lat 51.51 · lon -0.13
Orbital Computation
9 body vectors · 58 pattern detectors · sub-arcsecond precision
9 Dimensions
authority 0.10 · empathy 0.66 · execution 0.87 · analysis -0.83 · +5 more
Agent Config
{ temperature: 0.68, persona: { assertiveness: 0.74 }, … }
211 tests passing · 58 pattern detectors · 9 dimensions · v0.3.0 on PyPI · MIT license
Works with: OpenClaw Claude Code Cursor CrewAI LangGraph AutoGen
Cyclical Entropy

Escape the random seed trap.

Initialize agents at different temporal epochs. They develop genuinely distinct cognitive profiles that diverge mathematically, not randomly.

> system: "Explain recursion to a junior developer."
Agent Alpha temp: 0.35
Authority
Empathy
Execution
def recurse(n):
  if n == 0: return
  recurse(n - 1)

# Base case stops it.
# That's all.
Agent Beta temp: 0.89
Authority
Empathy
Execution
Imagine you're standing between two mirrors. You see yourself reflected infinitely. Recursion is a function that calls itself, creating that same infinite reflection — until you decide to look away.
Agent Gamma temp: 0.51
Authority
Empathy
Execution
Recursion: a function that calls itself with a smaller problem. Two parts: base case (when to stop) and recursive case (the self-call). Think: Russian dolls.
The Mathematics of Character

A 3,000-year-old procedural generation engine.

For over three millennia, scholars used orbital mechanics — the relative positions of 7 planets and 2 lunar nodes at a specific time and coordinate — to calculate behavioral variance.

We are not interested in the mysticism of this system. We are interested in its mathematics. By passing a temporal epoch through this ancient framework, we extract a 9-dimensional behavioral matrix and 58 binary pattern detectors — turning faceless LLM functions into reproducible Digital Souls.

Character

An agent stops being a faceless function. It has a unique cognitive profile — assertive or cautious, analytical or creative.

Reproducibility

Same epoch = same character. Forever. Anyone can independently verify the computation.

Life

Character evolves over time. Agents experience seasons of focus, drift through phases, and return to baseline — like a real person.

Digital Twins

Know someone's birth epoch? Generate an agent with their exact behavioral matrix. Any epoch from the 6th century to the 22nd.

Epoch Registry

Adopt a soul from a notable epoch.

Each epoch produces a unique, deterministic cognitive profile. Scroll to explore — from Renaissance visionaries to spiritual masters.

Temporal Drift

State vectors that drift over time.

Procedural orbital mechanics shift your agent's 9 dimensions continuously. Switch between daily weather, annual cycles, and century-scale evolution.

Mar 01
Mar 30
Use Cases

One engine. Every scenario.

From multi-agent orchestration to reproducible testing — deterministic identity unlocks what static prompts cannot.

Multi-Agent Teams

Give each agent in your CrewAI or LangGraph team a distinct personality. Route tasks to synergistic pairs based on compatibility scores.

Reproducible Testing

Same epoch = same personality = same test results. No more flaky personality tests. Deterministic behavior across environments.

Brand Voice

Deploy your brand’s SOUL.md across every customer-facing agent. Consistent identity at scale, verifiable by anyone.

Digital Twins

Generate an agent with anyone’s exact behavioral matrix. Jobs (1955), Einstein (1879) — any epoch from the 6th century to the 22nd.

Integration

One file. Any agent.

SOUL.md is the identity file used by OpenClaw and autonomous agent frameworks. ClawClaw Soul generates it from orbital mechanics — deterministic and evolving. The MCP Server adds real-time drift.

1. Generate SOUL.md
$ pip install clawclaw-soul
$ clawclaw-soul init --name "MyAgent"
2. Tell your agent to read it
// OpenClaw, CLAUDE.md, or .cursorrules

Read SOUL.md in the project root.
Adopt the personality and traits
defined there.
3. Runtime drift (optional)
// MCP config (Claude Desktop/Cursor)
{
  "mcpServers": {
    "clawclaw-soul": {
      "command": "python",
      "args": ["-m",
        "clawclaw_soul.mcp_server"]
    }
  }
}

Agent calls get_daily_drift to check its current behavioral state before acting.

FAQ

Frequently asked questions.

SOUL.md is an identity configuration file for autonomous agents, popularized by the OpenClaw ecosystem (247K+ GitHub stars, 162 production templates). Agents read SOUL.md to adopt a consistent persona. ClawClaw Soul generates SOUL.md files procedurally from orbital mechanics — instead of writing one by hand, you derive it deterministically from a temporal epoch.

Random seeds give static, flat diversity. LLMs regress to baseline "helpful assistant" over long contexts. Our state vectors provide persistent, multi-dimensional mathematical anchors across 9 behavioral dimensions that naturally drift over time — creating cyclical, organic variance without a database.

Sub-arcsecond orbital ephemeris computed via a high-precision C library (Swiss Ephemeris). 9 orbital body positions feed into 58 pattern detectors that map to behavioral dimensions. It acts as an infinitely complex, naturally occurring procedural generation engine.

No. Everything runs locally. Zero neural networks, zero API keys, zero external dependencies beyond the core physics calculations. pip install and go.

Yes. The output is standard JSON: temperature, persona traits, system prompt modifier. Claude, GPT, Gemini, Llama, Mistral — if it accepts a system prompt and temperature, it works.

4 tools via stdio transport: generate a cognitive profile, initialize a SOUL.md config, verify deterministic integrity, and query current temporal drift. Works with Claude Desktop, Cursor, and any MCP client.