Skip to main content

Vertical agent workflow orchestration platform on top of ClawTeam and OpenClaw

Project description

⚡ ClawsomeFlow ⚡

Make your multi-agent workflow Clawsome!

English · 简体中文

Describe your goal in natural language, and turn multi-agent collaboration into a controllable, observable, convergent engineering system.

ClawsomeFlow is a vertical-domain Agent workflow orchestration platform: define tasks as a DAG Flow, and let an async scheduler actively drive multiple Agents to collaborate in parallel, with built-in engineering guardrails such as isolation / rollback / complaint-loop / entropy management.

Full compatibility with OpenClaw, Claude Code, Codex, Cursor, Hermes and other CLI Agents.

News · Core Features · Why ClawsomeFlow · Relationship with ClawTeam · Quick Start · Roadmap

Python FastAPI React Built on ClawTeam License MIT


📰 News

  • 2026-06-02: ClawsomeFlow public release 🎉

✨ Core Features

Building on top of ClawTeam's swarm-intelligence capabilities, ClawsomeFlow adds the two missing engineering layers — orchestration + product:

🌳 Deep OpenClaw Adaptation 🧠 AI + Precise Orchestration 🗣️ Get Everything Done in Natural Language 🔄 Complaint-Loop Mechanism
For OpenClaw's blurry session boundaries and workspace concurrency conflicts under multi-task parallelism, we apply dual session-and-directory isolation and fold recovery paths into a standard state machine. Take control flow back from the Prompt into code: the scheduler decides dispatch, retry, timeout and convergence — behavior is controllable, with significantly fewer wasted tokens. Flow definition, Agent creation, task orchestration, and runtime intervention can all be done in natural language via the Web UI / CLI. A Run supports the "user complaint → reflective processing → write back experience" loop, so the system keeps self-improving.
🚀 Multi-Agent Collaboration 📊 Enterprise-Grade Observability 🔐 Isolation & Governance Together 🧩 Compatible with Existing Ecosystems
Supports OpenClaw / Claude / Codex / Cursor / Hermes collaborating in the same graph. Every dispatch / completion / failure is recorded as a RunEvent — auditable, replayable, billable. Three-layer isolation across team / session / worktree, avoiding cross-talk and accidental writes. We don't reinvent the protocol layer; we reuse ClawTeam CLI + MCP and its swarm collaboration and monitoring.

🦞 The Swarm-Intelligence Foundation Inherited from ClawTeam

ClawsomeFlow stands on the shoulders of ClawTeam, faithfully inheriting its swarm-collaboration core:

  • Self-organizing Agent collaboration: the Leader dispatches, Workers self-report status and results, CLI Agents are plug-and-play with no custom SDK required.
  • Git Worktree workspace isolation: each Agent has an independent branch and directory, running in parallel without interference, with checkpoint / merge / cleanup support.
  • Inter-Agent messaging: point-to-point inbox and broadcast, so team members share progress in real time.

On top of this, ClawsomeFlow layers in deep OpenClaw adaptation, DAG orchestration scheduling, failure convergence, human guardrails, Web productization and multi-user governance.


🤔 Why ClawsomeFlow?

The common pain point of multi-agent frameworks is not "insufficient model capability", but "unstable collaboration control flow": the process is written in the Prompt, the final behavior depends on the Agent's in-the-moment understanding and model quality, and the system's predictability, cost and recoverability are all too weak.

ClawsomeFlow's approach is direct: migrate coordination from natural language back into code, make concurrency isolation a default capability, and make failure handling a built-in part of the process.

🆚 Comparison with Other Agent Orchestration Platforms

Dimension Other Multi-Agent Orchestration Platforms ✅ ClawsomeFlow
Task orchestration fit Mostly framework-specific, bound to a single ecosystem Task orchestration is deeply adapted to OpenClaw Agents, while also being compatible with any CLI Agent (Claude / Codex / Cursor, etc.) collaborating in the same graph
Concurrency & isolation Easy contention in parallel, workspace conflicts, context cross-talk Solves OpenClaw collaboration instability: workspace isolation and rollback under multi-task parallelism, and thoroughly resolves session conflicts
Control approach Pure Prompt self-scheduling (black box) or pure code (heavy) AI combined with precise orchestration: get everything done in natural language while the scheduler precisely controls behavior (dispatch / retry / timeout / abort)
Engineering harness Generally missing; failures rely on Agent improvisation Harness engineering: human checkpoints, rollbackable results, complaint-loop mechanism, periodic entropy management
Failure recovery Relies on Agent self-healing, uncertain outcome Clear retry / skip / abort strategies, recovery paths folded into a standard state machine
Observability Context is mostly a black box Full-chain RunEvent — traceable, auditable, replayable

✨ The Result?

You own the goal, and ClawsomeFlow turns multi-agent collaborative execution into a stable, controllable, convergent engineering system.


🧩 Relationship with ClawTeam

ClawsomeFlow is built on top of ClawTeam.

🔍 ClawTeam vs ClawsomeFlow at a Glance

Dimension ClawTeam ClawsomeFlow
Positioning Swarm-intelligence protocol foundation (Agent self-organization) Agent workflow orchestration platform
Collaboration driver Agents self-poll and self-schedule in the Prompt Server-side scheduler actively dispatches, deterministic execution
Task model Kanban + dependency chain DAG Flow compilation, Leader summarizes and converges
OpenClaw adaptation Supported as an optional CLI Agent Deeply adapted, resolving session and workspace concurrency conflicts
Failure & guardrails Basic lifecycle protocol Human checkpoints / rollback / complaint-loop / entropy management
Usage form CLI + MCP + monitoring dashboard Web UI + CLI, full-flow governance in natural language

🚀 Quick Start

Install

curl -fsSL https://clawsomeflow.com/install.sh | bash

Common Commands

# Lifecycle
csflow start
csflow stop
csflow status
csflow doctor

# Flow / Run
csflow flows list
csflow runs list
csflow runs start <flow-id> --input k=v
csflow runs abort <run-id>

# Agent governance
csflow agents list
csflow agents create "Describe the Agent you want in natural language"
csflow agents chat <agent-id> "Keep improving this Agent's capabilities"

🗺️ Roadmap

Phase Content Status
P0 🚧 In progress
P1 📅 Planned
P2 📅 Planned
P3 💡 Exploring

📄 License

MIT

Project details


Release history Release notifications | RSS feed

This version

0.1.6

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

clawsomeflow-0.1.6.tar.gz (707.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

clawsomeflow-0.1.6-py3-none-any.whl (590.3 kB view details)

Uploaded Python 3

File details

Details for the file clawsomeflow-0.1.6.tar.gz.

File metadata

  • Download URL: clawsomeflow-0.1.6.tar.gz
  • Upload date:
  • Size: 707.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.0rc1

File hashes

Hashes for clawsomeflow-0.1.6.tar.gz
Algorithm Hash digest
SHA256 1e3023c0e9209bf071dba8cd70f37e3096105d583c6144c6f0b34c03be23e613
MD5 58e6e0504e0804045490851d1a6158dd
BLAKE2b-256 90b99fb89ba56710c6d02e05db8e3a89896d2faa166dd0943307779b90e0830b

See more details on using hashes here.

File details

Details for the file clawsomeflow-0.1.6-py3-none-any.whl.

File metadata

  • Download URL: clawsomeflow-0.1.6-py3-none-any.whl
  • Upload date:
  • Size: 590.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.0rc1

File hashes

Hashes for clawsomeflow-0.1.6-py3-none-any.whl
Algorithm Hash digest
SHA256 87189378dbfea0172e890e7d7a379be245c36b5065b47fb56236692460e23561
MD5 a54a15fc158dd50045b4c09c89042b1d
BLAKE2b-256 5358487eb3b029bb62e0a8881b19d460146ba25805654e835faf20aed87aa005

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page