{
  "agent-id": "hr-bot",
  "agent-name": "HR Assistant",
  "workspace": "C:\\Users\\Administrator\\.openclaw\\workspace-hr",
  "feishu-binding": true,
  "feishu-account-id": "hr",
  "feishu-app-id": "cli_xxx",
  "feishu-app-secret": "xxx"
}

Agent Creator (Agent 创建器)

此技能帮助你创建具有独立工作区、配置和可选飞书机器人绑定的 独立 OpenClaw Agent。

何时使用

当用户希望执行以下操作时使用此技能：

• - 创建一个拥有自己工作区的完全隔离的 Agent
• 为特定项目/客户设置专用 Agent
• 部署多个飞书机器人，每个机器人具有独立的身份
• 创建长期运行的专用 Agent（而不是临时子 Agent）

触发请求示例：

• - 帮我创建一个客服 agent，用独立的 workspace
• 我需要一个专门处理设计师工作的 agent
• 创建一个新的飞书机器人，用于内部 IT 支持
• Create a standalone agent for customer support
• Set up a new Feishu bot for the HR team

两种模式

模式 1: Standalone Agent (独立 Agent - 推荐)

创建一个完全隔离的 Agent，包含：

• - 独立的工作区目录
• openclaw.json 中单独的 Agent 配置
• 可选的飞书机器人绑定
• 独立的身份和记忆

模式 2: Subagent Session (子 Agent 会话 - 临时)

创建一个临时子 Agent 会话（用于快速任务）。仅用于短期的辅助工作。

---

独立 Agent 创建流程

第 1 步：收集需求

询问用户（如果尚未提供）：

问题	目的
Agent ID	唯一标识符（例如：support, hr-bot, designer）
Agent Name

易读的名称 |
| Workspace Path | 存储 Agent 文件的位置（默认：~/.openclaw/workspace-{id}） |
| Feishu Bot? | 此 Agent 是否需要绑定飞书机器人？ |
| Feishu Account ID | 如果绑定到飞书，使用哪个账户 ID？（例如：support, hr） |
| Model | 此 Agent 应该使用哪个模型？ |

第 2 步：创建 Agent 目录结构

创建 Agent 目录：

~/.openclaw/agents/{agent-id}/
├── agent/
│ ├── auth-profiles.json
│ └── models.json
└── sessions/

第 3 步：更新 openclaw.json

将 Agent 添加到 agents.list：

json
{
agents: {
list: [
{
id: {agent-id},
name: {agent-name},
workspace: {workspace-path},
agentDir: {agent-dir-path}
}
]
}
}

第 4 步：创建飞书绑定（可选）

如果 Agent 需要飞书机器人，添加绑定：

json
{
bindings: [
{
type: route,
agentId: {agent-id},
match: {
channel: feishu,
accountId: {account-id}
}
}
]
}

第 5 步：配置飞书账户（可选）

如果使用单独的飞书应用，添加到 channels.feishu.accounts：

json
{
channels: {
feishu: {
accounts: {
{account-id}: {
enabled: true,
appId: {feishu-app-id},
appSecret: {feishu-app-secret},
domain: feishu,
groupPolicy: open
}
}
}
}
}

第 6 步：初始化 Agent 工作区

创建包含必要文件的工作区目录：

{workspace-path}/
├── AGENTS.md
├── SOUL.md
├── USER.md
├── IDENTITY.md
├── MEMORY.md
├── TOOLS.md
├── HEARTBEAT.md
└── memory/

第 7 步：重启 Gateway

修改 openclaw.json 后，Gateway 需要重新加载：

bash
openclaw gateway restart

或者通知用户手动重启。

---

脚本使用

使用提供的脚本自动创建 Agent：

bash
python scripts/createstandaloneagent.py \
--agent-id support \
--agent-name Customer Support Bot \
--workspace C:\Users\Administrator\.openclaw\workspace-support \
--feishu-account support \
--feishu-app-id cli_xxx \
--feishu-app-secret xxx

---

快速参考

所需信息

字段	必填	示例
agent-id	✅	support, hr-bot, designer
agent-name

✅ | Customer Support, HR Assistant | | workspace-path | ✅ | ~/.openclaw/workspace-support | | feishu-binding | ❌ | true 或 false | | feishu-account-id | ❌ | support, hr | | feishu-app-id | ❌ | cli_a9249b9ee9785cee | | feishu-app-secret | ❌ | PAY8vhyLkiLpfmun09sXSboJyoSQXK3g |

配置示例

简单 Agent（无飞书）
json
{
agent-id: research-assistant,
agent-name: Research Assistant,
workspace: C:\\Users\\Administrator\\.openclaw\\workspace-research
}

带飞书绑定的 Agent（共享应用）
json
{
agent-id: support,
agent-name: Customer Support,
workspace: C:\\Users\\Administrator\\.openclaw\\workspace-support,
feishu-binding: true,
feishu-account-id: support
}

带专用飞书应用的 Agent
json
{
agent-id: hr-bot,
agent-name: HR Assistant,
workspace: C:\\Users\\Administrator\\.openclaw\\workspace-hr,
feishu-binding: true,
feishu-account-id: hr,
feishu-app-id: cli_xxx,
feishu-app-secret: xxx
}

---

注意事项

• - Agent ID 在所有 Agent 中必须唯一
• Workspace 应该是一个新的空目录
• Feishu Account ID 用于绑定匹配，而不是实际的 App ID
• Gateway Restart 修改 openclaw.json 后必须重启
• Auth Profiles 和 Models 默认从主 Agent 复制
• Security: 小心处理飞书应用密钥；存储在 openclaw.json 中应具有适当的权限

---

子 Agent 模式（旧版）

对于临时助手，你仍然可以使用 sessions_spawn：

sessions_spawn({
task: <任务描述>,
runtime: subagent | acp,
mode: session | run,
label: ,
model: <模型别名>,
thread: true | false
})

但对于生产环境 Agent，请首选独立模式。

---

参考文件

• - 详细指南: 见 references/standalone-agent-guide.md 以获取完整文档
• 脚本帮助: 运行 python scripts/createstandaloneagent.py --help

---

快速开始

bash

简单 Agent（无飞书）

python scripts/createstandaloneagent.py \
--agent-id my-agent \
--agent-name My Agent

带飞书绑定的 Agent

python scripts/createstandaloneagent.py \ --agent-id support \ --agent-name Support Bot \ --feishu-account support

然后重启 Gateway

openclaw gateway restart