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 步：收集需求

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

第 2 步：创建 Agent 目录结构

创建 Agent 目录：

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

第 3 步：更新 openclaw.json

将 Agent 添加到 agents.list：

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

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

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

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

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

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

{
  "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 需要重新加载：

openclaw gateway restart

或者通知用户手动重启。

脚本使用

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

python scripts/create_standalone_agent.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（无飞书）

{
  "agent-id": "research-assistant",
  "agent-name": "Research Assistant",
  "workspace": "C:\\Users\\Administrator\\.openclaw\\workspace-research"
}

带飞书绑定的 Agent（共享应用）

{
  "agent-id": "support",
  "agent-name": "Customer Support",
  "workspace": "C:\\Users\\Administrator\\.openclaw\\workspace-support",
  "feishu-binding": true,
  "feishu-account-id": "support"
}

带专用飞书应用的 Agent

{
  "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: "<Agent 名称>",
  model: "<模型别名>",
  thread: true | false
})

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

参考文件

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

快速开始

# 简单 Agent（无飞书）
python scripts/create_standalone_agent.py \
  --agent-id my-agent \
  --agent-name "My Agent"

# 带飞书绑定的 Agent
python scripts/create_standalone_agent.py \
  --agent-id support \
  --agent-name "Support Bot" \
  --feishu-account support

# 然后重启 Gateway
openclaw gateway restart