`moltbot agents`

What it does: List and manage multiple agents. Manage isolated agents (workspaces + auth + routing).

Examples

Run this:


moltbot agents list
moltbot agents add work --workspace ~/clawd-work
moltbot agents set-identity --workspace ~/clawd --from-identity
moltbot agents set-identity --agent main --avatar avatars/clawd.png
moltbot agents delete work

Identity files

Each agent workspace can include an IDENTITY.md at the workspace root:

Example path: ~/clawd/IDENTITY.md
set-identity --from-identity reads from the workspace root (or an explicit --identity-file)

Avatar paths resolve relative to the workspace root.

Set identity

set-identity writes fields into agents.list[].identity:

name
theme
emoji
avatar (workspace-relative path, http(s) URL, or data URI)

Load from IDENTITY.md:


moltbot agents set-identity --workspace ~/clawd --from-identity

Override fields explicitly:


moltbot agents set-identity --agent main --name "Clawd" --emoji "🦞" --avatar avatars/clawd.png

Config sample:


{
  agents: {
    list: [\
      {\
        id: "main",\
        identity: {\
          name: "Clawd",\
          theme: "space lobster",\
          emoji: "🦞",\
          avatar: "avatars/clawd.png"\
        }\
      }\
    ]
  }
}