openclaw-workspace-wizard

OpenClaw Workspace Wizard

The full guided journey for creating a production-ready OpenClaw agent workspace. Chains six phases with user checkpoints between each, so you can pause, adjust, and resume at any point.

Overview

This wizard orchestrates the complete lifecycle:

Phase 1: Discovery     → What agent do you need?
Phase 2: Memory Design → How should it remember?
Phase 3: Soul Design   → Who is this agent?
Phase 4: Workspace     → What files and structure?
Phase 5: Scaffolding   → Generate everything
Phase 6: Quality Audit → Score and improve

Each phase produces artifacts that feed the next. You can skip phases if you already have the artifacts (e.g., skip Discovery if you already know exactly what you want).

Phase 0: Welcome and Setup

Configuration

Determine workspace settings:

1. Workspace name: What should this agent be called? (working title — can change later)
2. Workspace mode: Single agent or multi-agent team?
3. Workspace location: Where to create the workspace?
   • Default: ~/.openclaw/workspace/ (single-agent)
   • Multi-agent: ~/.openclaw/agents-workspaces/<agent-id>/
   • Custom path if user prefers

Resume Detection

Check the workspace location for existing artifacts:

• Discovery reports, memory architecture docs, SOUL.md drafts
• If found, present them and offer: [R] Resume from last checkpoint, [S] Start fresh, [P] Pick a specific phase

Welcome Message

"Welcome! Let's build your OpenClaw agent workspace step by step.

Your settings:

• Agent name: {name}
• Mode: {single/multi-agent}
• Output: {workspace path}

This journey has 6 phases. I'll check in with you between each one so you can adjust course. Ready?"

Wait for user confirmation.

---

Phase 1: Discovery — What Agent Do You Need?

Goal: Understand what the agent does, who it serves, and what it needs.

1.1 Reference Templates

"Before we dive in — would you like to browse reference templates for common agent archetypes? I have templates for Software Architect, Code Reviewer, Security Engineer, Technical Writer, DevOps Automator, Sprint Prioritizer, UX Researcher, and Feedback Synthesizer.