169 lines
3.5 KiB
Markdown
169 lines
3.5 KiB
Markdown
---
|
|
name: clawflows
|
|
version: 1.0.0
|
|
description: Search, install, and run multi-skill automations from clawflows.com. Combine multiple skills into powerful workflows with logic, conditions, and data flow between steps.
|
|
metadata:
|
|
clawdbot:
|
|
requires:
|
|
bins: ["clawflows"]
|
|
install:
|
|
- id: node
|
|
kind: node
|
|
package: clawflows
|
|
bins: ["clawflows"]
|
|
label: "Install ClawFlows CLI (npm)"
|
|
---
|
|
|
|
# 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
|