Loopuman

Route tasks needing real human judgment, local knowledge, or cultural insight to verified workers paid via cUSD on Celo, for verification, translation, moder...

Loopuman — The Human Layer for AI

Route tasks to verified human workers when AI alone isn't enough. Workers are paid in 8 seconds via cUSD on Celo blockchain. No app download required — workers operate via Telegram and WhatsApp.

When to Use This Skill

Use Loopuman when the task requires real human judgment, perception, or local knowledge that AI cannot reliably provide:

• Verification — "Is this business address real?" "Does this photo match this listing?"
• Translation — Nuanced, culturally-aware translation (not just word-for-word)
• Content moderation — "Is this image appropriate?" "Does this review violate guidelines?"
• Image labeling — "What objects are in this photo?" "Rate this image quality 1-10"
• Local knowledge — "What's the current price of tomatoes in Nairobi?"
• Surveys & opinions — "Which logo design is better?" "Rate this product description"
• Data collection — "Find the phone number for this restaurant"
• Quality assurance — "Does this AI-generated text sound natural?"

Do NOT use for tasks AI can handle: math, code generation, summarization, web search, file operations.

Setup

Create the config file with your Loopuman API key:

mkdir -p ~/.openclaw/skills/loopuman
cat > ~/.openclaw/skills/loopuman/config.json << 'EOF'
{
  "apiKey": "YOUR_API_KEY",
  "apiUrl": "https://api.loopuman.com"
}
EOF

Get your API key (one command, no auth needed):

curl -X POST https://api.loopuman.com/api/v1/register \
  -H "Content-Type: application/json" \
  -d '{"email": "[e-mail]", "company_name": "Your Name", "promo_code": "LOBSTER"}'

This returns your api_key (starts with lpm_). Save it immediately — it cannot be retrieved later.

Promo codes for free credits:

• CLAW500 — 500 VAE ($5.00) for first 10 OpenClaw testers
• LOBSTER — 100 VAE ($1.00) for early access (50 spots)
• No code — 25 VAE ($0.25) welcome bonus

To add more funds, message @LoopumanBot on Telegram and link your account.

API Authentication

All requests use the x-api-key header:

x-api-key: YOUR_API_KEY

Creating a Task

scripts/loopuman.sh create \
  --title "Verify business address" \
  --description "Check if this address exists on Google Maps: 123 Main St, Nairobi, Kenya. Reply with YES/NO and a screenshot." \
  --category other \
  --budget 50 \
  --estimated-seconds 120

Parameters:

• --title — Short task title (required)
• --description — Detailed instructions for the human worker (required, be specific!)
• --category — One of: survey, labeling, translation, writing, research, content_creation, ai_training, micro, other (default: other). Note: for verification tasks use other, for moderation use other, for data collection use research.
• --budget — Payment in VAE tokens. 100 VAE = $1 USD. (default: 100)
• --estimated-seconds — Expected time for worker to complete (required for fair pay calculation, default: 120)
• --max-workers — Number of workers (default: 1, max: 100)
• --priority — normal or high (high notifies workers immediately)
• --webhook — URL for push notifications on completion

Category minimum budgets:

• survey, labeling, ai_training, micro: 25 VAE ($0.25)
• research, content_creation: 75 VAE ($0.75)
• writing, translation: 100 VAE ($1.00)

Fair pay enforcement: Loopuman enforces a $6/hr minimum effective rate. If your budget divided by estimated time is below this, the API will suggest a higher budget.

Writing good task descriptions:

• Be specific about what you need ("Reply YES or NO" not "verify this")
• Include all context the worker needs
• Specify the expected format of the response
• Set clear success criteria

Checking Task Status + Getting Results

scripts/loopuman.sh status --task-id <TASK_ID>

Returns full task details including:

• status: active, completed, expired, cancelled
• progress: count of approved, pending_review, in_progress submissions
• submissions: array of approved worker results with content
• pending_submissions: results awaiting your approval

Polling for Completion

For tasks that need a result before continuing:

# Poll every 30 seconds, timeout after 10 minutes
scripts/loopuman.sh wait --task-id <TASK_ID> --interval 30 --timeout 600

Returns the result as soon as an approved submission is available.

Listing Tasks

scripts/loopuman.sh list

Cancelling a Task

scripts/loopuman.sh cancel --task-id <TASK_ID>

Refunds your balance if no workers have started.

Task Types and Pricing

Category	Description	Min Budget (VAE)	Typical Completion
survey	Quick responses, opinions	25 ($0.25)	1-5 min
labeling	Tag images, categorize content	25 ($0.25)	1-5 min
micro	5-second microtasks	25 ($0.25)	<1 min
ai_training	RLHF, preference ranking	25 ($0.25)	1-5 min
research	Find info, investigate	75 ($0.75)	5-20 min
content_creation	Creative work	75 ($0.75)	5-20 min
writing	Articles, descriptions	100 ($1.00)	10-30 min
translation	Language translation	100 ($1.00)	5-15 min
other	Custom tasks	25 ($0.25)	Varies

Examples

Verify an address: "Create a Loopuman task to verify if '456 Kenyatta Ave, Nairobi' is a real business address" → create --title "Verify address" --description "Check Google Maps for 456 Kenyatta Ave, Nairobi. Reply YES/NO with screenshot." --category other --budget 30 --estimated-seconds 120

Translate with cultural context: "Use Loopuman to translate 'We're excited to launch' into Swahili naturally" → create --title "Translate to Swahili" --description "Translate to Swahili. Make it sound natural, not robotic: 'We're excited to launch our new product'" --category translation --budget 100 --estimated-seconds 180

Get a human opinion: "Ask a real person which logo looks more professional" → create --title "Logo comparison" --description "Which logo looks more professional? A or B? Explain why in 2 sentences." --category survey --budget 25 --estimated-seconds 60

Check AI output: "Have a human verify this AI-generated product description" → create --title "QA check on AI text" --description "Does this sound natural and accurate? Flag any issues: [paste text]" --category other --budget 30 --estimated-seconds 90

Error Handling

HTTP Code	Meaning	Fix
401	Invalid API key	Check x-api-key in config.json
400	Missing fields or invalid category	Check required params
402	Insufficient VAE balance	Top up via @LoopumanBot
404	Task not found	Verify task ID
429	Rate limit exceeded	Wait and retry

Links

• Website: https://loopuman.com
• Telegram Bot: https://t.me/LoopumanBot
• ERC-8004 Agent: https://www.8004scan.io/agents/celo/17
• MCP: https://api.loopuman.com/.well-known/mcp.json
• A2A: https://api.loopuman.com/.well-known/agent-card.json

⚠️ Budget Safety: Tasks are paid to workers upon completion. Start with small budgets (25-50 VAE) when testing. Loopuman charges 20% commission on top of the budget you set.