# Send Create Agent to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "create-openclaw-agent",
    "name": "Create Agent",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/mengwuzhi/create-openclaw-agent",
    "canonicalUrl": "https://clawhub.ai/mengwuzhi/create-openclaw-agent",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/create-openclaw-agent",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=create-openclaw-agent",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "GET_TOKEN.md",
      "PUBLISH.md",
      "README.md",
      "SKILL.md",
      "scripts/create_agent.py"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "create-openclaw-agent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T22:15:57.942Z",
      "expiresAt": "2026-05-07T22:15:57.942Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=create-openclaw-agent",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=create-openclaw-agent",
        "contentDisposition": "attachment; filename=\"create-openclaw-agent-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "create-openclaw-agent"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/create-openclaw-agent"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/create-openclaw-agent",
    "downloadUrl": "https://openagent3.xyz/downloads/create-openclaw-agent",
    "agentUrl": "https://openagent3.xyz/skills/create-openclaw-agent/agent",
    "manifestUrl": "https://openagent3.xyz/skills/create-openclaw-agent/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/create-openclaw-agent/agent.md"
  }
}
```
## Documentation

### create-agent

version: 1.0.0
author: 大总管
description: 一键创建新的 OpenClaw agent，包含完整的身份定义、团队集成和配置

### 功能

✅ 创建 agent 目录结构
✅ 生成身份文件模板（IDENTITY.md/SOUL.md/AGENTS.md/USER.md）
✅ 自动更新 openclaw.json（agents.list + bindings）
✅ 自动更新 TEAM.md（团队架构）
✅ 支持多种预设角色（开发/测试/运维/写作/产品等）
✅ 支持自定义模型和 Channel 配置

### 安装

clawhub install create-agent

或手动安装：

git clone <repo> ~/.openclaw/workspace/skills/create-agent

### 交互式模式（推荐）

python3 ~/.openclaw/workspace/skills/create-agent/scripts/create_agent.py
# 或
python3 ~/.openclaw/workspace/skills/create-agent/scripts/create_agent.py --interactive

按提示输入：

Agent ID（如 dev-fe）
Agent 名称（如 前端工程师）
选择预设角色（8 个模板可选）
选择模型（4 个常用模型）
选择 Channel（telegram/飞书）
选择 Emoji
确认工作区路径
预览或执行

### 命令行模式

openclaw skill create-agent \\
  --id "dev-fe" \\
  --name "前端工程师" \\
  --role "frontend" \\
  --model "openai-codex/gpt-5.3-codex" \\
  --channel "feishu" \\
  --emoji "💻"

### 创建写作 Agent（示例）

openclaw skill create-agent \\
  --id "inkflow" \\
  --name "写作与分享助手" \\
  --role "writer" \\
  --model "bailian/qwen3.5-plus" \\
  --channel "telegram" \\
  --emoji "🖋️" \\
  --workspace "/root/.openclaw/workspace-writing"

### 参数说明

参数必填说明默认值--id✅Agent ID（字母 + 数字 + 连字符）---name✅Agent 显示名称---role❌预设角色模板custom--model❌使用的模型bailian/qwen3.5-plus--channel❌通信渠道telegram--emoji❌Agent emoji🤖--workspace❌工作区路径/root/.openclaw/workspace-<id>--dry-run❌预览不执行false

### 开发团队角色

Role说明默认模型dev-tl技术负责人 + 产品设计openai-codex/gpt-5.3-codexdev-fs全栈工程师openai-codex/gpt-5.3-codexdev-qa测试工程师openai-codex/gpt-5.3-codexdev-ops运维工程师openai-codex/gpt-5.3-codexdev-fe前端工程师openai-codex/gpt-5.3-codexdev-be后端工程师openai-codex/gpt-5.3-codex

### 其他角色

Role说明默认模型writer写作与分享助手bailian/qwen3.5-plusanalyst数据分析师bailian/qwen3.5-plusresearcher研究员bailian/qwen3.5-pluscustom自定义角色bailian/qwen3.5-plus

### Agent 目录结构

~/.openclaw/agents/<id>/agent/
├── IDENTITY.md    # 身份定义
├── SOUL.md        # 角色定位和工作原则
├── AGENTS.md      # 工作流程（引用 TEAM.md）
├── USER.md        # 用户偏好
├── auth.json      # 认证信息（自动生成）
└── models.json    # 模型配置（自动生成）

### 工作区目录

~/.openclaw/workspace-<id>/
├── AGENTS.md      # 引用 TEAM.md
├── SOUL.md        # 同步自 agent 目录
├── USER.md        # 同步自 agent 目录
├── IDENTITY.md    # 同步自 agent 目录
├── memory/        # 记忆文件
└── .openclaw/     # 会话存储

### 1. 更新 openclaw.json

自动添加：

{
  "agents": {
    "list": [
      {
        "id": "<id>",
        "name": "<name>",
        "workspace": "<workspace>",
        "agentDir": "~/.openclaw/agents/<id>/agent",
        "model": "<model>",
        "identity": {
          "name": "<name>",
          "theme": "<role>",
          "emoji": "<emoji>"
        }
      }
    ]
  },
  "bindings": [
    {
      "agentId": "<id>",
      "match": {
        "channel": "<channel>",
        "accountId": "<id>"
      }
    }
  ]
}

### 2. 更新 TEAM.md

自动添加新 agent 信息到团队架构文档。

### 3. 创建 Channel 账号

如需要，自动在 channels.<channel>.accounts 中添加账号配置。

### 示例输出

$ openclaw skill create-agent --id "dev-fe" --name "前端工程师" --role "dev-fe"

🔧 正在创建 agent: dev-fe

[1/6] 创建目录结构...
  ✓ ~/.openclaw/agents/dev-fe/agent/
  ✓ ~/.openclaw/workspace-dev-fe/

[2/6] 生成身份文件...
  ✓ IDENTITY.md
  ✓ SOUL.md
  ✓ AGENTS.md
  ✓ USER.md

[3/6] 更新 openclaw.json...
  ✓ 添加 agent 到 agents.list
  ✓ 添加 binding 规则
  ✓ 添加 telegram 账号配置

[4/6] 更新 TEAM.md...
  ✓ 添加 dev-fe 到团队架构

[5/6] 设置文件权限...
  ✓ 认证文件权限：600

[6/6] 验证配置...
  ✓ 配置语法检查通过

✅ Agent "dev-fe" 创建完成！

下一步：
1. 配置 Channel Token（如需要）
2. 重启 Gateway: openclaw gateway restart
3. 验证 agent: openclaw agents list --bindings

### 配置 Channel

根据选择的 Channel，配置相应的 Token：

Telegram:

# 在 BotFather 创建 bot，获取 token
# 编辑 openclaw.json:
channels.telegram.accounts.<id>.botToken = "<token>"

飞书:

# 在飞书开放平台创建应用
# 设置环境变量：
export DEV_FE_APP_ID="cli_xxx"
export DEV_FE_APP_SECRET="xxx"

### 重启 Gateway

openclaw gateway restart

### 验证

openclaw agents list --bindings
openclaw channels status

### 删除 Agent

openclaw skill delete-agent --id "dev-fe"

会：

从 openclaw.json 移除配置
从 TEAM.md 移除信息
删除 agent 目录（可选备份）
删除工作区目录（可选备份）

### 安全

认证文件权限自动设置为 600
Token 建议使用环境变量
敏感信息不要提交到版本控制

### 命名规范

Agent ID：小写字母 + 数字 + 连字符（如 dev-fe）
Agent 名称：中文或英文（如 前端工程师）
工作区：~/.openclaw/workspace-<id>

### 模型选择

场景推荐模型代码/配置操作openai-codex/gpt-5.3-codex复杂推理anthropic/claude-sonnet-4-6日常任务bailian/qwen3.5-plus长文本分析bailian/kimi-k2.5

### 问题：Gateway 启动失败

# 检查配置语法
openclaw doctor

# 查看详细日志
openclaw logs --follow

### 问题：Agent 不响应

# 检查路由配置
openclaw agents list --bindings

# 检查 Channel 状态
openclaw channels status

### 问题：TEAM.md 更新失败

手动编辑 /root/.openclaw/workspace/TEAM.md，添加新 agent 信息。

### 变更历史

版本日期变更1.0.02026-02-28初始版本

### 许可证

MIT License

来源： 基于 2026-02-28 创建 InkFlow agent 的实战经验总结
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: mengwuzhi
- Version: 1.0.1
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-04-30T22:15:57.942Z
- Expires at: 2026-05-07T22:15:57.942Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/create-openclaw-agent)
- [Send to Agent page](https://openagent3.xyz/skills/create-openclaw-agent/agent)
- [JSON manifest](https://openagent3.xyz/skills/create-openclaw-agent/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/create-openclaw-agent/agent.md)
- [Download page](https://openagent3.xyz/downloads/create-openclaw-agent)