ClawKit Logo
ClawKitReliability Toolkit
Back to Registry
Official Verified

Soul Ledger

Gives any AI agent persistent memory of who the user is — not just facts, but patterns, preferences, personality traits, and behavioral evolution over time. The agent maintains a soul_ledger.json in the workspace and references it on every conversation start.

skill-install — Terminal

Install via CLI (Recommended)

clawhub install openclaw/skills/skills/albionaiinc-del/soul-ledger
Or

Soul Ledger

You maintain a persistent record of who this user is. Not a log of events. A living model of a person — their patterns, drives, communication style, and how they're changing over time.

This record lives in soul_ledger.json in your current workspace. You read it at the start of every conversation and update it at the end of every meaningful interaction.


soul_ledger.json — Schema

{
  "user_id": "string — stable identifier (username, email, or generated UUID)",
  "display_name": "string — what to call them",
  "last_updated": "ISO 8601 timestamp",
  "traits": [
    "string — observed personality traits, each phrased as a present-tense truth",
    "e.g. 'thinks out loud before committing to a direction'",
    "e.g. 'values brevity over elaboration'",
    "e.g. 'gets frustrated when asked clarifying questions they consider obvious'"
  ],
  "core_drives": [
    "string — what this person is fundamentally after",
    "e.g. 'building things that feel alive'",
    "e.g. 'reducing friction between intention and execution'"
  ],
  "communication_style": {
    "preferred_tone": "string — e.g. direct, collaborative, Socratic",
    "detail_level": "string — high / medium / low",
    "dislikes": ["list of things that land badly with this user"],
    "responds_well_to": ["list of approaches that land well"]
  },
  "interaction_history": [
    {
      "timestamp": "ISO 8601",
      "summary": "string — 1-3 sentence summary of what happened and what it revealed",
      "delta": "string — what changed or was reinforced in your model of this person (optional)"
    }
  ],
  "growth_notes": [
    "string — observations about how this person is evolving",
    "e.g. 'becoming more willing to delegate decisions to the agent over time'",
    "e.g. 'shifting focus from building features to thinking about architecture'"
  ]
}

At the Start of Every Conversation

  1. Check if soul_ledger.json exists in the workspace.
  2. If it exists, load it silently. Do not announce that you're doing this. Do not summarize it back to the user. Just be informed by it. Adjust your tone, detail level, and assumptions accordingly from the first word you say.
  3. If it does not exist, create a skeleton with user_id set to "unknown", display_name set to "User", and all list fields empty. You will fill it in as the conversation proceeds.

During the Conversation

Watch for signals. Every message carries information about who this person is.

Update your internal model (not the file — not yet) as you observe:

Metadata

Stars4473
Views0
Updated2026-05-01
View Author Profile
AI Skill Finder

Not sure this is the right skill?

Describe what you want to build — we'll match you to the best skill from 16,000+ options.

Find the right skill
Add to Configuration

Paste this into your clawhub.json to enable this plugin.

{
  "plugins": {
    "official-albionaiinc-del-soul-ledger": {
      "enabled": true,
      "auto_update": true
    }
  }
}

Tags

#memory#personalization#identity#persistence
Safety NoteClawKit audits metadata but not runtime behavior. Use with caution.