技能介绍

要解决什么问题

在 OpenClaw 里多 agent 协作时，手工跑 openclaw agents add 容易漏字段、workspace 路径算错，或者新建目录里只有空壳模板——IDENTITY.md、SOUL.md、USER.md 没按你的角色填好，模型仍按默认「通用人格」在工作。

本技能把「注册 agent + 初始化文档」收成一条可重复的标准流程：对话里逐项确认名字、定位、模型和 workspace，再调用脚本完成 CLI 注册，并用 edit 精准改文档（保留 OpenClaw 模板里的 Core Truths、Boundaries 等通用约束，只替换/追加与角色相关的内容）。

工作方式

第一步严格一问一答（共 4 个必问项 + 头像自动匹配）：

名字：决定工作目录名、UI 显示名和群里 @ 名
定位：用途、风格、emoji；AI 根据描述从 avatars/ 里按关键词选 SVG（如教育→teacher-female.svg，默认 worker.svg）
模型：可读当前会话模型与 openclaw.json 里 agents.defaults.model.primary 作推荐
Workspace：与 main agent 平级，形如 {main 父目录}/workspace-{agentId}

四问全部确认后做汇总，用户同意再执行脚本：跑 openclaw agents add、用 agents list 校验、补全缺失的 .md，并在 history/history.md 记一笔。随后对 IDENTITY.md（字段替换）、SOUL.md（在既有章节下追加定位，不删通用块）、USER.md（用户名字段）做区块级编辑，避免整文件覆盖。

适用边界与注意

Agent ID 仅小写字母、数字、连字符；显示名可中文
Workspace 必须是空目录或尚不存在的路径
问题 4（路径）确认后须单独进入汇总，不要和最后一问合并
新建 agent 生效通常需要 openclaw gateway restart（技能会在完成提示里询问是否重启）

截图预览

使用场景

已在同一台机器跑 OpenClaw main，想再挂一个专门做 PR review 的 agent，且 workspace 与 main 平级、不手算路径
需要给「数据分析」角色单独注册 agent，并在 SOUL.md 里写清报表与可视化风格，同时保留模板里的通用行为约束
群里要用不同 @ 名召唤多个 agent，希望通过一问一答把显示名、emoji 和模型一次登记进 openclaw
main workspace 的 IDENTITY/SOUL 模板齐全，新建 agent 后希望脚本校验 agents list 并补全缺失的 .md 再按角色改字段