OpenClaw Agent Scaffolder
When to Use
- Creating a new agent for the fleet
- Migrating an agent from one model/channel to another
- Auditing an existing agent's setup for completeness
Interview Questions
Required
- Agent name + emoji — e.g., "Hawkeye 🎯"
- Role — one sentence (e.g., "QA specialist — runs tests, security scans, bug filing")
- Model tier — Opus ($$$, deep reasoning) / Sonnet ($$, general) / Flash/Grok ($, fast) / Free (Codex/Groq)
- Primary channel — Discord channel name + ID
- Personality/tone — 1-2 adjectives (e.g., "sharp, dry, zero corporate")
Situational
- Tools needed — bash, browser, web_search, web_fetch, message, cron, nodes?
- Skills to include — from
~/.openclaw/skills/ or ~/.claude/skills/
- Heartbeat schedule — how often? what checks?
- Inter-agent relationships — who does it talk to? who delegates to it?
- Cost budget — max per session? per day?
Output Files
1. {workspace}/SOUL.md (~30 lines)
# SOUL.md — {Name} {Emoji}
You are {Name} — {role}. {1-2 personality sentences}.
## Identity
- Name/Avatar/Model/Channel/Role
## Core Expertise
- {3-5 bullet points}
## What You Do
- {numbered list of primary actions}
## Vibe
- {tone description}
## What You Are Not
- {explicit boundaries}
2. {workspace}/AGENTS.md (~80 lines)
Reference template: ~/clawd/workspaces/architecture/AGENTS.md
Must include: Channel-Aware Mode, Hard Rules, Session Start, Core Loop, Memory, Inter-Agent Announce
3. {workspace}/TOOLS.md (~30 lines)
Workspace paths, tool-specific commands, filesystem section
4. {workspace}/IDENTITY.md (~15 lines)
Name, alt, workspace, model, channel, tone, emoji, role, scope
5. {workspace}/USER.md (~15 lines)
Create a USER.md with your personal context
6. Gateway config snippet
{
"id": "{agentId}",
"name": "{Name}",
"model": "{provider/model}",
"workspace": "{workspace}",
"thinking": "{level}",
"maxTokens": {n},
"skills": [...],
"heartbeat": { "intervalMinutes": {n} }
}
Gotchas
- Always check
~/clawd/shared/TEAM-DIRECTORY.md for naming conflicts
- Check
~/clawd/shared/PORT-REGISTRY.md if the agent needs a port
- Every agent MUST have the Inter-Agent Announce block in AGENTS.md
- Every agent MUST have Micro Memory in AGENTS.md
- Gateway config changes require Kevin's explicit approval — output the snippet, don't apply it
1---2name: openclaw-agent-scaffolder3description: Scaffold a new OpenClaw agent from scratch. Interviews for requirements, then generates complete workspace files (SOUL.md, AGENTS.md, TOOLS.md, IDENTITY.md, USER.md) plus the OpenClaw gateway config JSON snippet. Ensures consistency across the 35+ agent fleet.4---56# OpenClaw Agent Scaffolder78## When to Use9- Creating a new agent for the fleet10- Migrating an agent from one model/channel to another11- Auditing an existing agent's setup for completeness1213## Interview Questions1415### Required161. **Agent name + emoji** — e.g., "Hawkeye 🎯"172. **Role** — one sentence (e.g., "QA specialist — runs tests, security scans, bug filing")183. **Model tier** — Opus ($$$, deep reasoning) / Sonnet ($$, general) / Flash/Grok ($, fast) / Free (Codex/Groq)194. **Primary channel** — Discord channel name + ID205. **Personality/tone** — 1-2 adjectives (e.g., "sharp, dry, zero corporate")2122### Situational236. **Tools needed** — bash, browser, web_search, web_fetch, message, cron, nodes?247. **Skills to include** — from `~/.openclaw/skills/` or `~/.claude/skills/`258. **Heartbeat schedule** — how often? what checks?269. **Inter-agent relationships** — who does it talk to? who delegates to it?2710. **Cost budget** — max per session? per day?2829## Output Files3031### 1. `{workspace}/SOUL.md` (~30 lines)32```markdown33# SOUL.md — {Name} {Emoji}34You are {Name} — {role}. {1-2 personality sentences}.35## Identity36- Name/Avatar/Model/Channel/Role37## Core Expertise38- {3-5 bullet points}39## What You Do40- {numbered list of primary actions}41## Vibe42- {tone description}43## What You Are Not44- {explicit boundaries}45```4647### 2. `{workspace}/AGENTS.md` (~80 lines)48Reference template: `~/clawd/workspaces/architecture/AGENTS.md`49Must include: Channel-Aware Mode, Hard Rules, Session Start, Core Loop, Memory, Inter-Agent Announce5051### 3. `{workspace}/TOOLS.md` (~30 lines)52Workspace paths, tool-specific commands, filesystem section5354### 4. `{workspace}/IDENTITY.md` (~15 lines)55Name, alt, workspace, model, channel, tone, emoji, role, scope5657### 5. `{workspace}/USER.md` (~15 lines)58Create a USER.md with your personal context5960### 6. Gateway config snippet61```json62{63 "id": "{agentId}",64 "name": "{Name}",65 "model": "{provider/model}",66 "workspace": "{workspace}",67 "thinking": "{level}",68 "maxTokens": {n},69 "skills": [...],70 "heartbeat": { "intervalMinutes": {n} }71}72```7374## Gotchas75- Always check `~/clawd/shared/TEAM-DIRECTORY.md` for naming conflicts76- Check `~/clawd/shared/PORT-REGISTRY.md` if the agent needs a port77- Every agent MUST have the Inter-Agent Announce block in AGENTS.md78- Every agent MUST have Micro Memory in AGENTS.md79- Gateway config changes require Kevin's explicit approval — output the snippet, don't apply it
KevinZai