460 lines
13 KiB
Markdown
460 lines
13 KiB
Markdown
# 🐾 QwenClaw v2.0
|
||
|
||
**Qwen Code CLI's ALWAYS-ON AI Assistant**
|
||
|
||
Built from [OpenClaw](https://github.com/openclaw/openclaw) • Powered by Qwen Code CLI
|
||
|
||
---
|
||
|
||
## ⚡ Quick Start (5 Minutes)
|
||
|
||
### 1. Install
|
||
|
||
```bash
|
||
npm install -g qwenclaw
|
||
```
|
||
|
||
### 2. Setup
|
||
|
||
```bash
|
||
qwenclaw setup
|
||
```
|
||
|
||
### 3. Use
|
||
|
||
**In Terminal:**
|
||
```bash
|
||
qwenclaw start
|
||
qwenclaw status
|
||
qwenclaw skills
|
||
```
|
||
|
||
**In Qwen Code CLI:**
|
||
```
|
||
/qwenclaw:status
|
||
/qwenclaw:start
|
||
/qwenclaw:send "Check my tasks"
|
||
```
|
||
|
||
**Web Dashboard:** http://127.0.0.1:4632
|
||
|
||
---
|
||
|
||
## 📖 Full Documentation
|
||
|
||
- **[INSTALL.md](INSTALL.md)** - Complete installation guide
|
||
- **[docs/QWEN-CODE-SETUP.md](docs/QWEN-CODE-SETUP.md)** - Qwen Code integration setup
|
||
- **[skills/README.md](skills/README.md)** - All 152+ skills documentation
|
||
- **[SPARK_INTEGRATION_GUIDE.md](SPARK_INTEGRATION_GUIDE.md)** - Spark Intelligence integration
|
||
- **[VIBESHIP_INTEGRATION_SUMMARY.md](VIBESHIP_INTEGRATION_SUMMARY.md)** - Vibeship ecosystem guide
|
||
|
||
---
|
||
|
||
## 🎉 What's New (v1.10.0)
|
||
|
||
### 71 New Skills Added!
|
||
|
||
**Total Skills: 152** (up from 81)
|
||
|
||
#### Major Additions:
|
||
|
||
| Skill | Category | Description |
|
||
|-------|----------|-------------|
|
||
| **spark-intelligence** ⭐ | Automation | Self-evolving AI companion with pre-tool advisory, memory capture, and Obsidian observatory |
|
||
| **suparalph-security** 🔒 | Security | Supabase penetration testing with 277 attack vectors (RLS, Auth, API, Storage, Vibecoder) |
|
||
| **frontend-design** 🎨 | Design | Anthropic's official frontend design skill for distinctive, production-grade interfaces |
|
||
| **payloadcms-cms** 📦 | Development | PayloadCMS project creation with Next.js, TypeScript, and admin panel |
|
||
| **ralph-autonomous-agent** 🤖 | Automation | Ralph Wiggum autonomous agent loops with PRD-driven development |
|
||
|
||
#### Vibeship Ecosystem Integration:
|
||
|
||
- ✅ **Spark Intelligence** - Learning loop with pre-tool advisory
|
||
- ✅ **SupaRalph Security** - 277 attack vectors for Supabase
|
||
- ✅ **Spawner MCP** - 50+ specialist agents
|
||
- ✅ **Skills.sh** - 50+ community skills from Vercel platform
|
||
|
||
---
|
||
|
||
## Features
|
||
|
||
### 152 Skills Across 15 Categories
|
||
|
||
| Category | Skills | Examples |
|
||
|----------|--------|----------|
|
||
| **Development** | 50+ | payloadcms-cms, claude-codex-settings (15), superpowers (15), code-mentor, backend-patterns |
|
||
| **Design** | 20+ | frontend-design (Anthropic), ui-ux-pro-max (100+ rules), shadcn-ui-design |
|
||
| **Automation** | 25+ | spark-intelligence, ralph-autonomous-agent, spawner-mcp (50+ agents), gui-automation |
|
||
| **Security** | 1 | suparalph-security (277 attack vectors) |
|
||
| **Business** | 20+ | clawwork-integration (220 GDP tasks), content-research-writer, lead-research-assistant |
|
||
| **Content** | 15+ | changelog-generator, competitive-ads-extractor |
|
||
| **Tools** | 15+ | qwenbot-integration, file-organizer, domain-name-brainstormer |
|
||
| **Productivity** | 20+ | meeting-insights-analyzer, essence-distiller |
|
||
| **Media** | 15+ | image-enhancer, video-downloader |
|
||
| **Writing** | 15+ | tailored-resume-generator, brand-guidelines |
|
||
| **Multi-Agent** | 2 | agents-council-integration (FULL RAG), agent-council |
|
||
| **Economic** | 1 | clawwork-integration (220 tasks, 44 sectors) |
|
||
| **Creative** | 5+ | theme-factory, canvas-design |
|
||
| **Social** | 2+ | twitter-algorithm-optimizer, slack-gif-creator |
|
||
| **Community** | 1 | achurch |
|
||
|
||
### Core Capabilities
|
||
|
||
- ✅ **Qwen Code CLI Integration** - Main AI provider
|
||
- ✅ **Always-On Daemon** - Persistent background operation
|
||
- ✅ **Self-Evolving Learning** - Spark Intelligence with pre-tool advisory
|
||
- ✅ **Security Testing** - SupaRalph with 277 Supabase attack vectors
|
||
- ✅ **Multi-Agent Orchestration** - Agents Council (Claude, Codex, Qwen)
|
||
- ✅ **Economic Accountability** - ClawWork (earn income via 220 tasks)
|
||
- ✅ **FULL RAG** - Vector store, document retrieval
|
||
- ✅ **GUI Automation** - Playwright browser control
|
||
- ✅ **50+ Specialist Agents** - Spawner MCP integration
|
||
- ✅ **Web Dashboard** - http://127.0.0.1:4632
|
||
- ✅ **Obsidian Observatory** - 465+ pages of live intelligence data (Spark)
|
||
- ✅ **CI/CD Integration** - GitHub Actions for security scanning (SupaRalph)
|
||
|
||
---
|
||
|
||
## Commands
|
||
|
||
### Terminal Commands
|
||
|
||
```bash
|
||
qwenclaw start # Start daemon
|
||
qwenclaw status # Check status (152 skills)
|
||
qwenclaw send "task" # Send task to daemon
|
||
qwenclaw skills # List all 152 skills
|
||
qwenclaw setup # Setup wizard
|
||
qwenclaw help # Show help
|
||
```
|
||
|
||
### Inside Qwen Code CLI (Slash Commands)
|
||
|
||
After setup, use `/qwenclaw:` commands directly in Qwen Code chat:
|
||
|
||
```
|
||
/qwenclaw:start - Start daemon
|
||
/qwenclaw:status - Check daemon status
|
||
/qwenclaw:send "task" - Send task to daemon
|
||
/qwenclaw:skills - List available skills
|
||
/qwenclaw:help - Show help
|
||
```
|
||
|
||
**Example:**
|
||
```
|
||
/qwenclaw:status
|
||
```
|
||
|
||
**Response:**
|
||
```
|
||
🐾 QwenClaw Status
|
||
════════════════════════════════════════
|
||
Daemon: Ready
|
||
Provider: Qwen Code CLI
|
||
Skills: 152 available
|
||
Web Dashboard: http://127.0.0.1:4632
|
||
```
|
||
|
||
**Note:** Commands execute in your terminal and show output in Qwen Code chat.
|
||
|
||
---
|
||
|
||
## Usage Examples
|
||
|
||
### Basic Tasks
|
||
|
||
```bash
|
||
# Check status
|
||
qwenclaw status
|
||
|
||
# Send a task
|
||
qwenclaw send "Summarize my GitHub notifications"
|
||
|
||
# List skills
|
||
qwenclaw skills
|
||
```
|
||
|
||
### Spark Intelligence (Self-Evolving Learning)
|
||
|
||
```bash
|
||
# Start Spark pipeline
|
||
python -m spark.cli up
|
||
|
||
# Use QwenClaw with Spark
|
||
qwenclaw send "Refactor the authentication module"
|
||
|
||
# Spark captures patterns and provides pre-tool advisory
|
||
# ℹ️ NOTE: User prefers --no-cache for Docker builds
|
||
```
|
||
|
||
### SupaRalph Security (Supabase Penetration Testing)
|
||
|
||
```bash
|
||
# Scan Supabase project
|
||
qwenclaw send "Use suparalph-security to scan https://my-project.supabase.co"
|
||
|
||
# Full audit with 277 attack vectors
|
||
qwenclaw send "Run all 277 attacks and generate OWASP Top 10 report"
|
||
|
||
# CI/CD integration
|
||
qwenclaw send "Set up GitHub Actions for automated security scanning"
|
||
```
|
||
|
||
### Frontend-Design (Anthropic's Official Skill)
|
||
|
||
```bash
|
||
# Create distinctive landing page
|
||
qwenclaw send "Use frontend-design skill to create a SaaS landing page with brutalist aesthetic"
|
||
```
|
||
|
||
### PayloadCMS (Full-Stack CMS Development)
|
||
|
||
```bash
|
||
# Create VPS hosting site
|
||
qwenclaw send "Use payloadcms-cms skill to build a VPS hosting landing page with admin panel"
|
||
```
|
||
|
||
### Ralph Autonomous Agent (PRD-Driven Loops)
|
||
|
||
```bash
|
||
# Autonomous development loop
|
||
qwenclaw send "Use ralph-autonomous-agent to implement this feature with test-driven development"
|
||
```
|
||
|
||
### Multi-Agent Code Review
|
||
|
||
```bash
|
||
qwenclaw send "Start code review council for PR #42"
|
||
```
|
||
|
||
### GUI Automation
|
||
|
||
```bash
|
||
qwenclaw send "Screenshot https://example.com"
|
||
```
|
||
|
||
### Economic Tasks (ClawWork)
|
||
|
||
```bash
|
||
qwenclaw send "Check my ClawWork balance and start a task"
|
||
```
|
||
|
||
---
|
||
|
||
## Architecture
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────────┐
|
||
│ QWENCLAW v1.10.0 │
|
||
│ Main Provider: Qwen Code CLI | 152 Skills │
|
||
└─────────────────────────────────────────────────────────┘
|
||
│
|
||
┌─────────────────┼─────────────────┐
|
||
│ │ │
|
||
▼ ▼ ▼
|
||
┌──────────────┐ ┌──────────────┐ ┌──────────────┐
|
||
│ Spark │ │ SupaRalph │ │ Agents │
|
||
│ Intelligence │ │ Security │ │ Council │
|
||
│ │ │ │ │ │
|
||
│ • Pre-Tool │ │ • 277 │ │ • Claude │
|
||
│ Advisory │ │ Attacks │ │ • Codex │
|
||
│ • Memory │ │ • OWASP │ │ • Qwen │
|
||
│ Capture │ │ • CI/CD │ │ │
|
||
│ • EIDOS Loop │ │ • AI Fixes │ │ │
|
||
│ • Obsidian │ │ │ │ │
|
||
└──────────────┘ └──────────────┘ └──────────────┘
|
||
│
|
||
┌─────────────────┼─────────────────┐
|
||
│ │ │
|
||
▼ ▼ ▼
|
||
┌──────────────┐ ┌──────────────┐ ┌──────────────┐
|
||
│ PayloadCMS │ │ ClawWork │ │ Spawner MCP │
|
||
│ │ │ (Economic) │ │ │
|
||
│ • Next.js │ │ │ │ • 50+ │
|
||
│ • TypeScript │ │ • 220 Tasks │ │ Agents │
|
||
│ • Admin │ │ • 44 Sectors │ │ • Frontend │
|
||
│ • Auth │ │ • Dashboard │ │ • Backend │
|
||
└──────────────┘ └──────────────┘ └──────────────┘
|
||
```
|
||
|
||
---
|
||
|
||
## Installation
|
||
|
||
### From npm (Recommended)
|
||
|
||
```bash
|
||
npm install -g qwenclaw
|
||
qwenclaw setup
|
||
qwenclaw start
|
||
```
|
||
|
||
### From Source
|
||
|
||
```bash
|
||
git clone https://github.rommark.dev/admin/QwenClaw-with-Auth.git
|
||
cd QwenClaw-with-Auth
|
||
npm install
|
||
npm link
|
||
qwenclaw setup
|
||
qwenclaw start
|
||
```
|
||
|
||
### Install Spark Intelligence (Optional but Recommended)
|
||
|
||
```powershell
|
||
# Windows
|
||
irm https://raw.githubusercontent.com/vibeforge1111/vibeship-spark-intelligence/main/install.ps1 | iex
|
||
|
||
# Mac/Linux
|
||
curl -fsSL https://raw.githubusercontent.com/vibeforge1111/vibeship-spark-intelligence/main/install.sh | bash
|
||
```
|
||
|
||
### Install SupaRalph (Optional for Supabase Security)
|
||
|
||
```bash
|
||
git clone https://github.com/vibeforge1111/vibeship-suparalph.git
|
||
cd vibeship-suparalph
|
||
npm install
|
||
npm run dev
|
||
```
|
||
|
||
---
|
||
|
||
## Configuration
|
||
|
||
Auto-configured during setup. Manual config:
|
||
|
||
```
|
||
~/.qwen/qwenclaw/settings.json
|
||
```
|
||
|
||
Defaults:
|
||
- **Provider:** Qwen Code CLI
|
||
- **Web Dashboard:** http://127.0.0.1:4632
|
||
- **Auto-Start:** Enabled
|
||
- **Skills:** 152 enabled
|
||
|
||
---
|
||
|
||
## Skills Index
|
||
|
||
See **[skills/README.md](skills/README.md)** for the complete list of all 152 skills.
|
||
|
||
### Quick Reference
|
||
|
||
#### Development (50+)
|
||
- payloadcms-cms, claude-codex-settings (15 plugins), superpowers (15 skills)
|
||
- code-mentor, backend-patterns, mcp-builder, web-app-testing
|
||
- plugin-dev (azure, github, linear, supabase, playwright)
|
||
|
||
#### Design (20+)
|
||
- frontend-design (Anthropic official), ui-ux-pro-max (100+ rules, 67 styles)
|
||
- shadcn-ui-design, canvas-design, theme-factory
|
||
|
||
#### Automation (25+)
|
||
- spark-intelligence (self-evolving learning), ralph-autonomous-agent
|
||
- spawner-mcp (50+ agents), gui-automation (Playwright)
|
||
- agent-council, ec-task-orchestrator
|
||
|
||
#### Security (1)
|
||
- suparalph-security (277 attack vectors, OWASP, SOC2, GDPR)
|
||
|
||
#### Business & Economic (20+)
|
||
- clawwork-integration (220 GDP tasks, 44 sectors)
|
||
- content-research-writer, competitive-ads-extractor, lead-research-assistant
|
||
|
||
#### Tools & Productivity (30+)
|
||
- qwenbot-integration, file-organizer, domain-name-brainstormer
|
||
- meeting-insights-analyzer, essence-distiller, skill-creator
|
||
|
||
---
|
||
|
||
## Troubleshooting
|
||
|
||
### Daemon not starting
|
||
|
||
```bash
|
||
# Check Qwen Code CLI
|
||
qwen --version
|
||
|
||
# Restart daemon
|
||
qwenclaw start
|
||
```
|
||
|
||
### Skills not available
|
||
|
||
```bash
|
||
# List skills
|
||
qwenclaw skills
|
||
|
||
# Re-run setup
|
||
qwenclaw setup
|
||
```
|
||
|
||
### Web dashboard not opening
|
||
|
||
```bash
|
||
# Check if port is in use
|
||
netstat -ano | findstr :4632
|
||
|
||
# Start dashboard manually
|
||
qwenclaw start --web
|
||
```
|
||
|
||
### Spark Intelligence not capturing
|
||
|
||
```bash
|
||
# Start Spark pipeline
|
||
python -m spark.cli up
|
||
|
||
# Check health
|
||
python -m spark.cli health
|
||
```
|
||
|
||
### SupaRalph not scanning
|
||
|
||
```bash
|
||
# Run locally
|
||
cd vibeship-suparalph
|
||
npm run dev
|
||
|
||
# Open http://localhost:5173
|
||
```
|
||
|
||
---
|
||
|
||
## Resources
|
||
|
||
### Core
|
||
- **Repository:** https://github.rommark.dev/admin/QwenClaw-with-Auth
|
||
- **OpenClaw:** https://github.com/openclaw/openclaw
|
||
- **Qwen Code:** https://github.com/QwenLM/Qwen-Code
|
||
|
||
### Vibeship Ecosystem
|
||
- **Spark Intelligence:** https://github.com/vibeforge1111/vibeship-spark-intelligence
|
||
- **SupaRalph:** https://github.com/vibeforge1111/vibeship-suparalph
|
||
- **Spawner:** https://spawner.vibeship.co/
|
||
- **Skills.sh:** https://skills.sh
|
||
|
||
### Skills & Agents
|
||
- **Agents Council:** https://github.com/MrLesk/agents-council
|
||
- **ClawWork:** https://github.com/HKUDS/ClawWork
|
||
- **Frontend-Design:** https://github.com/anthropics/claude-code
|
||
- **UI/UX Pro Max:** https://github.com/nextlevelbuilder/ui-ux-pro-max-skill
|
||
- **Ralph:** https://github.com/snwfdhmp/awesome-ralph
|
||
- **PayloadCMS:** https://github.com/payloadcms/payload
|
||
|
||
### Tools
|
||
- **Playwright:** https://playwright.dev/
|
||
- **Claude Codex Settings:** https://github.com/fcakyon/claude-codex-settings
|
||
|
||
---
|
||
|
||
## License
|
||
|
||
MIT License - Based on OpenClaw (MIT)
|
||
|
||
---
|
||
|
||
**Built with 🐾 for Qwen Code CLI | v1.10.0 with 152 skills**
|