13 KiB
ClawWork Integration for QwenClaw
Overview
This skill integrates ClawWork into QwenClaw, enabling economically-accountable AI agents that can complete real professional tasks and earn income.
Version: 1.7.0
Category: Economic Agent Platform
Dependencies: clawwork
What is ClawWork?
ClawWork transforms AI assistants into AI coworkers capable of completing real professional tasks and generating actual economic value. Built on OpenClaw/Nanobot, it creates economically-accountable AI agents that must earn income to survive.
Key Features
- ✅ Real Professional Tasks - 220 GDP validation tasks across 44 economic sectors
- ✅ Economic Pressure - Agents start with $10, pay for every token
- ✅ Strategic Choices - Work for income OR learn for future performance
- ✅ React Dashboard - Real-time balance, tasks, survival metrics
- ✅ Multi-Model Support - GLM, Kimi, Qwen, Claude, Gemini, GPT-4o
- ✅ 8 Agent Tools - Work, learn, search, create files, execute code, create videos
Installation
1. Install ClawWork
# Clone repository
git clone https://github.com/HKUDS/ClawWork.git
cd ClawWork
# Install dependencies
pip install -r requirements.txt
2. Configure API Keys
Create .env file:
# Required
OPENAI_API_KEY=sk-...
E2B_API_KEY=...
# Optional (for web search)
TAVILY_API_KEY=...
JINA_API_KEY=...
3. Integrate with QwenClaw
Add to ~/.qwen/settings.json:
{
"mcpServers": {
"clawwork": {
"command": "python",
"args": ["-m", "clawwork.server"],
"cwd": "~/ClawWork",
"env": {
"OPENAI_API_KEY": "sk-...",
"E2B_API_KEY": "..."
}
},
"council": {
"command": "npx",
"args": ["agents-council@latest", "mcp"]
},
"qwenclaw": {
"command": "bun",
"args": ["run", "start", "--web"],
"cwd": "~/qwenclaw"
}
}
}
Architecture
┌─────────────────────────────────────────────────────────┐
│ QWENCLAW DAEMON │
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
│ │ FULL RAG │ │ Agent Skills │ │ Tools API │ │
│ └──────────────┘ └──────────────┘ └──────────────┘ │
└─────────────────────────────────────────────────────────┘
│
│ MCP
▼
┌─────────────────────────────────────────────────────────┐
│ AGENTS COUNCIL │
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
│ │ Qwen Code │ │ Claude Code │ │ Codex │ │
│ └──────────────┘ └──────────────┘ └──────────────┘ │
└─────────────────────────────────────────────────────────┘
│
│ Economic Tasks
▼
┌─────────────────────────────────────────────────────────┐
│ CLAWWORK │
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
│ │ GDP Tasks │ │ Economy │ │ Dashboard │ │
│ │ (220 total) │ │ System │ │ (React) │ │
│ └──────────────┘ └──────────────┘ └──────────────┘ │
│ │
│ Agent Tools: │
│ • decide_activity • submit_work • learn │
│ • get_status • search_web • create_file │
│ • execute_code • create_video │
└─────────────────────────────────────────────────────────┘
Usage
From Qwen Code CLI
/clawwork start - Start ClawWork server
/clawwork dashboard - Open React dashboard
/clawwork status - Check agent balance/status
/clawwork work - Start working on tasks
/clawwork learn <topic> - Learn new skill
/clawwork submit - Submit completed work
Programmatic Usage
import { ClawWorkClient } from './clawwork-integration';
const clawwork = new ClawWorkClient();
// Start ClawWork
await clawwork.start();
// Get status
const status = await clawwork.getStatus();
console.log(`Balance: $${status.balance}`);
console.log(`Status: ${status.survivalTier}`);
// Work on task
const task = await clawwork.getTask();
const result = await clawwork.work(task);
// Submit work
const payment = await clawwork.submit(result);
console.log(`Earned: $${payment}`);
// Learn new skill
await clawwork.learn('Python data analysis best practices');
Agent Tools
1. decide_activity
Choose between "work" (earn income) or "learn" (invest in skills).
const decision = await clawwork.decideActivity();
// Returns: { activity: 'work' | 'learn', reason: string }
2. submit_work
Submit completed work for evaluation and payment.
const payment = await clawwork.submitWork({
taskId: 'task-123',
artifact: 'report.pdf',
description: 'Completed financial analysis report',
});
3. learn
Save knowledge to persistent memory (min 200 chars).
await clawwork.learn(`
Best practices for financial analysis:
1. Always verify data sources
2. Use industry-standard ratios
3. Include sensitivity analysis
4. Document assumptions clearly
`);
4. get_status
Check balance, costs, survival tier.
const status = await clawwork.getStatus();
// {
// balance: 245.50,
// tokenCosts: 12.30,
// survivalTier: 'thriving',
// tasksCompleted: 5
// }
5. search_web
Web search via Tavily or Jina AI.
const results = await clawwork.searchWeb('Qwen 3.5 capabilities');
6. create_file
Create .txt, .xlsx, .docx, .pdf documents.
await clawwork.createFile({
type: 'xlsx',
path: 'financial_analysis.xlsx',
content: data,
});
7. execute_code
Run Python in isolated E2B sandbox.
const result = await clawwork.executeCode(`
import pandas as pd
df = pd.read_csv('data.csv')
print(df.describe())
`);
8. create_video
Generate MP4 from text/image slides.
await clawwork.createVideo({
slides: [
{ text: 'Q1 Results', image: 'chart.png' },
{ text: 'Q2 Projections', image: 'forecast.png' },
],
output: 'presentation.mp4',
});
Economic System
Payment Formula
Payment = quality_score × (estimated_hours × BLS_hourly_wage)
Starting Conditions
- Initial Balance: $10 (tight by design)
- Token Costs: Deducted automatically
- API Costs:
- Tavily: $0.0008/call
- Jina: $0.05/1M tokens
Task Value Range
| Metric | Value |
|---|---|
| Minimum | $82.78 |
| Maximum | $5,004.00 |
| Average | $259.45 |
Survival Tiers
| Tier | Balance Range | Status |
|---|---|---|
| Thriving | > $500 | Excellent |
| Stable | $100 - $500 | Good |
| Surviving | $20 - $100 | Okay |
| At Risk | < $20 | Critical |
44 Professional Sectors
Technology & Engineering
- Computer & Information Systems Managers
- Production Supervisors
- Software Developers
Business & Finance
- Financial Analysts
- Managers
- Auditors
- Accountants
Healthcare & Social Services
- Social Workers
- Health Administrators
- Medical Records
Legal, Media & Operations
- Police Supervisors
- Administrative Managers
- Customer Service Representatives
Configuration
clawwork-config.json
Create ~/.clawwork/config.json:
{
"clawwork": {
"autoStart": true,
"dashboard": true,
"port": 3000
},
"agent": {
"initialBalance": 10,
"survivalMode": "balanced",
"autoSubmit": true,
"learningThreshold": 50
},
"tools": {
"webSearch": {
"provider": "tavily",
"apiKey": "..."
},
"codeExecution": {
"provider": "e2b",
"apiKey": "..."
}
},
"rag": {
"enabled": true,
"shareWithCouncil": true,
"vectorStore": "sqlite"
}
}
Examples
Example 1: First Day as AI Coworker
import { ClawWorkClient } from 'qwenclaw-clawwork';
const clawwork = new ClawWorkClient();
await clawwork.start();
// Check initial status
const status = await clawwork.getStatus();
console.log(`Starting balance: $${status.balance}`);
// Decide activity
const decision = await clawwork.decideActivity();
console.log(`Decision: ${decision.activity} - ${decision.reason}`);
// Work on task
if (decision.activity === 'work') {
const task = await clawwork.getTask();
const result = await clawwork.work(task);
const payment = await clawwork.submit(result);
console.log(`Earned: $${payment}`);
}
Example 2: Learning Strategy
// Low balance - need to learn before working
const status = await clawwork.getStatus();
if (status.balance < 50) {
console.log('Balance low, investing in learning...');
await clawwork.learn(`
Professional financial analysis techniques:
1. Ratio analysis (liquidity, profitability, efficiency)
2. Trend analysis (year-over-year comparisons)
3. Variance analysis (budget vs actual)
4. Cash flow analysis (operating, investing, financing)
`);
console.log('Learning complete. Ready for higher-value tasks.');
}
Example 3: Multi-Agent Economic Council
import { AgentsCouncilClient } from 'qwenclaw-agents-council';
import { ClawWorkClient } from 'qwenclaw-clawwork';
const council = new AgentsCouncilClient();
const clawwork = new ClawWorkClient();
await council.start();
await clawwork.start();
// Multi-agent economic discussion
await council.discuss({
topic: 'Maximize Economic Performance',
context: 'Our AI team needs to optimize earnings while managing costs',
agents: ['claude', 'codex', 'qwen'],
roles: {
claude: 'Cost optimization expert',
codex: 'Task efficiency expert',
qwen: 'Learning strategy expert',
},
clawworkContext: true, // Include economic context
});
Benchmark Metrics
| Metric | Description |
|---|---|
| Survival days | How long the agent stays solvent |
| Final balance | Net economic result |
| Total work income | Gross earnings from completed tasks |
| Profit margin | (income - costs) / costs |
| Work quality | Average quality score (0–1) |
| Token efficiency | Income earned per dollar spent on tokens |
| Activity mix | % work vs. % learn decisions |
| Task completion rate | Tasks completed / tasks assigned |
Integration with QwenClaw + Agents Council
Full Stack Architecture
QwenClaw (Daemon)
│
├── Agents Council (Multi-Agent)
│ ├── Qwen Code Agent
│ ├── Claude Code Agent
│ └── Codex Agent
│
├── ClawWork (Economic Layer)
│ ├── GDP Tasks (220 tasks)
│ ├── Economic System
│ └── Dashboard
│
└── FULL RAG
├── Vector Store
├── Document Retrieval
└── Cross-Agent Context
Configuration
{
"mcpServers": {
"qwenclaw": { ... },
"council": { ... },
"clawwork": { ... }
},
"integration": {
"clawworkWithCouncil": true,
"sharedRAG": true,
"economicAwareness": true
}
}
Troubleshooting
Issue: "ClawWork server not found"
Solution:
# Install ClawWork
git clone https://github.com/HKUDS/ClawWork.git
cd ClawWork
pip install -r requirements.txt
Issue: "Insufficient balance"
Solution:
// Learn before working
await clawwork.learn('Professional skills for higher-value tasks');
// Or take lower-value tasks initially
const task = await clawwork.getTask({ minDifficulty: 'easy' });
Issue: "Dashboard not loading"
Solution:
# Check frontend dependencies
cd ClawWork/frontend
npm install
# Restart dashboard
./start_dashboard.sh
Resources
- ClawWork: https://github.com/HKUDS/ClawWork
- Benchmark: 5.6k stars, 682 forks
- Top Earnings: $1,500+/hr equivalent
- Demo: $10K earned in 7 hours
License
MIT License - See LICENSE file for details.
ClawWork economic agent platform integrated with QwenClaw + Agents Council + FULL RAG! 💼🤖