CLI Reference • TutorialHeader.readTime
Agents
CLI reference for openclaw agents (list/add/remove/set identity).
Manage isolated agents (workspace + identity + routing).
Related:
- Multi-agent routing: ''Multi-agent routing''
- Agent workspace: ''Agent workspace''
Tutorial.step
Examples
Bash
openclaw agents list openclaw agents add work --workspace ~/.openclaw/workspace-work openclaw agents set-identity --workspace ~/.openclaw/workspace --from-identity openclaw agents set-identity --agent main --avatar avatars/openclaw.png openclaw agents delete work
Tutorial.step
Identity file
Each agent workspace can contain an ''IDENTITY.md'' in the workspace root:
- Example path: ''~/.openclaw/workspace/IDENTITY.md''
- ''set-identity --from-identity'' reads from workspace root (or explicit ''--identity-file'')
Avatar paths are resolved relative to workspace root.
Tutorial.step
Setting identity
''set-identity'' writes fields to ''agents.list[].identity'':
- ''name''
- ''theme''
- ''emoji''
- ''avatar'' (workspace-relative path, http(s) URL, or data URI)
Bash
openclaw agents set-identity --workspace ~/.openclaw/workspace --from-identity
Load from ''IDENTITY.md'':
Bash
openclaw agents set-identity --agent main --name "OpenClaw" --emoji "🦞" --avatar avatars/openclaw.png
Explicit field overrides:
Json5
{
agents: {
list: [
{
id: "main",
identity: {
name: "OpenClaw",
theme: "space lobster",
emoji: "🦞",
avatar: "avatars/openclaw.png",
},
},
],
},
}