🦞👔 DressClaw

Dress your OpenClaw. Swap personality, cron jobs, workflows, and skills like changing clothes.

DressClaw is a composable outfit system for OpenClaw. Each outfit is a complete agent configuration — personality (SOUL.md), scheduled jobs (cron), automated workflows (Lobster), skills, model selection, and channel bindings — packaged as a single unit you can wear, strip, mix, and swap in seconds.

Why

OpenClaw is powerful but configuring it means editing SOUL.md, registering cron jobs one by one, deploying Lobster flows, managing skill allowlists. DressClaw turns all of that into one command:

dressclaw wear trader    # done. your OpenClaw is now a crypto intel agent.
dressclaw wear athlete   # now it's a fitness coach. crons swapped, soul changed.
dressclaw wear developer  # dev workflow monitor. 10 seconds.

Like humans change clothes, your OpenClaw changes behavior.

Before DressClaw

# Edit SOUL.md by hand...
vim ~/.openclaw/workspace/SOUL.md
# Register cron jobs one by one...
openclaw cron add --name morning-briefing --cron "0 7 * * *" --message "..." --session isolated --announce --channel telegram --to -100123
openclaw cron add --name midday-scan --cron "0 13 * * *" --message "..." --session isolated --announce --channel telegram --to -100123
openclaw cron add --name evening-portfolio --cron "0 19 * * *" --message "..." ...
# Deploy Lobster flows manually...
cp flows/*.lobster ~/.openclaw/workspace/flows/
# Configure skills...
openclaw config set tools.alsoAllow '["lobster"]'
# Restart gateway...
openclaw gateway restart

After DressClaw

dressclaw wear trader

Quick Start

# Prerequisites: OpenClaw installed and gateway running
npm install -g dressclaw

# Initialize (creates ~/.dressclaw/ and copies built-in outfits)
dressclaw init

# See what's available
dressclaw wardrobe

# Wear an outfit
dressclaw wear trader --env TELEGRAM_CHAT_ID=-100123456789

# Check status
dressclaw status

# Change outfit (auto-strips previous)
dressclaw wear athlete --env TELEGRAM_CHAT_ID=-100123456789 BODYWEIGHT_KG=82

# Go back to bare OpenClaw
dressclaw strip

Built-in Outfits

| Outfit | Icon | What it does | |--------|------|-------------| | trader | 📊 | Crypto intel: 4x daily briefings, NOVA scoring, whale alerts, portfolio tracking | | athlete | 💪 | Workout reminders, macro tracking, weekly body recomp review | | developer | 🧑‍💻 | GitHub monitoring, CI/CD alerts, PR auto-review, weekly tech radar | | nomad | ✈️ | Flight price watch, visa tracking, coworking logistics, timezone management | | founder | 🎯 | KPI dashboard, runway monitoring, investor radar, EU funding alerts |

Mixing Outfits

Don't pick one — compose:

# Take the soul of athlete, crons of trader, flows of trader
dressclaw mix --name buff-trader --soul athlete --crons trader --flows trader

# Wear your custom mix
dressclaw wear buff-trader

Mixes are saved in ~/.dressclaw/custom/ and behave like any other outfit.

How It Works

Each outfit is a folder:

wardrobe/trader/
├── outfit.yaml       # Manifest: crons, flows, skills, model, env
├── SOUL.md           # Agent personality
└── flows/
    ├── nova-score.lobster
    └── whale-alert.lobster

When you dressclaw wear trader, DressClaw:

1. Snapshots current SOUL.md (for restore on strip)
2. Writes the outfit's SOUL.md to OpenClaw's workspace
3. Registers all cron jobs via openclaw cron add
4. Deploys Lobster workflow files to the workspace
5. Configures skill allowlists and model defaults
6. Tracks all job IDs in ~/.dressclaw/active/current.yaml

When you dressclaw strip or wear a different outfit, it cleanly removes all cron jobs and restores the previous state. Non-destructive. Memory persists.

Creating Custom Outfits

# Scaffold from the minimal template
dressclaw new my-outfit

# Or start from a more complex example
dressclaw new my-outfit --from 02-with-crons
dressclaw new my-outfit --from 04-with-onboarding

# Or clone an official outfit and customize it
dressclaw eject trader

This creates ~/.dressclaw/custom/my-outfit/ with a ready-to-edit scaffold. Then:

1. Edit SOUL.md — define your agent's personality and memory boundaries
2. Edit outfit.yaml — add crons, env vars, flows, skills
3. dressclaw lint my-outfit — validate before wearing
4. dressclaw wear my-outfit — try it out

The project includes 5 progressive examples (examples/01-minimal through 05-with-flows) that teach each feature incrementally. Use --from to start from any of them.

Memory Boundaries

Every outfit should namespace its workspace data under <outfit-name>/. Your SOUL.md should include a Memory Boundaries section instructing the agent to write outfit-specific data exclusively to <outfit-name>/ — never to workspace-level files like USER.md or memory/. This keeps outfits cleanly isolated when switching.

Sharing Outfits

To share an outfit, copy it to ~/.dressclaw/community/<your-name>/<outfit-name>/. Community outfits are discovered automatically by dressclaw wardrobe.

Before sharing, validate with:

dressclaw lint path/to/my-outfit   # schema, files, secrets, flow structure

Architecture

┌─────────────────────────────────┐
│      DressClaw CLI              │
│  wear │ strip │ mix │ wardrobe  │
├─────────────────────────────────┤
│  Engine (snapshot, resolve, apply) │
├─────────────────────────────────┤
│  OpenClaw Bridge                │
│  (openclaw cron/config/skills)  │
├─────────────────────────────────┤
│  OpenClaw Gateway :18789        │
│  SOUL.md │ Cron │ Lobster │ Skills │
├─────────────────────────────────┤
│  Telegram │ WhatsApp │ Slack │ … │
└─────────────────────────────────┘

DressClaw never forks or patches OpenClaw. It's a pure complementary layer that uses OpenClaw's existing CLI and file conventions.

Preview (Dry Run)

dressclaw preview trader
# Shows exactly what would change without touching anything

Additional Commands

dressclaw doctor          # diagnose environment + detect cron state drift
dressclaw diff <outfit>   # compare current state vs another outfit
dressclaw lint [path]     # validate outfit schema, files, secrets, flows
dressclaw new <name>      # scaffold a new outfit from template
dressclaw eject <name>    # copy an official outfit to custom/ for editing

Requirements

• Node.js >= 22.0
• OpenClaw installed and gateway running (openclaw gateway status)
• Lobster CLI on PATH (for workflow outfits)

Roadmap

• [ ] dressclaw export/import — share outfits as .claw.tar.gz archives
• [ ] dressclaw publish — push outfits to ClawHub marketplace
• [ ] Multi-agent outfits (dress different agents differently)
• [ ] Outfit versioning and auto-update from registry
• [ ] ClawWardrobe Web UI

License

MIT — Conradlog and DressClaw contributors