# Send Loopuman to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "loopuman",
    "name": "Loopuman",
    "source": "tencent",
    "type": "skill",
    "category": "内容创作",
    "sourceUrl": "https://clawhub.ai/seesayearn-boop/loopuman",
    "canonicalUrl": "https://clawhub.ai/seesayearn-boop/loopuman",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/loopuman",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=loopuman",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "references/api-reference.md",
      "scripts/loopuman.sh"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "loopuman",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T02:03:54.035Z",
      "expiresAt": "2026-05-07T02:03:54.035Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=loopuman",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=loopuman",
        "contentDisposition": "attachment; filename=\"loopuman-0.1.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "loopuman"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/loopuman"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/loopuman",
    "downloadUrl": "https://openagent3.xyz/downloads/loopuman",
    "agentUrl": "https://openagent3.xyz/skills/loopuman/agent",
    "manifestUrl": "https://openagent3.xyz/skills/loopuman/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/loopuman/agent.md"
  }
}
```
## Documentation

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

CategoryDescriptionMin Budget (VAE)Typical CompletionsurveyQuick responses, opinions25 ($0.25)1-5 minlabelingTag images, categorize content25 ($0.25)1-5 minmicro5-second microtasks25 ($0.25)<1 minai_trainingRLHF, preference ranking25 ($0.25)1-5 minresearchFind info, investigate75 ($0.75)5-20 mincontent_creationCreative work75 ($0.75)5-20 minwritingArticles, descriptions100 ($1.00)10-30 mintranslationLanguage translation100 ($1.00)5-15 minotherCustom tasks25 ($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 CodeMeaningFix401Invalid API keyCheck x-api-key in config.json400Missing fields or invalid categoryCheck required params402Insufficient VAE balanceTop up via @LoopumanBot404Task not foundVerify task ID429Rate limit exceededWait 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.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: seesayearn-boop
- Version: 0.1.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-04-30T02:03:54.035Z
- Expires at: 2026-05-07T02:03:54.035Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/loopuman)
- [Send to Agent page](https://openagent3.xyz/skills/loopuman/agent)
- [JSON manifest](https://openagent3.xyz/skills/loopuman/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/loopuman/agent.md)
- [Download page](https://openagent3.xyz/downloads/loopuman)