Capabilities
Compatibility
Verification
Tags
ClawRecipes
<p align="center"> <img src="https://github.com/JIGGAI/ClawRecipes/blob/main/clawcipes_cook.jpg" alt="ClawRecipes logo" width="240" /> </p> <p align="center"> <img src="https://img.shields.io/github/v/release/JIGGAI/ClawRecipes?color=green&label=Latest%20Release" alt="Latest Release"> <img src="https://img.shields.io/github/license/JIGGAI/ClawRecipes?color=orange" alt="License Apache 2.0"> <img src="https://img.shields.io/github/actions/workflow/status/JIGGAI/ClawRecipes/release.yml?label=Build" alt="Build Status"> <img src="https://img.shields.io/badge/TypeScript-007ACC?logo=typescript&logoColor=white" alt="TypeScript"> <img src="https://img.shields.io/badge/Node.js-18+-339933?logo=node.js&logoColor=white" alt="Node.js 18+"> <br> <img src="https://img.shields.io/badge/OpenClaw-Plugin-6366f1" alt="OpenClaw Plugin"> <img src="https://img.shields.io/badge/CLI-Tool-blue" alt="CLI Tool"> <img src="https://img.shields.io/badge/Team-Automation-8b5cf6" alt="Team Automation"> <img src="https://img.shields.io/badge/Workflow-Engine-0891b2" alt="Workflow Engine"> </p>ClawRecipes is an OpenClaw plugin for scaffolding agents, teams, and file-first workflows from Markdown recipes.
If you want the short version:
- install the plugin
- scaffold a team or agent
- dispatch work into tickets
- run the file-first workflow
- optionally use ClawKitchen for a UI on top
ClawRecipes is CLI-first. It works without a UI.
What ClawRecipes does
ClawRecipes gives you:
- recipes written in Markdown
- agent scaffolding (
openclaw recipes scaffold) - team scaffolding (
openclaw recipes scaffold-team) - file-first ticket workflow (
dispatch → backlog → in-progress → testing → done) - workflow runner utilities for scheduled / approval-gated workflows
- workspace recipe installs from the marketplace
- ClawHub skill installs for agents or teams
It is built for people who want durable artifacts on disk, not hidden app state.
Quickstart
1) Install the plugin
OpenClaw plugin install (recommended)
openclaw plugins install @jiggai/recipes
openclaw gateway restart
openclaw plugins list
Note: The OpenClaw plugin installer enforces
pluginApiversion checks. If you see a version mismatch error, use the npm install method below instead.
npm install
npm install @jiggai/recipes --prefix ~/.openclaw/plugins
openclaw gateway restart
openclaw plugins list
From a local checkout (development)
git clone https://github.com/JIGGAI/ClawRecipes.git ~/ClawRecipes
openclaw plugins install --link ~/ClawRecipes
openclaw gateway restart
openclaw plugins list
Then verify the commands exist:
openclaw recipes list
More install details: docs/INSTALLATION.md
2) See what recipes you have
openclaw recipes list
openclaw recipes show development-team
openclaw recipes status development-team
3) Scaffold a team
openclaw recipes scaffold-team development-team \
--team-id development-team \
--apply-config \
--overwrite
This creates:
~/.openclaw/workspace-development-team/- team roles under
roles/ - ticket lanes under
work/ - optional OpenClaw agent config entries (when
--apply-configis used)
4) Put work into the system
openclaw recipes dispatch \
--team-id development-team \
--owner lead \
--request "Add a new clinic-team recipe"
Then work the ticket flow:
openclaw recipes tickets --team-id development-team
openclaw recipes take --team-id development-team --ticket 0001 --owner dev
openclaw recipes handoff --team-id development-team --ticket 0001
openclaw recipes complete --team-id development-team --ticket 0001
Workflow support
ClawRecipes supports file-first workflows with:
- workflow JSON files under
shared-context/workflows/ - workflow runs under
shared-context/workflow-runs/ - runner / worker execution model
- approval-gated steps
- tool nodes
- LLM nodes
Basic workflow commands
# Run one workflow manually
openclaw recipes workflows run \
--team-id development-team \
--workflow-file marketing.workflow.json
# Scheduler / runner
openclaw recipes workflows runner-once --team-id development-team
openclaw recipes workflows runner-tick --team-id development-team --concurrency 2
# Worker / executor
openclaw recipes workflows worker-tick \
--team-id development-team \
--agent-id development-team-lead
Approval flow commands
# approve
openclaw recipes workflows approve \
--team-id development-team \
--run-id <runId> \
--approved true
# reject with note
openclaw recipes workflows approve \
--team-id development-team \
--run-id <runId> \
--approved false \
--note "Tighten the X post hook"
# resume an awaiting run
openclaw recipes workflows resume \
--team-id development-team \
--run-id <runId>
See also:
Important workflow posting note
This is the part most people trip over.
What ships by default
Published ClawRecipes builds are intentionally conservative:
- workflow posting side effects are not automatically turned on for every install
- the old local
marketing.post_allposting path is not something users should assume is active after install
What you should do after installing
If you want workflows that actually publish content:
Recommended path
- use
outbound.post - configure an outbound posting service
- keep approval gates in the workflow
Local-controller / patched path
- if you are using a local controller-specific patch for workflow posting, you must apply that patch after install/update
- and you may need to explicitly tell your assistant to turn workflow posting back on for your local environment
In plain English:
- installing ClawRecipes does not mean "workflow posting is live"
- you must either:
- configure the supported outbound posting path, or
- reapply your local posting patch after install/update
If you are using RJ's local controller flow, document and keep your patch handy.
Common commands
Recipes
openclaw recipes list
openclaw recipes show development-team
openclaw recipes install clinic-team
Agents and teams
# single agent
openclaw recipes scaffold project-manager --agent-id pm --apply-config
# team
openclaw recipes scaffold-team development-team --team-id development-team --apply-config
# add a role into an existing team
openclaw recipes add-role \
--team-id development-team \
--role workflow-runner \
--recipe workflow-runner-addon \
--apply-config
Ticket workflow
openclaw recipes tickets --team-id development-team
openclaw recipes move-ticket --team-id development-team --ticket 0007 --to in-progress
openclaw recipes assign --team-id development-team --ticket 0007 --owner dev
openclaw recipes take --team-id development-team --ticket 0007 --owner dev
openclaw recipes handoff --team-id development-team --ticket 0007 --tester test
openclaw recipes complete --team-id development-team --ticket 0007
openclaw recipes cleanup-closed-assignments --team-id development-team
Bindings
openclaw recipes bindings
openclaw recipes bind --agent-id dev --channel telegram --peer-kind dm --peer-id 6477250615
openclaw recipes unbind --agent-id dev --channel telegram --peer-kind dm --peer-id 6477250615
Cleanup / removal
openclaw recipes cleanup-workspaces
openclaw recipes cleanup-workspaces --prefix smoke- --yes
openclaw recipes remove-team --team-id development-team --plan --json
openclaw recipes remove-team --team-id development-team --yes
Full reference: docs/COMMANDS.md
Recommended docs order for humans
If you are new, read these in order:
- Installation
- Commands
- Team workflow
- Workflow runs
- Workflow examples
- Outbound posting
- Memory system
- Swarm Orchestrator
If you are building recipes:
If you are contributing to the codebase:
ClawKitchen
If you want a UI for teams, workflows, goals, approvals, and management, use:
- ClawKitchen: https://github.com/JIGGAI/ClawKitchen
ClawKitchen is optional. ClawRecipes works without it.
More: docs/CLAWCIPES_KITCHEN.md
Development
npm test
npm run test:coverage
npm run smell-check
License
ClawRecipes is licensed under Apache-2.0.
