Agent Creator

这是创建OpenClaw AI代理的工具，核心功能是收集/推断代理名称、性格等信息（必填名称、特质、风格，其余可默认），生成SOUL.md、IDENTITY.md、AGENTS.md三个身份文件并打包为.skill压缩包，还支持上传至ClawHub或部署到运行中的代理。适用于用户创建、配置新AI代理角色的场景，输出为可直接使用的.skill文件。

maverick-software

热度 74.14

最近更新 2026-05-11 17:29:56

分类：开发依赖：代码执行 / 读写文件 / 第三方 API应用场景：自动化脚本 / 模板 / 工作流

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add agent-creator

Metadata

name: agent-creator
description: Create a new AI agent identity (SOUL.md, IDENTITY.md, AGENTS.md) and package it as a .skill file ready to upload to ClawHub. Use when a user wants to create, configure, or package a new named AI agent persona — including personality, operational rules, and workspace identity. Triggers on requests like "create an agent", "build me an agent", "make a new persona", "set up an agent identity", or "package this agent for ClawHub".

Agent Creator

Generates the three core identity files for a new OpenClaw agent, packages them as a .skill file, and optionally publishes to ClawHub.

Workflow

Step 1 — Gather Agent Details

Ask the user (or infer from context) for:

Field	Example
Name	Aria
Emoji	✨
Nature	AI companion — sharp, reliable, with genuine care
Vibe	Warm but direct. Smart without being showy.
Serving	Solo founders who need a reliable thinking partner
Slug	`aria` (auto-derived from name; user can override)
Version	`1.0.0`

Minimum required: name, nature, vibe. Everything else has sensible defaults.

Step 2 — Generate & Package

Run the bundler script:

python3 ~/.openclaw/workspace/skills/agent-creator/scripts/create_agent_bundle.py \
  --name "Aria" \
  --emoji "✨" \
  --nature "AI companion — sharp, reliable, with genuine care" \
  --vibe "Warm but direct. Smart without being showy." \
  --serving "Solo founders who need a reliable thinking partner" \
  --slug aria \
  --version 1.0.0 \
  --output-dir ~/.openclaw/workspace/skills/dist

This produces ~/.openclaw/workspace/skills/dist/aria.skill.

Step 3 — Upload to ClawHub (optional)

If the user wants to publish:

# Login first (one-time)
clawhub login

# Publish
clawhub publish ~/.openclaw/workspace/skills/dist/aria.skill \
  --slug aria \
  --name "Aria" \
  --version 1.0.0 \
  --changelog "Initial release"

Step 4 — Install on a Target Agent (optional)

To apply the identity to a running OpenClaw agent, copy the workspace files:

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

# Copy to target agent workspace
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/

# Restart the gateway
systemctl --user restart openclaw-gateway  # or delay-restart for VPS

Output Structure

The .skill file contains:

{slug}/
├── SKILL.md                         ← Install instructions for the agent
└── assets/
    └── workspace-template/
        ├── SOUL.md                  ← Personality & values
        ├── IDENTITY.md              ← Name, emoji, avatar
        └── AGENTS.md                ← Operational rules & memory system

Template Placeholders

The templates in assets/workspace-template/ use {{PLACEHOLDER}} tokens:

Token	Filled With
`{{AGENT_NAME}}`	Agent's name
`{{AGENT_EMOJI}}`	Agent's emoji
`{{AGENT_NATURE}}`	One-line nature description
`{{AGENT_VIBE}}`	Personality vibe
`{{AGENT_SLUG}}`	URL-safe slug
`{{AGENT_AVATAR}}`	Avatar path (default: not yet set)
`{{DATE}}`	Today's date

Notes

Output dir defaults to ~/.openclaw/workspace/skills/dist/ — create it if needed
Slug must be lowercase letters, digits, and hyphens only
The .skill file is a zip archive — inspect with unzip -l {file}.skill
For VPS agents, use (sleep 3 && systemctl restart openclaw.service) & before sending final reply