Boris Workflow for OpenClaw

Boris Workflow for OpenClaw

> Parallel agent task runner implementing the Boris Cherny multi-agent pattern

 

Overview

Boris Workflow is a powerful parallel execution engine for OpenClaw that enables you to run multiple independent tasks across multiple AI agents simultaneously. Inspired by Boris Cherny's approach to multi-agent orchestration, it provides automatic progress tracking, configurable error retry, and organized artifact management.

What It Does

The Boris Workflow implements a 3-phase parallel execution pattern:

1. Phase 1: Distribution — Tasks are queued and distributed to available agents 2. Phase 2: Execution — Agents pull work from the queue (work-stealing pattern) 3. Phase 3: Verification — Optional verification agent reviews all results

┌─────────────────────────────────────────────────────────────┐
│                      ORCHESTRATOR                           │
│                    (boris-run CLI)                          │
└─────────────────────────────────────────────────────────────┘
                            │
        ┌───────────────────┼───────────────────┐
        ▼                   ▼                   ▼
┌──────────────┐    ┌──────────────┐    ┌──────────────┐
│  AGENT 1     │    │  AGENT 2     │    │  AGENT N     │
│ (Task A)     │    │ (Task B)     │    │ (Task C)     │
└──────┬───────┘    └──────┬───────┘    └──────┬───────┘
       │                   │                   │
       └───────────────────┼───────────────────┘
                           ▼
              ┌────────────────────┐
              │  RESULT COLLECTOR  │
              └────────────────────┘

Key Features

🚀 Parallel Execution

🔄 Intelligent Retry

📊 Progress Tracking

✅ Verification Layer

🎨 Web UI (Optional)

📁 Organized Artifacts

Quick Start

# Install dependencies
cd ~/.openclaw/workspace/skills/boris-workflow
pip install -r requirements.txt
Run 3 tasks with 3 agents
./bin/boris-run --tasks "research|analyze|write"
Run 10 tasks with 5 agents
./bin/boris-run --tasks "t1|t2|t3|t4|t5|t6|t7|t8|t9|t10" --agents 5
With verification step
./bin/boris-run --tasks "code|test|review" --verify
Dry run to preview
./bin/boris-run --tasks "build|deploy" --dry-run

Web Interface

Boris Workflow includes a modern web UI for visual workflow management:

# Start the Web UI
cd ~/.openclaw/workspace/skills/boris-workflow/webui
./start.sh

Open http://localhost:8080 in your browser.

Web UI Features

Web UI Screenshots

┌─────────────────────────────────────────────────────────────┐
│  🚀 Boris Workflow                              [Settings]  │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  Workflow Name: batch-analysis                              │
│                                                             │
│  ┌─────────────────────────────────────────────────────┐   │
│  │ Tasks                    │  Agents: [ 3 ▼]          │   │
│  │ ──────────────────────── │  Model: [kimi-coding ▼]  │   │
│  │ □ Research market trends │  Timeout: [300s ▼]       │   │
│  │ □ Analyze competitors    │  Retries: [2 ▼]          │   │
│  │ □ Write summary report   │                          │   │
│  │ □ + Add Task             │  [✓] Enable Verification │   │
│  └─────────────────────────────────────────────────────┘   │
│                                                             │
│  [Start Workflow]          [Dry Run]          [Export YAML] │
│                                                             │
│  ┌─────────────────────────────────────────────────────┐   │
│  │ Progress                                            │   │
│  │ ████████░░░░░░░░░░ 8/10 tasks complete (80%)       │   │
│  │                                                     │   │
│  │ task_0_research     ✅ Complete    2m 14s          │   │
│  │ task_1_analyze      ✅ Complete    1m 52s          │   │
│  │ task_2_write        🔄 Running     0m 45s          │   │
│  │ task_3_verify       ⏳ Pending     --              │   │
│  └─────────────────────────────────────────────────────┘   │
│                                                             │
└─────────────────────────────────────────────────────────────┘

Requirements

System Requirements

Python Dependencies

pyyaml>=6.0
requests>=2.28.0

Optional Dependencies (for Web UI)

fastapi>=0.100.0
uvicorn[standard]>=0.23.0
pydantic>=2.0.0
python-multipart>=0.0.6

Configuration

Configuration Hierarchy

Config values are resolved in priority order (highest to lowest): 1. CLI arguments 2. Environment variables (BORIS_*) 3. Project config (./.boris/config.yaml) 4. User config (~/.boris/config.yaml) 5. System defaults

Example Config File

# ~/.boris/config.yaml
Agent defaults
agents:
  default_count: 3
  max_count: 20
  timeout_seconds: 300
  model: "kimi-coding/k2p5"
Retry configuration
retry:
  max_attempts: 2
  backoff_strategy: "exponential"
  initial_delay_ms: 1000
  max_delay_ms: 30000
Output and artifacts
output:
  base_dir: "~/.boris/artifacts"
  naming_pattern: "{workflow_name}_{timestamp}_{task_id}"
  cleanup_policy: "keep_last_10"
Verification settings
verification:
  enabled: false
  verifier_model: "kimi-coding/k2p5"
  auto_retry_failed: true
Logging
logging:
  level: "info"
  format: "text"

CLI Reference

Usage: boris-run [OPTIONS]
Required:
  -t, --tasks TEXT          Tasks to run, pipe-separated
  
Optional:
  -a, --agents INTEGER      Number of agents (default: 3, max: 20)
  -n, --name TEXT          Workflow name
  -c, --config PATH        Config file path
  -o, --output PATH        Artifacts directory
  -r, --retries INTEGER    Max retries per task
  -T, --timeout INTEGER    Timeout per agent (seconds)
  --verify                 Enable verification step
  --dry-run                Preview without execution
  --mock                   Use mock bridge for testing
  -v, --verbose            Verbose logging
  -q, --quiet              Suppress progress output
  --version                Show version
  -h, --help               Show help

Use Cases

License

MIT License - OpenClaw Community

Author

Created by Goli / mukston for the OpenClaw ecosystem.

# Install dependencies
cd ~/.openclaw/workspace/skills/boris-workflow
pip install -r requirements.txt
Run 3 tasks with 3 agents
./bin/boris-run --tasks "research|analyze|write"
Run 10 tasks with 5 agents
./bin/boris-run --tasks "t1|t2|t3|t4|t5|t6|t7|t8|t9|t10" --agents 5
With verification step
./bin/boris-run --tasks "code|test|review" --verify
Dry run to preview
./bin/boris-run --tasks "build|deploy" --dry-run

Configuration Hierarchy

Config values are resolved in priority order (highest to lowest): 1. CLI arguments 2. Environment variables (BORIS_*) 3. Project config (./.boris/config.yaml) 4. User config (~/.boris/config.yaml) 5. System defaults

Example Config File

# ~/.boris/config.yaml
Agent defaults
agents:
  default_count: 3
  max_count: 20
  timeout_seconds: 300
  model: "kimi-coding/k2p5"
Retry configuration
retry:
  max_attempts: 2
  backoff_strategy: "exponential"
  initial_delay_ms: 1000
  max_delay_ms: 30000
Output and artifacts
output:
  base_dir: "~/.boris/artifacts"
  naming_pattern: "{workflow_name}_{timestamp}_{task_id}"
  cleanup_policy: "keep_last_10"
Verification settings
verification:
  enabled: false
  verifier_model: "kimi-coding/k2p5"
  auto_retry_failed: true
Logging
logging:
  level: "info"
  format: "text"