Clawflows

# ClawFlows

Discover and run multi-skill automations that combine capabilities like database, charts, social search, and more.

## 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

| Capability | What It Does | Example Skills | |------------|--------------|----------------| | `youtube-data` | Fetch video/channel stats | youtube-api | | `database` | Store and query data | sqlite-skill | | `chart-generation` | Create chart images | chart-image | | `social-search` | Search X/Twitter | search-x | | `prediction-markets` | Query odds | polymarket | | `weather` | Get forecasts | weather | | `calendar` | Read/write events | caldav-calendar | | `email` | Send/receive email | agentmail | | `tts` | Text to speech | elevenlabs-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] --- ```

## Links

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