How to create different agents

[fickle dagger]

To help others find answers, you can mark your question as solved via Right click solution message -> Apps -> ✅ Mark Solution

[tiny temple]

You can create separate agents with their own folders, workspaces, and personalities! This is built into Clawdbot via multi-agent routing.

Quick Answer

Use the agent wizard to add a new isolated agent:

pnpm clawdbot agents add work

Then configure your ~/.clawdbot/clawdbot.json with bindings to route messages to different agents.

How It Works

Each agent gets its own:

• Workspace (~/clawd-{name}) - files, AGENTS.md/SOUL.md/USER.md, persona
• State directory (~/.clawdbot/agents/{agentId}/agent/) - auth profiles, model registry

• Sessions - isolated chat history

Example Config (~/.clawdbot/clawdbot.json)

{
  agents: {
    list: [
      {
        id: "main",
        default: true,
        workspace: "~/clawd"
      },
      {
        id: "work",
        workspace: "~/clawd-work"

      }
    ]
  },
  bindings: [
    { agentId: "work", match: { channel: "discord", guildId: "YOUR_WORK_GUILD_ID" } }
  ]
}

Key Concepts

• agentId = one "brain" (workspace, auth, sessions)
• accountId = one channel account (e.g., separate WhatsApp numbers)
• binding = routes inbound messages to an agent

Full Documentation

See the multi-agent docs: https://docs.clawd.bot/concepts/multi-agent

Happy to help you set this up! 🦐

[proud compass]

Okay, but I want it to just run the agent I want to run, not that a certain message will be rerouted to one of the agents

[tiny temple]

For completely separate, independently runnable bots, you have two options:

Option 1: Separate Folder (Simple)

Just clone to a new folder and run independently:

cd ~
git clone https://github.com/clawdbot/clawdbot my-other-bot
cd my-other-bot
pnpm install
pnpm clawdbot configure  # New config in ~/.clawdbot-other/

Then run with a different state directory:

CLAWDBOT_STATE_DIR=~/.clawdbot-other pnpm clawdbot gateway start

Option 2: Use CLAWDBOT_PROFILE

Set a profile prefix to get separate workspace and state:

CLAWDBOT_PROFILE=work pnpm clawdbot gateway start

This gives you:

• Workspace: ~/clawd-work
• State: ~/.clawdbot/agents/work/
And for the other bot:

CLAWDBOT_PROFILE=personal pnpm clawdbot gateway start

Quick Summary

| Method                | Config                          | State                    | Workspace      |
| --------------------- | ------------------------------- | ------------------------ | -------------- |
| Default               | `~/.clawdbot/clawdbot.json`       | `~/.clawdbot/`             | `~/clawd`        |
| CLAWDBOT_PROFILE=work | same                            | `~/.clawdbot/agents/work/` | `~/clawd-work`   |
| Separate folder       | `~/.clawdbot-other/clawdbot.json` | `~/.clawdbot-other/`       | `~/my-other-bot` |

Option 2 is easiest if you just want different personalities/configs. Option 1 if you want completely isolated everything.

Let me know which direction you'd like to go! 🦐

[proud compass]

Can you explain better how option 1 works? How do I make another bot if I have 1 already but wanna use the other one, how do I then switch to that one / use that one. Explain it in a simple way

[tiny temple]

Simple Guide: Two Separate Bots

Step 1: Create the second bot folder

cd ~
git clone https://github.com/clawdbot/clawdbot my-second-bot
cd my-second-bot
pnpm install

Step 2: Configure it

pnpm clawdbot configure

This creates ~/.clawdbot-mysecondbot/ for this bot's settings.

Step 3: Run the bot you want

To run bot #1 (original):

cd ~/clawd
pnpm clawdbot gateway start

To run bot #2 (new one):

cd ~/my-second-bot
CLAWDBOT_STATE_DIR=~/.clawdbot-mysecondbot pnpm clawdbot gateway start

Step 4: Stop one, start the other