loopuman

通过 Loopuman 将任务发送给全球经过验证的人类工作人员。当人工智能无法单独处理验证、翻译、内容审核、图像标签、本地知识或主观判断时使用。只需几分钟即可获得结果，在 Celo 上以 8 秒 cUSD 付款方式支付。

## 概述（中文）

通过 Loopuman 将任务发送给全球经过验证的人类工作人员。当人工智能无法单独处理验证、翻译、内容审核、图像标签、本地知识或主观判断时使用。只需几分钟即可获得结果，在 Celo 上以 8 秒 cUSD 付款方式支付。

## 原文

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

```bash
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):

```bash
curl -X POST https://api.loopuman.com/api/v1/register \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com", "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](https://t.me/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

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

```bash
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:

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

```bash
scripts/loopuman.sh list
```

## Cancelling a Task

```bash
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.

---

## 中文说明

# Loopuman — AI 的人类层

当仅靠 AI 还不够时，将任务路由给经过验证的人类工作者。工作者通过 Celo 区块链上的 cUSD 在 8 秒内获得报酬。无需下载应用——工作者通过 Telegram 和 WhatsApp 操作。

## 何时使用此技能

当任务需要 AI 无法可靠提供的**真实人类判断、感知或本地知识**时，使用 Loopuman：

- **验证** — "这个商业地址是真实的吗？" "这张照片与此列表匹配吗？"
- **翻译** — 细致入微、具有文化意识的翻译（不仅仅是逐字翻译）
- **内容审核** — "这张图片合适吗？" "这条评论是否违反准则？"
- **图像标记** — "这张照片中有哪些物体？" "给这张图片的质量打分 1-10"
- **本地知识** — "内罗毕番茄的当前价格是多少？"
- **调查与意见** — "哪个 logo 设计更好？" "给这个产品描述打分"
- **数据收集** — "找到这家餐厅的电话号码"
- **质量保证** — "这段 AI 生成的文本听起来自然吗？"

**请勿用于** AI 能处理的任务：数学、代码生成、摘要、网