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