Agents
The Agents page lists all configured agents in your OpenClaw instance, showing their status, model, and activity.
Agent List
Each agent card displays:
- Name and emoji — from the agent’s
IDENTITY.md - Profile photo — auto-detected from the agent’s workspace
- Primary model — the model configured for the agent
- Active sessions — number of currently running sessions
- Last active — relative time since the agent’s last activity
- Channel badges — which channels the agent is connected to (Telegram, WhatsApp, etc.)
Sorting
Agents can be sorted three ways using the sort popover:
| Sort mode | Behavior |
|---|---|
| Name | Alphabetical by agent name |
| Last Active | Most recently active first |
| Custom | Manual drag-to-reorder (persisted to database) |
In Custom mode, a drag handle appears on each card. Your custom order is saved via the API and persists across devices.
Agent Detail Page
Click an agent to see its detail page with:
Sessions
All sessions for the agent with:
- Session key and label
- Current model being used
- Token usage (input/output)
- Last active timestamp
- Context usage percentage
Transcript
View the full conversation transcript for any session. Useful for debugging agent behavior.
Workspace
Browse the agent’s workspace files directly from the detail page — SOUL.md, AGENTS.md, TOOLS.md, etc.
Creating Agents
The Agents page includes an Add Agent button that launches a step-by-step wizard:
Name & Username
Set the agent’s display name and username (used for the workspace folder).
Model Selection
Choose primary, fallback, heartbeat, and sub-agent models from auto-detected available models.
Heartbeat Config
Set heartbeat interval and active hours.
Core Files
Start from a template or copy files from an existing agent.
The wizard creates the agent’s workspace folder with template files (SOUL.md, AGENTS.md, USER.md, TOOLS.md, IDENTITY.md, MEMORY.md, HEARTBEAT.md).