4.12 agents命令

openclaw agents 命令用于管理具有专用工作区、身份验证和路由功能的隔离代理。

概述

openclaw agents 命令管理具有专用工作区（workspace）、身份验证（authentication）和路由功能的隔离代理。

主要命令

# 显示所有代理
openclaw agents list

# 创建新代理
openclaw agents add <name> --workspace <path>

# 配置代理属性
openclaw agents set-identity

# 删除代理
openclaw agents delete <name>

身份配置

代理可以在 agents.list[].identity 中存储身份元数据：

属性	说明
name	代理显示名称
theme	视觉主题标识
emoji	图标表示
avatar	图像引用（工作区相对路径、URL 或 data URI）

从文件加载身份

系统会从工作区根目录读取 IDENTITY.md 文件。使用 set-identity --from-identity 时，会自动从此文件位置获取身份数据。

设置身份示例

通过文件填充身份：

openclaw agents set-identity --workspace ~/.openclaw/workspace --from-identity

或覆盖特定字段：

openclaw agents set-identity --agent main --name "OpenClaw" --emoji "🦞"

相关概念

• 多代理路由功能
• 代理工作区管理