Create Agents Wizard
Follow this workflow to create multiple agents with low user effort.
1) Confirm scope
- 1. Ask for total agent count
N. - Ask each agent
id (lowercase letters/digits/hyphens only). - Ask each workspace path (default
~/.openclaw/workspace-<id>). - Ask scaffold mode:
-
Standard (default): 6 files
-
AGENTS.md,
SOUL.md,
IDENTITY.md,
BOOTSTRAP.md,
USER.md,
STYLE.md
-
Fast mode: 2 files only
-
AGENTS.md,
SOUL.md
- 5. If user does not specify, use Standard by default.
2) Process one agent at a time
For each agent, collect info and draft files in fixed order.
- 1. Ask focused questions (use
references/question-bank.md if available). - Produce an improved draft from user input.
- Ask explicit confirmation:
Confirm write / Revise. - Write only after confirmation; otherwise keep iterating.
Rules:
- - Do not dump a long questionnaire; ask in small rounds (2–4 key questions each).
- Preserve user intent; do not change direction without consent.
- Respect selected mode (Standard 6 files or Fast 2 files).
- If user requests partial scaffolding, allow writing only the confirmed subset and continue/stop as requested.
3) Write files and create agent
After required files for one agent are confirmed:
- 1. If agent does not exist, create it:
-
openclaw agents add <id> --workspace <path>
- 2. Write approved files into workspace root.
- Optional batch helper:
-
scripts/scaffold.sh --agent <id> --workspace <path> --from <approved_dir> --force
- 3. Optional identity setup:
- INLINECODE15
If user wants docs only, skip CLI config changes.
4) Final summary
When all agents are done, report:
- - Created agents (id + workspace)
- Written file list per agent
- INLINECODE16 output (if CLI available)
- Next-step suggestions (skills, routing, default models)
5) Quality bar
- -
AGENTS.md: operation rules, safety boundaries, heartbeat/external-action policy - INLINECODE18 : values, working principles, boundaries, style
- INLINECODE19 : name, type, vibe, emoji, avatar convention
- INLINECODE20 : first-conversation script and initialization steps
- INLINECODE21 : addressing, timezone, preferences, taboos, work/life context
- INLINECODE22 : tone, length preference, banned words, output format preference
6) Failure handling
- - Conflicting user inputs: point out conflicts and offer 2 concrete revision options.
- Too-short answers: provide a minimal viable template, then request missing details.
- Scope change mid-way: reconfirm scope, then continue serial processing.
- Write failure: report exact path + error and provide retry command.
创建智能体向导
按照此工作流程，以较低的用户操作成本创建多个智能体。
1) 确认范围
- 1. 询问智能体总数 N。
- 询问每个智能体的 id（仅限小写字母/数字/连字符）。
- 询问每个工作区路径（默认为 ~/.openclaw/workspace-）。
- 询问脚手架模式：
-
标准模式（默认）： 6个文件
- AGENTS.md、SOUL.md、IDENTITY.md、BOOTSTRAP.md、USER.md、STYLE.md
-
快速模式： 仅2个文件
- AGENTS.md、SOUL.md
- 5. 如果用户未指定，默认使用标准模式。
2) 逐个处理智能体
对于每个智能体，按固定顺序收集信息并起草文件。
- 1. 提出针对性问题（如有 references/question-bank.md 则使用）。
- 根据用户输入生成改进后的草稿。
- 明确请求确认：确认写入 / 修订。
- 仅在确认后写入；否则继续迭代。
规则：
- - 不要一次性抛出冗长问卷；分小轮次提问（每轮2-4个关键问题）。
- 保留用户意图；未经同意不得改变方向。
- 尊重所选模式（标准模式6个文件或快速模式2个文件）。
- 如果用户请求部分脚手架搭建，允许仅写入已确认的子集，并按请求继续/停止。
3) 写入文件并创建智能体
在确认一个智能体所需的文件后：
- 1. 如果智能体不存在，则创建它：
- openclaw agents add
--workspace
- 2. 将已批准的文件写入工作区根目录。
- 可选的批量辅助工具：
- scripts/scaffold.sh --agent --workspace --from --force
- 3. 可选的身份设置：
- openclaw agents set-identity --workspace --from-identity
如果用户仅需要文档，则跳过CLI配置更改。
4) 最终总结
当所有智能体完成后，报告：
- - 已创建的智能体（id + 工作区）
- 每个智能体已写入的文件列表
- openclaw agents list 输出（如果CLI可用）
- 后续步骤建议（技能、路由、默认模型）
5) 质量标准
- - AGENTS.md：操作规则、安全边界、心跳/外部操作策略
- SOUL.md：价值观、工作原则、边界、风格
- IDENTITY.md：名称、类型、氛围、表情符号、头像约定
- BOOTSTRAP.md：首次对话脚本和初始化步骤
- USER.md：称呼、时区、偏好、禁忌、工作/生活背景
- STYLE.md：语气、长度偏好、禁用词、输出格式偏好
6) 失败处理
- - 用户输入冲突：指出冲突并提供2个具体的修订选项。
- 回答过短：提供最小可行模板，然后请求缺失的细节。
- 中途范围变更：重新确认范围，然后继续串行处理。
- 写入失败：报告确切路径 + 错误并提供重试命令。
