A robust framework for executing multi-step project roadmaps and QA pipelines autonomously using a heartbeat-driven execution model.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install macro-pipeline
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 macro-pipeline 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 Macro Pipeline?
The Macro Pipeline skill introduces a sophisticated architecture for managing long-running, complex tasks through Openclaw Skills. By separating operational instructions from state management, it allows agents to execute multi-step workflows like feature rollouts or security audits autonomously. This skill utilizes a dual-file system where a PIPELINE.md file tracks progress within the project repository, while a read-only HEARTBEAT.md file guides the agent's behavior from its workspace.
This separation of concerns ensures that project history is preserved via Git-trackable progress updates, while keeping the agent's core instructions protected from accidental modification. It is an essential component for developers looking to scale their Openclaw Skills into fully autonomous project managers.
Macro Pipeline Use Cases
- Executing multi-stage QA and testing roadmaps autonomously.
- Automating complex feature rollouts across multiple services and directories.
- Managing long-running security audits and remediation tasks with automated progress tracking.
- Coordinating autonomous agents via cron-scheduled project updates to eliminate manual oversight.
How Macro Pipeline Works
- A PIPELINE.md file is created in the project repository to define individual steps, dependencies, and track state.
- A read-only HEARTBEAT.md file is placed in the agent workspace to provide the operational protocol and absolute paths.
- A cron job is added via the CLI to trigger the Openclaw Skills agent at specific regular intervals.
- During each heartbeat cycle, the agent reads the active pipeline to identify the next PENDING step that has satisfied its dependencies.
- The agent executes the task, updates the PIPELINE.md status to RUNNING, and then moves it to COMPLETED upon success.
- Completed steps are finalized with Git commits and notifications to communication channels like Discord.
Macro Pipeline Setup
To integrate this into your environment, follow these steps using the Openclaw Skills CLI:
- Create the PIPELINE.md in your project root.
- Create the HEARTBEAT.md in your agent's workspace folder.
- Secure the heartbeat file to prevent the agent from overwriting its own logic:
sudo chflags uchg ~/.openclaw/workspace-<agent-id>/HEARTBEAT.md
- Add the execution schedule:
openclaw cron add --name "Project Pipeline" --agent <agent-id> --every 30m --message "Heartbeat: lee HEARTBEAT.md y ejecuta siguiente step"
Macro Pipeline Data Schema & Taxonomy
The skill organizes data using a specific dual-file taxonomy to ensure reliability within Openclaw Skills:
| File | Location | Content / Role |
|---|---|---|
| PIPELINE.md | Project Repository | Progress tracking, step definitions, [PENDING/RUNNING/COMPLETED] states, and artifact metadata. |
| HEARTBEAT.md | Agent Workspace | Read-only execution protocol, absolute paths to active pipelines, and zombie detection logic. |
Status Identifiers:
- [PENDING]: Ready for execution.
- [RUNNING timestamp]: Currently being processed by an agent.
- [COMPLETED]: Successfully finished with artifacts recorded.
- [FAILED]: Terminated with error logs included in the pipeline file.
Macro Pipeline Advanced Features
- Zombie Detection: Automatically identifies and resets steps that have been in a RUNNING state for over 2 hours.
- Parallel Execution: Supports simultaneous task processing for steps marked with the parallel field when no cross-dependencies exist.
- Git-Integrated Traceability: Automatically generates tagged commits (e.g., pipeline/project/step-N) for every completed task.
- Multi-Pipeline Fallbacks: Allows agents to manage multiple active projects by specifying priority orders within the heartbeat configuration.
- Verification Enforcement: Every step requires a mandatory shell command to validate completion before moving to the next stage.
SKILL.md
Loading
Related Openclaw Skills
Tweet Writer
An AI-powered writing assistant that researches and generates viral X content using proven copywriting frameworks and algorithm-first strategies.
Keywords Everywhere SEO Research
A CLI-powered SEO toolset for keyword research, competitor analysis, and backlink tracking using the Keywords Everywhere API.
Server Health Agent
A production-ready monitoring skill for tracking real-time server metrics and Docker container status.
Aegis Audit
A comprehensive behavioral security scanner and auditor designed for AI agent skills and MCP tools.
Santi's Custom Welcome Assistant
A personalized entry-point skill designed for system verification and customized greeting workflows on dedicated server environments.
Scryfall MTG Search
A comprehensive search and retrieval skill for Magic: The Gathering card data using the professional Scryfall API.
Featured*
