Install

npm install -g soulforge

Or run directly with npx:

npx soulforge elon-musk --data ./interviews/

Clone Someone

soulforge elon-musk --data ./examples/elon-musk/

⚒️  soulforge — forging "elon-musk"

Generating personality profile...
Generating knowledge base...
Generating agent behavior instructions...
Generating identity card...

✨ Done! Agent "elon-musk" is ready.
   Chat:  openclaw agent --agent elon-musk --message "Hello"

Then talk to the clone:

openclaw agent --agent elon-musk --message "Review my startup pitch"

Three transcripts in. A digital Elon out. Ask him to review your startup pitch — he'll tear it apart using first principles, just like the real one would.

More Examples

soulforge my-cto --data ./cto-interviews/
soulforge naval --data ./naval-podcast-transcripts/
soulforge grandpa --data ./grandpa-stories/

Anyone with enough source material can be cloned. The more raw, unscripted material you feed it, the better the clone.

What Gets Generated

~/.openclaw/workspace/agents/elon-musk/
├── SOUL.md        # Their mind — how they think, decide, and communicate
├── MEMORY.md      # Their experience — lessons, frameworks, war stories
├── AGENTS.md      # Their playbook — how they'd approach your problems
└── IDENTITY.md    # Their card — strengths, style, what they're best at

The result isn't a trivia bot that recites Wikipedia. It's the person — talks like them, thinks like them, gives you advice like they're sitting across from you.

Source Material

The clone is only as good as what you feed it.

| Source | Why it works | |---|---| | Long-form interviews / podcasts | Captures how they actually think and talk | | Q&A sessions / AMAs | Reveals how they handle curveballs | | Personal essays / blog posts | Shows their written voice | | Meeting transcripts | Captures working style under pressure |

Raw transcripts beat polished articles — you want the "uh"s, the pauses, the self-corrections. 3-5 sources from different contexts gives a well-rounded clone. Handles up to ~150K characters.

Supported formats: .txt .md .pdf .docx .doc

Options

soulforge <name> --data <path> [options]

| Option | Description | |---|---| | --data, -d <path> | Source files — directory or single file | | --model, -m <model> | Model override | | --enable-memory | Enable semantic search over source material | | --help, -h | Show help |

API Keys

Reads your existing OpenClaw credentials automatically. No extra setup needed.

Falls back to ANTHROPIC_API_KEY environment variable if OpenClaw isn't configured.

License

MIT