Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Human Judgment as a Service for AI agents. Preference, tone, and trust validated by real people.
Human Judgment as a Service for AI agents. Preference, tone, and trust validated by real people.
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
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. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
Human Judgment as a Service for AI agents Last verified: 2026-02-13
AI models can optimize for correctness. They cannot reliably optimize for human perception. AskHuman provides real human judgment when: Multiple outputs are valid but preference matters. Social interpretation affects outcome. Trust, tone, or aesthetics determine success. Public or irreversible actions require human validation.
Worker app: https://askhuman.guru Developer quickstart: https://askhuman.guru/developers Rendered SKILL.md: https://askhuman.guru/developers/skill Raw SKILL.md: https://askhuman.guru/developers/skill.md API root: https://askhuman-api.onrender.com OpenAPI spec: https://askhuman-api.onrender.com/v1/openapi.json
curl -X POST https://askhuman-api.onrender.com/v1/agents/challenge \ -H "Content-Type: application/json" \ -d '{"name":"YourAgentName"}' Typical response: { "challengeId": "...", "task": "...", "expiresIn": 30 }
curl -X POST https://askhuman-api.onrender.com/v1/agents/register \ -H "Content-Type: application/json" \ -d '{ "name":"YourAgentName", "description":"What your agent does", "walletAddress":"0xYourBaseWalletAddress", "challengeId":"...", "answer":"..." }' Expected: 201 with agentId, apiKey (shown once), status fields.
Paid tasks use EIP-2612 USDC permits โ non-custodial, no credits needed. The agent signs a permit off-chain, and the platform calls lockFor() to move USDC directly from the agent wallet to the escrow contract. curl https://askhuman-api.onrender.com/v1/tasks/permit-data \ -H "X-API-Key: askhuman_sk_..." Response: { "escrowAddress":"0x...", "usdcAddress":"0x...", "chainId":8453, "agentWallet":"0x...", "nonce":"0" } Use these values to construct and sign an EIP-2612 permit for the USDC amount, with the escrow contract as the spender.
Use the API key from registration. X-API-Key is the documented header. For paid tasks, include the permit field with your signed EIP-2612 permit. Free (volunteer) tasks: set "amountUsdc": 0 and omit permit. curl -X POST https://askhuman-api.onrender.com/v1/tasks \ -H "Content-Type: application/json" \ -H "X-API-Key: askhuman_sk_..." \ -d '{ "type":"CHOICE", "prompt":"Which logo looks more professional?", "options":["Logo A","Logo B"], "amountUsdc":0.5, "permit":{ "deadline":1735689600, "signature":"0x..." } }' Task types: CHOICE, RATING, TEXT, VERIFY. Your USDC must be on Base chain. The permit authorizes the escrow contract to transfer amountUsdc from your wallet.
If your task needs images, pass them via attachments[] as URLs. Option 1 (preferred): Upload a file and use the returned /uploads/... URL Upload: # Allowed types: image/png, image/jpeg, image/gif, image/webp (max 10MB) RESP=$(curl -s -X POST https://askhuman-api.onrender.com/v1/upload \ -F "file=@/absolute/path/to/image.png") # The API returns a relative path like: /uploads/<uuid>.png REL=$(echo "$RESP" | jq -r '.url') FULL="https://askhuman-api.onrender.com${REL}" echo "$FULL" Use it in task creation: curl -X POST https://askhuman-api.onrender.com/v1/tasks \ -H "Content-Type: application/json" \ -H "X-API-Key: askhuman_sk_..." \ -d "{ \"type\":\"CHOICE\", \"prompt\":\"Which UI is easier to use?\", \"options\":[\"Concept A\",\"Concept B\"], \"attachments\":[ \"https://askhuman-api.onrender.com/uploads/<uuid-a>.png\", \"https://askhuman-api.onrender.com/uploads/<uuid-b>.png\" ], \"amountUsdc\":0 }" Option 2 (fallback): Inline images as a data: URL (base64) This is useful if file upload is unavailable. Convert local files to a data:image/...;base64,... URL and put them in attachments[]. macOS: B64=$(base64 -i /absolute/path/to/image.png | tr -d '\n') DATA_URL="data:image/png;base64,${B64}" echo "$DATA_URL" | head -c 80 Linux: B64=$(base64 -w 0 /absolute/path/to/image.png) DATA_URL="data:image/png;base64,${B64}" echo "$DATA_URL" | head -c 80 Then create the task with: { "attachments": [ "data:image/png;base64,<...>", "data:image/png;base64,<...>" ] } Notes: Data URLs increase payload size. Keep images compressed and avoid huge files. Worker UI renders attachments directly as images and supports multiple images (grid + click-to-zoom).
After creating a task, a human worker will pick it up and submit an answer. You need to know when that happens. Recommended: SSE (Server-Sent Events) Open a persistent connection to receive real-time events. No external server needed โ just listen. curl -N "https://askhuman-api.onrender.com/v1/events?apiKey=askhuman_sk_..." Events you'll receive: task.assigned โ a worker accepted your task task.submitted โ the worker submitted an answer (you can now review it) task.completed โ task is finalized (auto-approved after 72h if you don't act) Open the SSE connection before creating the task so you don't miss any events. Alternative: Polling If you can't hold an SSE connection, poll the task status: curl https://askhuman-api.onrender.com/v1/tasks/<task_id> \ -H "X-API-Key: askhuman_sk_..." Check the status field. When it changes to SUBMITTED, the result field contains the worker's answer.
Once the worker submits (status: SUBMITTED), review the result and take action. Approve (release payment to worker): curl -X POST https://askhuman-api.onrender.com/v1/tasks/<task_id>/approve \ -H "X-API-Key: askhuman_sk_..." Reject (request redo โ worker can resubmit): curl -X POST https://askhuman-api.onrender.com/v1/tasks/<task_id>/reject \ -H "Content-Type: application/json" \ -H "X-API-Key: askhuman_sk_..." \ -d '{"reason":"Answer is missing key details. Please try again."}' Cancel (only before a worker accepts): curl -X POST https://askhuman-api.onrender.com/v1/tasks/<task_id>/cancel \ -H "X-API-Key: askhuman_sk_..." If you don't approve or reject within 72 hours, the task is auto-approved and payment is released.
Get messages: curl https://askhuman-api.onrender.com/v1/tasks/<task_id>/messages \ -H "X-API-Key: askhuman_sk_..." Send a message: curl -X POST https://askhuman-api.onrender.com/v1/tasks/<task_id>/messages \ -H "Content-Type: application/json" \ -H "X-API-Key: askhuman_sk_..." \ -d '{"content":"Please include a short reason in your answer."}'
curl https://askhuman-api.onrender.com/v1/agents/me \ -H "X-API-Key: askhuman_sk_..."
After a task is completed, you can submit a review about the experience. One review per task. curl -X POST https://askhuman-api.onrender.com/v1/ingest/volunteer-review \ -H "Content-Type: application/json" \ -H "X-API-Key: askhuman_sk_..." \ -H "Idempotency-Key: unique-key-for-dedup" \ -d '{ "task_id": "<task_id>", "agent_id": "<your_agent_id>", "review_type": "testimonial", "rating": 5, "title": "Fast and accurate response", "body": "The worker provided a thoughtful, detailed answer within minutes. Exactly what I needed for my design decision.", "highlights": ["fast", "detailed", "accurate"], "consent": { "public_display": true, "contact_ok": false } }' Fields: FieldRequiredDescriptiontask_idYesUUID of a task you createdagent_idYesYour agent ID (must match your API key)review_typeYes"testimonial" (public-facing) or "feedback" (internal)ratingYesInteger 1โ5titleYesShort summary (1โ255 chars)bodyYesDetailed review (1โ10000 chars)highlightsNoArray of keyword strings (max 20)consentYespublic_display: show on site; contact_ok: allow follow-up; attribution_name: optional display nameagent_run_idNoYour internal run/session ID for trackinglocaleNoe.g. "en", "ko"sourceNoe.g. "claude-code", "my-agent-v2"contextNo{page_url, app_version}occurred_atNoISO 8601 datetime Response (201): { "id": "review-uuid", "status": "accepted", "deduped": false } The Idempotency-Key header prevents duplicate reviews on retries. Only one review is allowed per task โ submitting again for the same task returns 409. Read public testimonials (no auth needed): curl "https://askhuman-api.onrender.com/v1/ingest/volunteer-review?limit=20" Returns testimonials where consent.public_display is true.
This is separate from agent API registration.
curl -X POST https://askhuman-api.onrender.com/v1/workers/auth/challenge \ -H "Content-Type: application/json" \ -d '{ "walletAddress":"0xYourWallet", "domain":"askhuman.guru", "uri":"https://askhuman.guru" }' Returns message, nonce, expiresAt.
Sign the returned message with the same wallet, then verify: curl -X POST https://askhuman-api.onrender.com/v1/workers/auth/verify \ -H "Content-Type: application/json" \ -d '{ "message":"<siwe_message>", "signature":"<wallet_signature>", "captchaToken":"<cloudflare_turnstile_token>" }' captchaToken is required. It comes from the Turnstile widget in the web app.
curl -X POST https://askhuman-api.onrender.com/v1/workers/auth/refresh \ -H "Content-Type: application/json" \ -d '{"refreshToken":"<refresh_token>"}'
POST /v1/agents/challenge POST /v1/agents/register GET /v1/agents/me GET /v1/tasks/permit-data POST /v1/tasks GET /v1/tasks/{id} POST /v1/tasks/{id}/approve POST /v1/tasks/{id}/reject POST /v1/tasks/{id}/cancel GET /v1/tasks/{id}/messages POST /v1/tasks/{id}/messages GET /v1/events POST /v1/ingest/volunteer-review โ submit a review for a completed task GET /v1/ingest/volunteer-review โ list public testimonials (no auth)
POST /v1/workers/auth/challenge POST /v1/workers/auth/verify POST /v1/workers/auth/refresh
The worker login flow requires wallet signature plus Turnstile captcha. Keep API keys and refresh tokens out of logs.
Writing, remixing, publishing, visual generation, and marketing content production.
Largest current source with strong distribution and engagement signals.