Installing a downloaded soul

Install OpenClaw

You need OpenClaw running on your machine. The quickest way:

curl -fsSL https://openclaw.ai/install.sh | bash

Or install via npm: npm i -g openclaw then openclaw onboard

Back up your current workspace

If you already have an agent with its own files, save them first. Your workspace lives at ~/.openclaw/workspace

cp -r ~/.openclaw/workspace ~/.openclaw/workspace-backup

Extract the soul into your workspace

Unzip the downloaded file into your workspace directory. This replaces the agent's identity, memory, and skills with the soul you downloaded.

unzip downloaded-soul.zip -d ~/.openclaw/workspace

Or extract to a separate folder and point OpenClaw to it:

# Extract to its own directory
mkdir -p ~/souls/new-agent
unzip downloaded-soul.zip -d ~/souls/new-agent

# Point OpenClaw to it
openclaw setup --workspace ~/souls/new-agent

Start a new session

OpenClaw loads SOUL.md and all workspace files at the start of every session. Open a new chat and the agent picks up the soul's identity, memory, and skills automatically.