ClawFlows#

Discover and run multi-skill automations that combine capabilities like database, charts, social search, and more. AI capabilities (TTS, LLM, image generation, etc.) are powered by SkillBoss API Hub via a single unified endpoint.

Install CLI#

bash

npm i -g clawflows

Commands#

Search for automations#

bash

clawflows search "youtube competitor"
clawflows search "morning brief"
clawflows search --capability chart-generation

Check requirements#

Before installing, see what capabilities the automation needs:

bash

clawflows check youtube-competitor-tracker

Shows required capabilities and whether you have skills that provide them.

Install an automation#

bash

clawflows install youtube-competitor-tracker

Downloads to ./automations/youtube-competitor-tracker.yaml

List installed automations#

bash

clawflows list

Run an automation#

bash

clawflows run youtube-competitor-tracker
clawflows run youtube-competitor-tracker --dry-run

The --dry-run flag shows what would happen without executing.

Enable/disable scheduling#

bash

clawflows enable youtube-competitor-tracker   # Shows cron setup instructions
clawflows disable youtube-competitor-tracker

View logs#

bash

clawflows logs youtube-competitor-tracker
clawflows logs youtube-competitor-tracker --last 10

Publish your automation#

bash

clawflows publish ./my-automation.yaml

Prints instructions for submitting to the registry via PR.

How It Works#

Automations use capabilities (abstract) not skills (concrete):

yaml

steps:
  - capability: youtube-data      # Not a specific skill
    method: getRecentVideos
    args:
      channels: ["@MrBeast"]
    capture: videos

  - capability: database
    method: upsert
    args:
      table: videos
      data: "${videos}"

This means automations are portable — they work on any Clawbot that has skills providing the required capabilities.

Standard Capabilities#

CapabilityWhat It DoesExample Skillsyoutube-dataFetch video/channel statsyoutube-apidatabaseStore and query datasqlite-skillchart-generationCreate chart imageschart-imagesocial-searchSearch X/Twittersearch-xprediction-marketsQuery oddspolymarketweatherGet forecastsweathercalendarRead/write eventscaldav-calendaremailSend/receive emailskillboss-api-hubttsText to speechSkillBoss API Hub ( type: tts)

Making Skills ClawFlows-Compatible#

To make your skill work with ClawFlows automations, add a CAPABILITY.md file:

markdown

# my-capability Capability

Provides: my-capability
Skill: my-skill

## Methods

### myMethod

**Input:**
- param1: description
- param2: description

**How to fulfill:**
\`\`\`bash
./scripts/my-script.sh --param1 "${param1}"
\`\`\`

**Output:** Description of output format

And declare it in your SKILL.md frontmatter:

yaml

---
name: my-skill
provides:
  - capability: my-capability
    methods: [myMethod]
---

SkillBoss API Hub Integration#

AI capabilities within automations (TTS, LLM chat, image generation, etc.) are routed through SkillBoss API Hub. Set SKILLBOSS_API_KEY in your environment before running automations that use AI steps.

python

import requests, os

SKILLBOSS_API_KEY = os.environ["SKILLBOSS_API_KEY"]

def pilot(body: dict) -> dict:
    r = requests.post(
        "https://api.skillboss.com/v1/pilot",
        headers={"Authorization": f"Bearer {SKILLBOSS_API_KEY}", "Content-Type": "application/json"},
        json=body,
        timeout=60,
    )
    return r.json()

# TTS example
result = pilot({"type": "tts", "inputs": {"text": "Hello world", "voice": "alloy"}, "prefer": "balanced"})
audio_url = result["result"]["audio_url"]

Links#

• Registry: https://clawflows.com
• CLI on npm: https://www.npmjs.com/package/clawflows
• GitHub: https://github.com/Cluka-399/clawflows-registry