ClawFlow is the ultimate skill + agent + cron installer for the OpenClaw/OpenKrab ecosystem.
It provides a seamless developer experience to create, install, and automate AI skills in one unified flow.
- 🆕 Dev-First Creation: Generate skill and agent templates in seconds with
clawflow create - 🚀 One-Step Installation: Install complex skill bundles from ClawHub or Git
- 🛠️ Local Development: Link your local work instantly with
clawflow registerorinstall --dev - ⏰ Smart Automation: Advanced cron management with shorthand support (e.g.,
5m,1h,2d) - 📦 Bundle Support: Automatically detect and install multiple skills from a single repository
- 🩺 System Diagnostic: Keep your environment healthy with
clawflow doctor - 🔍 Discovery: Explore the ecosystem with
clawflow searchandexplore
- Node.js 16+
- OpenClaw CLI installed
- Git (for fallback installation)
npm i -g clawflowbangVerify installation:
clawflow --versionclawflow initGenerate a production-ready template in TypeScript or Python:
clawflow create skill my-cool-skill
# or
clawflow create agent my-research-agentLink your local skill folder directly to OpenClaw (Symlink mode):
cd my-cool-skill
clawflow register .Changes you make in your local folder will reflect immediately in OpenClaw!
Install a remote package but setup symlinks for development:
clawflow install https://github.com/user/repo --devclawflow create [type] [name] # Create skill/agent template
clawflow register [path] # Register local skill via symlink
clawflow install <package> # Install from registry or URL
--dev # Symlink mode for local development
--bundle # Install all sub-skills in repo
clawflow list [--available] [--npm] # List installed/available packages
clawflow search <query> # Search packages
clawflow explore # Discover featured skills
clawflow doctor # Check system healthclawflow cron-list # List all active cronjobs
clawflow cron-add <skill> # Add new cronjob
--schedule "*/5 * * * *" # Standard cron
--every 15m # Shorthand: 5m, 1h, 2d
--dry-run # Preview before adding
clawflow cron-edit <id> # Modify existing job
clawflow cron-remove <id> # Remove cronjobSupported formats:
- Raw cron:
*/5 * * * * - Preset:
@hourly,@daily,@weekly,@monthly - Shorthand:
5m,every 15m,1h,2d
clawflow cron-add crypto-price --every 15m
clawflow cron-edit <job-id> --schedule "@daily"
clawflow cron-edit <job-id> --params '{"symbols":["BTC","ETH"]}'
clawflow cron-remove <job-id>- Primary: Try
clawhub installfrom registry - Fallback: Use
git clonewhen registry fails - Validation: Check
SKILL.mdexists and is valid
Required fields in package metadata:
repositoryorrepoorgit- Git repository URL- Optional:
branch/tag/ref- Specific version
- Skills directory:
~/.openclaw/workspace/skills - Cron jobs file:
~/.openclaw/cron/jobs.json
Override defaults during installation:
clawflow install <package> \
--skills-path "<path-to-skills>" \
--cron-jobs "<path-to-jobs.json>"clawflow reads package metadata from npm packages using the clawflow field:
{
"name": "my-kit",
"version": "1.0.0",
"keywords": ["clawflow"],
"clawflow": {
"skills": [
{
"name": "crypto-price",
"version": "^1.0.0",
"source": "openclaw",
"repository": "https://github.com/owner/crypto-price-skill.git"
}
],
"crons": [
{
"skill": "crypto-price",
"schedule": "*/5 * * * *",
"params": { "symbols": ["BTC", "ETH"] }
}
]
}
}- Node.js 16+ - Core runtime
- Commander.js - CLI framework
- Node-cron - Cron job management
- Axios - HTTP requests for registry
- Chalk + Gradient-string - Terminal styling
- Inquirer.js - Interactive prompts
- YAML - Configuration parsing
- Boxen - Beautiful terminal boxes
ClawFlowHub/
├── bin/
│ └── clawflowhub.js # CLI entry point
├── src/
│ ├── index.js # Main module
│ ├── commands/ # Command implementations
│ ├── utils/ # Utility functions
│ └── config/ # Configuration management
├── skills/ # Example skills
├── examples/ # Usage examples
├── docs/ # Documentation
├── tests/ # Test suite
├── package.json # NPM package config
├── image.png # Project banner
└── README.md # This file
git clone https://github.com/OpenKrab/ClawFlowHub.git
cd ClawFlowHub
npm installnpm run lint # Lint code
npm test # Run test suite
npm start # Run CLI locally# Test basic functionality
clawflow --help
clawflow list --available
clawflow search cryptoClawFlow integrates with OpenClaw ecosystem through:
- Skill Installation: Direct integration with OpenClaw skill system
- Cron Management: Uses OpenClaw's cron job infrastructure
- Registry Access: Leverages ClawHub for skill discovery
- Configuration: Respects OpenClaw's configuration patterns
PRs are welcome! Please ensure:
- Code follows existing ESLint patterns
- Add tests for new functionality
- Update documentation as needed
- Test cross-platform compatibility
- Follow semantic versioning
MIT
Built for the Lobster Way 🦞