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

```bash
# Install globally
npm install -g qwenclaw

# Or use from source
cd qwenclaw
npm link

# Setup (one-time)
qwenclaw setup

# Start using
qwenclaw start
qwenclaw send "Check my tasks"
```

---

## Features

### 81 Skills Across 15 Categories

| Category | Skills | Examples |
|----------|--------|----------|
| **Content** | 8 | Research writer, changelog generator |
| **Development** | 25 | Code mentor, plugin dev, TDD |
| **Design** | 3 | UI/UX Pro Max, shadcn/ui |
| **Automation** | 5 | GUI automation, web scraping |
| **Multi-Agent** | 2 | Agents Council |
| **Economic** | 1 | ClawWork (220 GDP tasks) |
| **Tools** | 10 | QwenBot, file operations |
| **Business** | 8 | Internal comms, lead research |
| **Creative** | 5 | Theme factory, canvas design |
| **Productivity** | 7 | Meeting insights, essence distiller |
| **Media** | 3 | Image enhancer, video downloader |
| **Writing** | 3 | Resume generator, brand guidelines |
| **Social** | 2 | Twitter optimizer, Slack GIF |
| **Community** | 1 | AChurch community |
| **Document** | 1 | Document skills |

### Core Capabilities

- ✅ **Qwen Code CLI Integration** - Main AI provider
- ✅ **Always-On Daemon** - Persistent background operation
- ✅ **Multi-Agent Orchestration** - Agents Council (Claude, Codex, Qwen)
- ✅ **Economic Accountability** - ClawWork (earn income via tasks)
- ✅ **FULL RAG** - Vector store, document retrieval
- ✅ **GUI Automation** - Playwright browser control
- ✅ **Web Dashboard** - http://127.0.0.1:4632
- ✅ **Telegram Integration** - Chat via Telegram
- ✅ **Scheduled Jobs** - Cron-based task scheduling

---

## Commands

### Terminal Commands

```bash
qwenclaw start          # Start daemon
qwenclaw status         # Check status
qwenclaw send "task"    # Send task to daemon
qwenclaw skills         # List all 81 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: 81 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
```

### 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                              │
│  Main Provider: Qwen Code CLI                            │
└─────────────────────────────────────────────────────────┘
                          │
        ┌─────────────────┼─────────────────┐
        │                 │                 │
        ▼                 ▼                 ▼
┌──────────────┐  ┌──────────────┐  ┌──────────────┐
│ Agents       │  │ ClawWork     │  │ FULL RAG     │
│ Council      │  │ (Economic)   │  │ (Vector DB)  │
│              │  │              │  │              │
│ • Claude     │  │ • 220 Tasks  │  │ • Documents  │
│ • Codex      │  │ • 44 Sectors │  │ • Skills     │
│ • Qwen       │  │ • Dashboard  │  │ • Sessions   │
└──────────────┘  └──────────────┘  └──────────────┘
```

---

## 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
```

---

## 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:** 81 enabled

---

## Skills (Complete List)

### Content (8)
- content-research-writer
- changelog-generator
- competitive-ads-extractor
- lead-research-assistant
- tailored-resume-generator
- brand-guidelines
- twitter-algorithm-optimizer
- slack-gif-creator

### Development (25)
- developer-growth-analysis
- web-app-testing
- mcp-builder
- backend-patterns
- code-mentor
- coding-agent
- plugin-dev (azure, github, linear, supabase, playwright)
- hook-development
- skill-development
- test-driven-development
- subagent-driven-development
- requesting-code-review
- systematic-debugging
- executing-plans
- writing-plans
- brainstorming
- finishing-a-development-branch
- using-git-worktrees
- verification-before-completion
- receiving-code-review
- dispatching-parallel-agents
- writing-skills
- using-superpowers

### Design (3)
- ui-ux-pro-max
- shadcn-ui-design
- canvas-design

### Automation (5)
- gui-automation (Playwright)
- file-organizer
- spawner-mcp
- connect-apps
- composio-skills

### Multi-Agent (2)
- agents-council-integration
- agent-council

### Economic (1)
- clawwork-integration (220 GDP tasks, 44 sectors)

### Tools (10)
- qwenbot-integration
- qwenclaw-integration
- domain-name-brainstormer
- raffle-winner-picker
- langsmith-fetch
- skill-creator
- invoice-organizer
- internal-comms
- meeting-insights-analyzer
- theme-factory

### Business (8)
- content-research-writer
- competitive-ads-extractor
- lead-research-assistant
- internal-comms
- invoice-organizer
- paper-search-tools
- slack-tools
- tavily-tools

### Creative (5)
- theme-factory
- canvas-design
- image-enhancer
- video-downloader
- creative-writing

### Productivity (7)
- meeting-insights-analyzer
- essence-distiller
- file-organizer
- domain-name-brainstormer
- raffle-winner-picker
- verification-before-completion
- systematic-debugging

### Media (3)
- image-enhancer
- video-downloader
- media-processing

### Writing (3)
- tailored-resume-generator
- brand-guidelines
- content-research-writer

### Social (2)
- twitter-algorithm-optimizer
- slack-gif-creator

### Community (1)
- achurch

### Document (1)
- document-skills

---

## 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
```

---

## Resources

- **Repository:** https://github.rommark.dev/admin/QwenClaw-with-Auth
- **OpenClaw:** https://github.com/openclaw/openclaw
- **Qwen Code:** https://github.com/QwenLM/Qwen-Code
- **Agents Council:** https://github.com/MrLesk/agents-council
- **ClawWork:** https://github.com/HKUDS/ClawWork
- **Playwright:** https://playwright.dev/

---

## License

MIT License - Based on OpenClaw (MIT)

---

**Built with 🐾 for Qwen Code CLI**