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 |
|------------|--------------|----------------|
| `youtu...