Agent Creator

为新的OpenClaw代理生成三个核心身份文件，将其打包为.skill文件，并可选择发布到ClawHub。

工作流程

第一步 — 收集代理详情

向用户询问（或从上下文中推断）以下信息：

字段	示例
名称	Aria
表情符号

✨ |
| 本质 | AI伴侣——敏锐、可靠、真诚关怀 |
| 气质 | 温暖而直接。聪明但不张扬。 |
| 服务对象 | 需要可靠思维伙伴的独立创始人 |
| 标识符 | aria（自动从名称派生；用户可覆盖） |
| 版本 | 1.0.0 |

最低要求：名称、本质、气质。其他字段均有合理的默认值。

第二步 — 生成与打包

运行打包脚本：

bash
python3 ~/.openclaw/workspace/skills/agent-creator/scripts/createagentbundle.py \
--name Aria \
--emoji ✨ \
--nature AI伴侣——敏锐、可靠、真诚关怀 \
--vibe 温暖而直接。聪明但不张扬。 \
--serving 需要可靠思维伙伴的独立创始人 \
--slug aria \
--version 1.0.0 \
--output-dir ~/.openclaw/workspace/skills/dist

这将生成 ~/.openclaw/workspace/skills/dist/aria.skill。

第三步 — 上传到ClawHub（可选）

如果用户想要发布：

bash

先登录（一次性操作）

clawhub login

发布

clawhub publish ~/.openclaw/workspace/skills/dist/aria.skill \ --slug aria \ --name Aria \ --version 1.0.0 \ --changelog 初始版本

第四步 — 安装到目标代理（可选）

要将身份应用到运行中的OpenClaw代理，复制工作区文件：

bash

解压技能包

unzip -o ~/.openclaw/workspace/skills/dist/aria.skill -d /tmp/aria-skill

复制到目标代理工作区

cp /tmp/aria-skill/aria/assets/workspace-template/SOUL.md /path/to/workspace/ cp /tmp/aria-skill/aria/assets/workspace-template/IDENTITY.md /path/to/workspace/ cp /tmp/aria-skill/aria/assets/workspace-template/AGENTS.md /path/to/workspace/

重启网关

systemctl --user restart openclaw-gateway # 或对VPS使用延迟重启

输出结构

.skill文件包含：

{标识符}/
├── SKILL.md ← 代理的安装说明
└── assets/
└── workspace-template/
├── SOUL.md ← 个性与价值观
├── IDENTITY.md ← 名称、表情符号、头像
└── AGENTS.md ← 操作规则与记忆系统

模板占位符

assets/workspace-template/中的模板使用{{占位符}}标记：

标记	填充内容
{{AGENTNAME}}	代理名称
{{AGENTEMOJI}}

代理表情符号 |
| {{AGENT_NATURE}} | 一行本质描述 |
| {{AGENT_VIBE}} | 个性气质 |
| {{AGENT_SLUG}} | URL安全的标识符 |
| {{AGENT_AVATAR}} | 头像路径（默认：尚未设置） |
| {{DATE}} | 当前日期 |

备注

• - 输出目录默认为 ~/.openclaw/workspace/skills/dist/ — 如不存在则创建
• 标识符只能包含小写字母、数字和连字符
• .skill文件是一个zip压缩包 — 使用 unzip -l {文件名}.skill 查看内容
• 对于VPS代理，在发送最终回复前使用 (sleep 3 && systemctl restart openclaw.service) &