soulflow

# SoulFlow — Workflow Framework for OpenClaw

**A framework for building custom AI workflows.** Each workflow is a series of steps that execute in isolated agent sessions with full tool access. Define your workflow in JSON, invoke it naturally, and let the agents handle the execution.

**What you can build:**
- Development pipelines (security audits, bug fixes, feature development)
- Content workflows (research → draft → edit → publish)
- Operations automation (deploy → verify → rollback-on-fail)
- Research pipelines (gather → analyze → synthesize → report)
- Any multi-step task that benefits from isolated, focused agent sessions

**Ships with 3 example dev workflows** to show you how it works. Build your own for anything.

## Quick Start

**Natural language (easiest):**
Just tell your agent what you need:
- "Run a security audit on my project at ~/myapp"
- "Fix this bug: users can't login with Google OAuth in ~/webapp"
- "Build a referral system for ~/webapp"

Your agent reads this SKILL.md and invokes SoulFlow automatically.

**Command line:**
```bash
cd ~/.openclaw/workspace/soulflow

# Run a security audit
node soulflow.js run security-audit "Audit the codebase at ~/project for vulnerabilities"

# Fix a bug
node soulflow.js run bug-fix "Login returns 500 when email has uppercase letters in ~/myapp"

# Build a feature
node soulflow.js run feature-dev "Add dark mode toggle to the settings page in ~/myapp"
```

## How It Works

SoulFlow connects to your local OpenClaw gateway via WebSocket and runs each workflow step as an isolated agent session. A dedicated `soulflow-worker` agent is auto-created with minimal context — no memory bleed from your main agent.

Each step:
1. Gets a fresh session (no context bloat)
2. Receives the task + output from previous steps
3. Has full tool access (read, write, edit, exec, browser)
4. Must complete its work and report results

**Auto-notifications (v1.1.0+):** When workflows complete, SoulFlow automatically notifies the main age...

# SoulFlow — Workflow Framework for OpenClaw

**Build custom AI workflows for any task.** Each workflow is a series of steps that execute in isolated agent sessions with full tool access. Define your workflow in JSON, invoke it naturally, and let the agents handle the execution.

## What You Can Build

- **Development pipelines** (security audits, bug fixes, feature development)
- **Content workflows** (research → draft → edit → publish)
- **Operations automation** (deploy → verify → rollback-on-fail)
- **Research pipelines** (gather → analyze → synthesize → report)
- **Any multi-step task** that benefits from isolated, focused agent sessions

**Ships with 3 example dev workflows** to demonstrate the framework. Build your own for anything.

## Quick Start

### Natural Language (Easiest)

Just tell your agent what you need:
```
"Run a security audit on my project at ~/myapp"
"Fix this bug: users can't login with Google OAuth in ~/webapp"
"Build a referral system for ~/webapp"
```

Your agent reads `SKILL.md` and invokes SoulFlow automatically.

### Command Line

```bash
cd ~/.openclaw/workspace/soulflow

# Run a security audit
node soulflow.js run security-audit "Audit the codebase at ~/project for vulnerabilities"

# Fix a bug
node soulflow.js run bug-fix "Login returns 500 when email has uppercase letters in ~/myapp"

# Build a feature
node soulflow.js run feature-dev "Add dark mode toggle to the settings page in ~/myapp"
```

## How It Works

SoulFlow connects to your local OpenClaw gateway via WebSocket and runs each workflow step as an isolated agent session. A dedicated `soulflow-worker` agent is auto-created with minimal context — no memory bleed from your main agent.

**Each step:**
1. Gets a fresh session (no context bloat)
2. Receives the task + output from previous steps
3. Has full tool access (`read`, `write`, `edit`, `exec`, `browser`)
4. Must complete its work and report results

**Automatic notifications:**
When a workflow completes (success or failur...