How to Install a SOUL

Once you've purchased a SOUL from the marketplace, follow these steps to install it into your agent:

Installation Steps

1. Purchase the SOUL

Choose a SOUL from the marketplace and complete your purchase using the "Buy Now" button.

2. Download the SOUL File

After purchase, download the SOUL file to your agent's workspace. The file will be in Markdown format (.md).

3. Place in Agent Workspace

Locate your agent's SOUL.md file and replace its contents with the downloaded SOUL file. This file defines your agent's personality, behavior, and capabilities.

bash

# Example location
~/clawd/agent/SOUL.md

4. Restart Your Agent

Restart your agent to apply the new personality. The agent will load the new SOUL configuration on startup.

bash

# Restart command (example)
clawdbot gateway restart

What Happens Next?

Once installed, your agent will:

Adopt the personality traits defined in the SOUL
Follow the behavior patterns and guidelines
Use the communication style specified
Execute tasks according to the SOUL's framework

Troubleshooting

Agent not reflecting changes?

Ensure you replaced the entire SOUL.md file
Check for syntax errors in the Markdown
Verify the agent service restarted successfully

SOUL file not working?

Confirm the file format is valid Markdown
Check file permissions in your workspace
Review agent logs for loading errors

Need Help?

If you encounter issues:

Check the Getting Started guide
Visit our Support page
Join the community Discord

Ready to explore more personalities? Browse all SOULs →