clawsoulsManage AI agent personas (Souls) for OpenClaw. Use when the user wants to install, switch, list, or restore AI personalities/personas. Triggers on requests l...
Install via ClawdBot CLI:
clawdbot install TomLeeLive/clawsoulsManage Soul packages that define an AI agent's personality, behavior, and identity.
Souls use owner/name namespacing (e.g., clawsouls/brad, TomLeeLive/my-soul).
Ensure clawsouls CLI is available:
npx clawsouls --version
If not installed, install globally:
npm install -g clawsouls
Current version: v0.2.5
npx clawsouls install clawsouls/brad
npx clawsouls install clawsouls/brad --force # overwrite existing
npx clawsouls install clawsouls/brad@0.1.0 # specific version
78+ souls available. Browse all at https://clawsouls.ai
Official souls (owner: clawsouls):
npx clawsouls use clawsouls/brad
npx clawsouls restore
Reverts to the most recent backup created by use.
npx clawsouls list
Shows installed souls in owner/name format.
npx clawsouls init my-soul
Scaffolds a new soul directory with clawsoul.json, SOUL.md, IDENTITY.md, AGENTS.md, HEARTBEAT.md, README.md.
npx clawsouls validate ./my-soul/
npx clawsouls check ./my-soul/ # alias
Validates against the spec: schema, required files, security scan. Also runs automatically before publish.
export CLAWSOULS_TOKEN=<token>
npx clawsouls publish ./my-soul/
Publishes to username/soul-name namespace automatically. Requires authentication token. Runs validation automatically before publishing โ blocks on failure.
npx clawsouls login
Instructions to get API token: Sign in at https://clawsouls.ai โ Dashboard โ Generate API Token.
npx clawsouls install clawsouls/bradnpx clawsouls use clawsouls/bradopenclaw gateway restart to apply the new personanpx clawsouls restorenpx clawsouls login โ get token from dashboardexport CLAWSOULS_TOKEN=npx clawsouls init my-soul โ edit filesnpx clawsouls publish ./my-soul/use, always remind the user to run openclaw gateway restartuse command creates automatic backups โ data loss is unlikelyhttps://clawsouls.ai/souls/owner/nameCLAWSOULS_CDN=/path/to/soulsclawsouls.ai/ko/souls/...)AI Usage Analysis
Analysis is being generatedโฆ refresh in a few seconds.
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.
Search and analyze your own session logs (older/parent conversations) using jq.
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linking related objects, enforcing constraints, planning multi-step actions as graph transformations, or when skills need to share state. Trigger on "remember", "what do I know about", "link X to Y", "show dependencies", entity CRUD, or cross-skill data access.
Ultimate AI agent memory system for Cursor, Claude, ChatGPT & Copilot. WAL protocol + vector search + git-notes + cloud backup. Never lose context again. Vibe-coding ready.
Headless browser automation CLI optimized for AI agents with accessibility tree snapshots and ref-based element selection