QwenClaw-with-Auth/INSTALL.md

🐾 QwenClaw Installation & Setup Guide

Complete guide to installing and using QwenClaw with Qwen Code CLI

---

⚡ Quick Start (5 Minutes)

Step 1: Install QwenClaw

# Option A: Install globally (recommended)
npm install -g qwenclaw

# Option B: Use from source
git clone https://github.rommark.dev/admin/QwenClaw-with-Auth.git
cd QwenClaw-with-Auth
npm install
npm link

Step 2: Run Setup

qwenclaw setup

Step 3: Start Using

In Terminal:

qwenclaw start
qwenclaw status

In Qwen Code CLI:

/qwenclaw:status
/qwenclaw:start
/qwenclaw:send "Check my tasks"

---

📋 Prerequisites

• Node.js version 22 or higher
• Qwen Code CLI installed and configured
• npm or bun package manager

Check Node Version

node --version  # Should be v22.x or higher

Install Node.js (if needed)

• Windows/macOS: Download from https://nodejs.org/
• Linux: curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - && sudo apt-get install -y nodejs

---

🚀 Installation Methods

Method 1: npm (Recommended)

# Install globally
npm install -g qwenclaw

# Verify installation
qwenclaw --version

Method 2: From Source

# Clone repository
git clone https://github.rommark.dev/admin/QwenClaw-with-Auth.git
cd QwenClaw-with-Auth

# Install dependencies
npm install

# Link globally
npm link

# Verify
qwenclaw --version

Method 3: Development Mode

# Clone and install
git clone https://github.rommark.dev/admin/QwenClaw-with-Auth.git
cd QwenClaw-with-Auth
npm install

# Run without installing
npm run start
npm run status

---

⚙️ Configuration

Run Setup Wizard

qwenclaw setup

This will:

1. Create ~/.qwen/qwenclaw/ directory
2. Generate default settings
3. Configure Qwen Code integration

Manual Configuration

Create ~/.qwen/qwenclaw/settings.json:

{
  "model": "qwen-plus",
  "api": "",
  "timezone": "UTC",
  "heartbeat": {
    "enabled": false,
    "interval": 15
  },
  "telegram": {
    "token": "",
    "allowedUserIds": []
  },
  "security": {
    "level": "moderate"
  },
  "web": {
    "enabled": true,
    "host": "127.0.0.1",
    "port": 4632
  }
}

---

🎯 Usage

Terminal Commands

Command	Description
qwenclaw start	Start daemon
qwenclaw status	Check status
qwenclaw send "message"	Send task
qwenclaw skills	List skills
qwenclaw help	Show help

Qwen Code Slash Commands

After installation, use these inside Qwen Code chat:

Command	Description
/qwenclaw:start	Start daemon
/qwenclaw:status	Check status
/qwenclaw:send "task"	Send task
/qwenclaw:skills	List skills
/qwenclaw:help	Show help

Examples

Start Daemon:

qwenclaw start

Check Status:

/qwenclaw:status

Send Task:

qwenclaw send "Summarize my GitHub notifications"

List Skills:

/qwenclaw:skills

---

🌐 Web Dashboard

Access the web dashboard at:

http://127.0.0.1:4632

Features:

• Real-time daemon status
• Skill management
• Job scheduling
• Logs viewer

---

📚 Available Skills (81 Total)

By Category

Category	Count	Examples
Content	8	Research writer, changelog
Development	25	Code mentor, plugin dev
Design	3	UI/UX Pro Max, shadcn/ui
Automation	5	GUI automation
Multi-Agent	2	Agents Council
Economic	1	ClawWork (220 tasks)
Tools	10	QwenBot, file ops
Business	8	Internal comms
Creative	5	Theme factory
Productivity	7	Meeting insights
Media	3	Image, video
Writing	3	Resume, brand
Social	2	Twitter, Slack
Community	1	AChurch
Document	1	Document skills

List All Skills

qwenclaw skills

Or in Qwen Code:

/qwenclaw:skills

---

🔧 Troubleshooting

Issue: "command not found: qwenclaw"

Solution:

# Reinstall globally
npm install -g qwenclaw

# Or add npm global bin to PATH
# Windows: %APPDATA%\npm
# macOS/Linux: ~/.npm-global/bin

Issue: "/qwenclaw:status unknown command"

Solution:

# Verify commands directory exists
ls -la ~/.qwen/commands/qwenclaw/

# Should contain: start.md, status.md, send.md, skills.md, help.md

# Restart Qwen Code
exit
qwen

Issue: "Daemon not running"

Solution:

# Start daemon
qwenclaw start

# Or use slash command
/qwenclaw:start

Issue: "Skills not available"

Solution:

# Check skills directory
ls -la ~/.qwen/qwenclaw/skills/

# Re-run setup
qwenclaw setup

---

📖 Additional Resources

• GitHub: https://github.rommark.dev/admin/QwenClaw-with-Auth
• Issues: https://github.rommark.dev/admin/QwenClaw-with-Auth/issues
• OpenClaw: https://github.com/openclaw/openclaw
• Qwen Code: https://github.com/QwenLM/Qwen-Code

---

🆘 Getting Help

View Help

qwenclaw help

Or in Qwen Code:

/qwenclaw:help

Report Issues

1. Check existing issues: https://github.rommark.dev/admin/QwenClaw-with-Auth/issues
2. Create new issue with:
   • QwenClaw version: qwenclaw --version
   • Node version: node --version
   • OS and version
   • Error message
   • Steps to reproduce

---

✅ Verification Checklist

After installation, verify:

• qwenclaw --version shows version 2.0.1 or higher
• qwenclaw status shows daemon status
• /qwenclaw:status works in Qwen Code
• Web dashboard accessible at http://127.0.0.1:4632
• Skills directory exists: ~/.qwen/qwenclaw/skills/
• Commands directory exists: ~/.qwen/commands/qwenclaw/

---

You're all set! Start using QwenClaw with /qwenclaw:status in Qwen Code! 🐾🎉