# agents

# `openclaw agents`

Manage isolated agents (workspaces + auth + routing).

## Key Features

**Agent Management Commands:**
The tool supports several operations including listing agents, adding new ones to specific workspaces, configuring identities, and deleting agents.

**Identity Configuration:**
Each agent workspace can contain an `IDENTITY.md` file at its root. Agents can be customized with fields such as name, theme, emoji, and avatar. Avatar files can reference workspace-relative paths, URLs, or data URIs.

**Identity Setup Methods:**
Users can load identity settings from an `IDENTITY.md` file or override specific properties directly via command-line arguments.

**Configuration Structure:**
Identity information is stored in the configuration under `agents.list[].identity`, containing customizable display properties that personalize each agent's presentation.

## Commands

```bash
openclaw agents list
openclaw agents add <name> --workspace <path>
openclaw agents delete <id>
```

Related concepts: multi-agent routing and agent workspace architecture.
