BetterClaw
Agents

Agents overview

What an agent is, what it can do, and how many you can run.

Agents

An agent is an AI worker that lives in your workspace. Each agent has its own identity and configuration, so you can give different work to different specialists. Every agent has:

  • A name and avatar — how you tell agents apart in chats, tasks, and pickers.
  • A personality — plain-text instructions (its soul.md) that shape how it thinks, writes, and behaves.
  • A model — the LLM provider and model it runs on, plus its API key (see LLM configuration).
  • Skills — capabilities you install and enable for it (see Skills).
  • Secrets and connected accounts — the credentials and tools it's allowed to use.
  • A timezone — so scheduled work and "today" match your day.

Agents are created from templates (Research Analyst, Software Developer, Marketing Strategist, Finance Analyst, Content Writer, General Assistant) and you can customize everything afterward.

Agents do the work behind your chats and tasks, and they're who you reach through integrations like Telegram and Slack.

Where agents live

In the left rail, under Workspace settings, choose Agents. The Agents page lists every agent in the current workspace; select one to open its editor (personality, model, skills, secrets, usage). Per-agent LLM provider, model, API key, and timezone can also be configured from the workspace Settings page.

How many agents can I have?

PlanAgents per workspace
Free1
ProUp to 25

Each agent beyond the first adds $19/month to your invoice, prorated from the day you add it. Remove an agent anytime to stop the charge.

In this section

Create an agent

Add a new agent from a template and name it.

Agent settings

Personality, model, timezone, and lifecycle controls.