> ## Documentation Index
> Fetch the complete documentation index at: https://openclaw.veiseule.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# agents

# `openclaw agents`

管理相互隔離的代理程式（工作區 + 身分驗證 + 路由）。

Related:

* 多代理程式路由：[Multi-Agent Routing](/concepts/multi-agent)
* 代理程式工作區：[Agent workspace](/concepts/agent-workspace)

## 範例

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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
```

## 身分檔案

每個代理程式工作區都可以在工作區根目錄包含一個 `IDENTITY.md`：

* 範例路徑：`~/.openclaw/workspace/IDENTITY.md`
* `set-identity --from-identity` 會從工作區根目錄讀取（或使用明確指定的 `--identity-file`）

Avatar paths resolve relative to the workspace root.

## 設定身分

`set-identity` 會將欄位寫入 `agents.list[].identity`：

* `name`
* `theme`
* `emoji`
* `avatar`（工作區相對路徑、http(s) URL，或 data URI）

從 `IDENTITY.md` 載入：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw agents set-identity --workspace ~/.openclaw/workspace --from-identity
```

明確覆寫欄位：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw agents set-identity --agent main --name "OpenClaw" --emoji "🦞" --avatar avatars/openclaw.png
```

設定範例：

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  agents: {
    list: [
      {
        id: "main",
        identity: {
          name: "OpenClaw",
          theme: "space lobster",
          emoji: "🦞",
          avatar: "avatars/openclaw.png",
        },
      },
    ],
  },
}
```