A state machine engine that enables AI agents to execute structured, multi-step workflows defined in YAML files without skipping critical steps.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install kagura-flowforge
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install kagura-flowforge using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is FlowForge Workflow Runner?
FlowForge is a high-reliability state machine engine designed to bring structure and order to AI agent operations within Openclaw Skills. It solves the common problem of AI agents skipping steps or losing context during complex tasks by enforcing a strict node-based execution path defined in YAML configurations.
By using FlowForge, developers can define clear linear or branching logic for their agents, ensuring that prerequisites like testing or documentation are met before moving to the next stage. It is an essential skill for managing long-running processes that require state persistence, allowing workflows to be paused and resumed across different sessions without losing the current progress of the task.
FlowForge Workflow Runner Use Cases
- Enforcing sequential development processes, such as mandatory testing before code submission.
- Managing complex multi-day research tasks that require session persistence.
- Guiding AI agents through structured learning paths or onboarding documentation.
- Automating branching workflows where the next step depends on the success or failure of the previous task.
How FlowForge Workflow Runner Works
- Discovery: The AI agent checks local mappings or uses flowforge list to find a workflow that matches the user's intent.
- Initialization: The agent checks for active instances with flowforge active and either resumes an existing task or starts a new one using flowforge start.
- Task Identification: Using flowforge status, the agent retrieves the natural language instructions defined for the current node.
- Execution: The agent performs the specified task using its available tools or sub-agents.
- State Transition: Once the task is finished, the agent moves to the next node using flowforge next, optionally specifying a branch if multiple paths exist.
- Completion: The process repeats until a node marked as terminal is reached, at which point the final results are recorded.
FlowForge Workflow Runner Setup
To use FlowForge within Openclaw Skills, ensure the CLI is installed and your environment is configured.
# Verify installation
flowforge --version
# Create a directory for your workflow definitions
mkdir -p ./workflows
# Register a new workflow definition
flowforge define ./workflows/my-workflow.yaml
FlowForge Workflow Runner Data Schema & Taxonomy
FlowForge organizes data using YAML-based workflow definitions and internal state tracking.
| Component | Description |
|---|---|
| name | The unique identifier for the workflow |
| nodes | A map of individual states within the workflow |
| task | The natural language instruction provided to the agent for that node |
| branches | Conditional paths (if/then) based on the outcome of a node |
| terminal | A boolean flag indicating the end of a workflow |
FlowForge Workflow Runner Advanced Features
- State Persistence: Workflows survive session restarts, allowing for long-running asynchronous tasks.
- Automatic Discovery: Drop YAML files into ~/.flowforge/workflows/ for instant availability without manual definition.
- Dynamic Branching: Supports complex decision trees where the agent chooses the next path based on real-time task results.
- Intent Mapping: Self-updating frontmatter rules allow the agent to learn which user phrases should trigger specific Openclaw Skills workflows.
SKILL.md
Loading
Related Openclaw Skills
browser-recover
An automated utility for detecting and fixing Chromium/Chrome environment failures to ensure reliable browser-based agent workflows.
OpenClaw Docs Search
Provides AI agents with real-time, Markdown-formatted access to official OpenClaw documentation for accurate technical guidance.
Core Brainstorming
A collaborative AI skill that converts creative concepts into structured technical designs through iterative dialogue and validation.
Jike SEO Keyword Researcher
A professional keyword research assistant that extracts search volume, competition, and GEO insights across major social media platforms.
Email Sequences
An AI-powered skill for generating highly segmented, lifecycle-aware ecommerce email sequences with professional suppression and escalation logic.
Rebuy Booster
Design high-conversion post-purchase sequences, loyalty programs, and automated re-order triggers to maximize customer lifetime value.
Featured*
