From 022ce10de93a9ffd220863dcd323ac24bf05e090 Mon Sep 17 00:00:00 2001 From: admin Date: Thu, 26 Feb 2026 18:41:33 +0400 Subject: [PATCH] docs: Add complete Qwen Code CLI setup guide --- docs/QWEN-CODE-SETUP.md | 393 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 393 insertions(+) create mode 100644 docs/QWEN-CODE-SETUP.md diff --git a/docs/QWEN-CODE-SETUP.md b/docs/QWEN-CODE-SETUP.md new file mode 100644 index 0000000..78535eb --- /dev/null +++ b/docs/QWEN-CODE-SETUP.md @@ -0,0 +1,393 @@ +# QwenClaw + Qwen Code CLI - Complete Setup Guide + +## Quick Start (5 Minutes) + +### Step 1: Install QwenClaw + +```bash +# Clone repository +git clone https://github.rommark.dev/admin/QwenClaw-with-Auth.git +cd QwenClaw-with-Auth + +# Install dependencies +bun install + +# Run setup (auto-configures everything) +bun run setup +``` + +### Step 2: Set as Default Agent + +```bash +# Configure Qwen Code to use QwenClaw as ALWAYS-ON default agent +bun run set-default +``` + +### Step 3: Restart Qwen Code + +```bash +# Close and reopen Qwen Code +qwen + +# QwenClaw will auto-start automatically +# You'll see: 🐾 QwenClaw Agent initialized +``` + +--- + +## Usage Inside Qwen Code CLI + +### Method 1: Use /qwenclaw Commands (Recommended) + +Once QwenClaw is configured, use these commands directly in Qwen Code chat: + +``` +/qwenclaw status - Check daemon status +/qwenclaw send "task" - Send task to daemon +/qwenclaw skills - List all 81 skills +/qwenclaw help - Show help +``` + +### Method 2: Natural Language (QwenClaw is Default) + +Since QwenClaw is your default agent, just talk naturally: + +``` +Check my pending tasks + +Summarize my calendar for today + +Use gui-automation to screenshot https://example.com + +Start a multi-agent code review with Claude and Codex + +Find documents about API design in my RAG store +``` + +### Method 3: MCP Commands + +QwenClaw provides MCP tools you can invoke: + +``` +MCP: qwenclaw.start() +MCP: qwenclaw.send_message("Check my tasks") +MCP: qwenclaw.get_status() +``` + +--- + +## Configuration Files + +### 1. Qwen Code Settings (`~/.qwen/settings.json`) + +After running `bun run set-default`, this should exist: + +```json +{ + "agents": { + "default": "qwenclaw", + "enforce": true, + "qwenclaw": { + "name": "QwenClaw", + "autoStart": true, + "alwaysOn": true, + "skills": [ + "qwenclaw-integration", + "gui-automation", + "qwenbot-integration" + ] + } + }, + "skills": { + "default": "qwenclaw-integration", + "enabled": [ + "qwenclaw-integration", + "gui-automation", + "qwenbot-integration" + ] + }, + "mcpServers": { + "qwenclaw": { + "command": "bun", + "args": ["run", "start", "--web"], + "cwd": "~/qwenclaw", + "env": { + "QWENCLAW_AUTO_START": "true" + } + } + } +} +``` + +### 2. Agent Configuration (`~/.qwen/agent.json`) + +```json +{ + "agent": { + "default": "qwenclaw", + "enforce": true, + "agents": { + "qwenclaw": { + "name": "QwenClaw", + "alwaysOn": true, + "priority": 1 + } + } + } +} +``` + +### 3. MCP Configuration (`~/.qwen/mcp.json`) + +```json +{ + "mcpServers": { + "qwenclaw": { + "command": "bun", + "args": ["run", "start", "--web"], + "cwd": "~/qwenclaw" + }, + "council": { + "command": "npx", + "args": ["agents-council@latest", "mcp"] + }, + "clawwork": { + "command": "python", + "args": ["-m", "clawwork.server"], + "cwd": "~/ClawWork" + } + } +} +``` + +--- + +## Verify Installation + +### 1. Check QwenClaw is Running + +```bash +# In terminal +qwenclaw status + +# Should show: +βœ… QwenClaw daemon is running + PID: 12345 + Web UI: http://127.0.0.1:4632 +``` + +### 2. Check Qwen Code Configuration + +```bash +# In Qwen Code CLI +qwen + +# Then ask: +Are you QwenClaw? + +# Should respond: +Yes! I'm QwenClaw, your persistent AI assistant daemon. +``` + +### 3. Test Daemon Communication + +``` +/qwenclaw send "Hello, are you running?" + +# Should respond: +βœ… QwenClaw daemon is running and ready to help! +``` + +--- + +## Common Use Cases + +### 1. Code Review with Multi-Agent Council + +``` +Start a code review council with Claude and Codex to review my PR at https://github.rommark.dev/admin/QwenClaw-with-Auth/pull/42 +``` + +### 2. GUI Automation + +``` +Use gui-automation to navigate to https://github.rommark.dev/admin/QwenClaw-with-Auth and take a screenshot +``` + +### 3. Economic Tasks (ClawWork) + +``` +Check my ClawWork balance and start working on a task +``` + +### 4. RAG Search + +``` +Find all documents in my RAG store about API design patterns +``` + +### 5. Schedule Task + +``` +Schedule a daily standup at 9 AM that summarizes my GitHub notifications +``` + +--- + +## Troubleshooting + +### Issue: "Unknown command: /qwenclaw" + +**Solution:** +```bash +# Re-run configuration +cd ~/qwenclaw +bun run set-default + +# Restart Qwen Code +exit +qwen +``` + +### Issue: "QwenClaw daemon not running" + +**Solution:** +```bash +# Start daemon manually +cd ~/qwenclaw +bun run start --web + +# Or use command +qwenclaw start --web +``` + +### Issue: "Skills not enabled" + +**Solution:** +```bash +# Check enabled skills +cat ~/.qwen/settings.json | grep -A 10 '"skills"' + +# Should show: +"skills": { + "enabled": [ + "qwenclaw-integration", + "gui-automation", + "qwenbot-integration" + ] +} +``` + +### Issue: "MCP server not found" + +**Solution:** +```bash +# Check MCP config +cat ~/.qwen/mcp.json + +# Should have qwenclaw entry +{ + "mcpServers": { + "qwenclaw": { + "command": "bun", + "args": ["run", "start", "--web"], + "cwd": "~/qwenclaw" + } + } +} +``` + +--- + +## Full Feature List + +### 81 Skills Available + +| Category | Skills | +|----------|--------| +| **Content** | Research writer, changelog generator | +| **Development** | Code mentor, plugin dev, hook dev | +| **Design** | UI/UX Pro Max, shadcn/ui | +| **Automation** | GUI automation, Spawner MCP | +| **Multi-Agent** | Agents Council | +| **Economic** | ClawWork (220 GDP tasks) | +| **Tools** | QwenBot, file organizer | +| **Business** | Internal comms, lead research | +| **Creative** | Theme factory, canvas design | +| **Productivity** | Meeting insights, essence distiller | + +### Daemon Features + +- βœ… Auto-starts with Qwen Code +- βœ… Persistent sessions +- βœ… Web dashboard (http://127.0.0.1:4632) +- βœ… Telegram integration +- βœ… Scheduled jobs (cron) +- βœ… Heartbeat check-ins +- βœ… FULL RAG (vector store) +- βœ… Multi-agent orchestration +- βœ… Economic accountability (ClawWork) + +--- + +## Quick Reference Card + +``` +╔══════════════════════════════════════════════════════════╗ +β•‘ QWENCLAW + QWEN CODE CLI β•‘ +╠══════════════════════════════════════════════════════════╣ +β•‘ Setup: β•‘ +β•‘ git clone ... && cd QwenClaw-with-Auth β•‘ +β•‘ bun install && bun run setup && bun run set-default β•‘ +β•‘ β•‘ +β•‘ Commands: β•‘ +β•‘ /qwenclaw status - Check daemon β•‘ +β•‘ /qwenclaw send "task" - Send task β•‘ +β•‘ /qwenclaw skills - List skills β•‘ +β•‘ /qwenclaw help - Show help β•‘ +β•‘ β•‘ +β•‘ Natural Language: β•‘ +β•‘ "Check my tasks" β•‘ +β•‘ "Screenshot https://..." β•‘ +β•‘ "Start code review council" β•‘ +β•‘ "Find docs about..." β•‘ +β•‘ β•‘ +β•‘ Web Dashboard: http://127.0.0.1:4632 β•‘ +β•‘ Docs: ~/qwenclaw/README.md β•‘ +β•šβ•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β• +``` + +--- + +## Next Steps + +1. βœ… **Install & Configure** (5 min) + ```bash + git clone ... && cd QwenClaw-with-Auth + bun install && bun run setup && bun run set-default + ``` + +2. βœ… **Restart Qwen Code** + ```bash + exit + qwen + ``` + +3. βœ… **Test It** + ``` + /qwenclaw status + ``` + +4. βœ… **Start Using** + ``` + Check my pending tasks + ``` + +5. βœ… **Explore Features** + ``` + /qwenclaw skills + ``` + +--- + +**You're ready to use QwenClaw inside Qwen Code CLI!** πŸΎπŸŽ‰