Agents
Create, customize, and manage your AI agents - from personality to multi-agent setups.
What is an Agent?
An agent is an AI personality with its own identity, instructions, memory, and connections. Think of it as a configured "instance" of your AI assistant. Your default agent is called main, but you can create as many agents as you need.
Each agent has a workspace - a folder containing its core files: SOUL.md (personality), USER.md (info about who it assists), AGENTS.md (mission/instructions), IDENTITY.md (name, emoji, avatar), and TOOLS.md (local tool notes).
Agent Core Files
Each agent's workspace contains markdown files that define who it is:
SOUL.md
The agent's personality, tone, values, and behavioral guidelines. This is the heart of what makes each agent unique.
USER.md
Information about the person(s) this agent assists - name, preferences, context. Helps the agent be more helpful.
AGENTS.md
The agent's mission and detailed instructions. What it should focus on, how it should approach tasks.
IDENTITY.md
Name, emoji, creature type, and avatar. The agent's "business card."
TOOLS.md
Notes about the local environment - device names, SSH hosts, API specifics. The agent's cheat sheet.
MEMORY.md
Long-term memory. The agent reads and updates this file to remember things across sessions.
HEARTBEAT.md
Scheduled tasks and proactive behaviors. Defines what the agent does during heartbeat pulses.
💡 Tip: You can edit these files directly in ClawManager's editor, or open them in any text editor - they're just markdown files on your disk.
Creating a New Agent
There are several ways to create a new agent:
The Hatch Wizard 🥚
The friendliest way to create an agent. Click Hatch New Agent in the agent list. The wizard walks you through naming your agent, choosing an emoji, setting its personality, and creating all workspace files. It supports three modes: new workspace setup, new agent creation, and cloning from an existing agent.
Cloning an Existing Agent
Want a new agent similar to one you already have? Use the Hatch Wizard in clone mode. This pre-fills the wizard with the source agent's files, which you can then customize. Great for creating specialized variants of a working setup.
Manual Creation
For power users: create a workspace directory and add the markdown files yourself. Register the agent by adding it to your OpenClaw config.
Chat
ClawManager includes a built-in Chat interface for talking directly to your agent from the dashboard. Features include:
- • Session sidebar - Browse and switch between conversation sessions
- • Message search - Search across your chat history
- • Session timeline - Visual timeline of session activity
- • Keyboard shortcuts - Power-user shortcuts for fast navigation
- • File attachments - Send files to your agent
- • Connection status - Live online/offline/reconnecting indicator
The Chat tab is in the agent section of the sidebar - select an agent first, then click Chat.
Identity & Personality
The Personality page in ClawManager has two sub-tabs:
Soul
Edit your agent's SOUL.md - its core personality. This defines how it communicates, what it cares about, and its behavioral guidelines. The soul is injected into every conversation, shaping all interactions.
User Profile
Edit USER.md - information about the person the agent assists. Name, timezone, preferences, ongoing projects. The more context here, the more personalized the agent's responses become.
Per-Agent Settings
Each agent has its own settings tabs. In Advanced View, you get access to all of them:
| Agent Dashboard | Per-agent command center with identity, model, tools, workspace files, and audit trail |
| Chat | Direct conversation interface with session management |
| Blueprint | Complete agent spec - identity, soul, user context, and rules in one view |
| Instructions | Edit AGENTS.md - the agent's mission and behavior rules |
| Memory | Long-term memory (MEMORY.md), daily notes, and memory search |
| Tools | Edit TOOLS.md - notes about the local environment |
| Model | Per-agent model override (overrides the global default) |
| Permissions | Tool profile, allow/deny lists, and elevated access |
| Behaviour | Per-agent heartbeat, sandbox mode, and group chat mention patterns |
| Heartbeat | Per-agent heartbeat schedule, interval, and prompt |
| Efficiency | Prompt efficiency analysis and optimization (Pro) |
| Relations | Sub-agents this agent can spawn, and peer agent relationships |
| Routing | Channel bindings and message routing rules |
| Channels | Per-agent channel connections |
Multi-Agent Setup
You can run multiple agents simultaneously, each with different personalities, models, and channel assignments. See Multi-Agent & Routing for full details on routing, sub-agents, team workflows, and common setups.
Switching Between Agents
ClawManager has an agent switcher in the sidebar. Click on any agent to view and edit its settings. All tabs show settings for the currently selected agent - so you can configure each agent independently.
Next Steps
Give your agent new abilities with Skills & Tools, set up background tasks in Automation, or run multiple agents with Multi-Agent & Routing.