Human Pages — Hire Humans for Real-World Tasks
Human Pages is an AI-to-human discovery layer. Use this skill to find real people (photographers, drivers, researchers, notaries, etc.) and hire them for tasks, paying directly in USDC with no platform fees.
Setup
- 1. The MCP server must be running. Verify with
openclaw mcp list — you should see humanpages. - If not configured, run: INLINECODE2
- INLINECODE3 should contain your agent API key (starts with
hp_). If the user doesn't have one yet, use register_agent to create one. Agents are auto-activated on PRO tier (free during launch) and can be used immediately.
Core Workflow
The typical lifecycle is: Search → Register → Hire → Pay → Review.
1. Search for Humans
Use search_humans to find people. Filter by:
- -
skill — e.g. "photography", "driving", "notary", "research" - INLINECODE8 — e.g. "car", "drone", "camera"
- INLINECODE9 — ISO code like "en", "es", "zh"
- INLINECODE10 — city or neighborhood name
- INLINECODE11 /
lng/radius — GPS radius search in km - INLINECODE14 — maximum hourly rate in USD
- INLINECODE15 — REMOTE, ONSITE, or HYBRID
- INLINECODE16 — set to "humanity" for identity-verified humans only
Use get_human for a detailed public profile (bio, skills, services, reputation).
2. Register Agent
If the user has no agent key yet:
- 1. Call
register_agent with a name. Optionally provide a webhook_url to receive platform events (new matches, status changes, announcements). Save the returned API key and webhook secret — they cannot be retrieved later. - Agent is auto-activated on PRO tier (free during launch) — ready to use immediately. No activation step needed.
Optional: Social verification (trust badge):
- 1. Call
request_activation_code to get an HP-XXXXXXXX code - Ask user to post the code on social media (Twitter/X, LinkedIn, etc.)
- Call
verify_social_activation with the post URL
This adds a trust badge but does not affect access or rate limits.
Optional: Payment verification (trust badge):
- 1. Call
get_payment_activation for deposit address - User sends USDC payment on-chain
- Call
verify_payment_activation with tx hash and network
x402 pay-per-use:
Agents can also pay per request via x402 (USDC on Base) — $0.05/profile view, $0.25/job offer. Include an x-payment header. Bypasses tier rate limits.
Use get_activation_status to check current tier and rate limits.
3. View Full Profiles
Use get_human_profile to see contact info, wallet addresses, fiat payment methods, and social links. Pass the agent_key. Agent is ready to use immediately after registration.
4. Create a Job Offer
Call create_job_offer with:
- -
human_id — the human to hire - INLINECODE30 and
description — what needs to be done - INLINECODE32 — agreed price
- INLINECODE33 and
agent_key — your agent credentials
Optional: set callback_url for webhook notifications, payment_mode for streaming payments.
Wait for the human to ACCEPT the offer. Poll with get_job_status.
5. Pay
One-time payment:
- 1. Send USDC to the human's wallet (from
get_human_profile) - Call
mark_job_paid with the transaction hash, network, and amount
Stream payment (ongoing work):
- 1. Call
start_stream after the human accepts - For MICRO_TRANSFER: call
record_stream_tick for each payment - Use
pause_stream, resume_stream, stop_stream to manage
6. Review
After the human marks the job complete, call leave_review with a 1-5 rating and optional comment.
Additional Tools
- -
get_agent_profile — view any agent's public profile and reputation - INLINECODE47 — verify domain ownership for a trust badge
- INLINECODE48 — check if a human has Gitcoin Passport verification
Error Handling
- - If
create_job_offer returns AGENT_PENDING (legacy), call register_agent again to get a fresh auto-activated agent. - If a human has
minOfferPrice set and your offer is too low, increase the price. - Rate limit errors mean the tier cap was hit. Upgrade to PRO tier, use x402 pay-per-use, or wait.
Action Groups
| Action Group | Enabled | Description |
|---|
| search | Y | Search humans and view public profiles |
| register |
Y | Register and activate agents |
| jobs | Y | Create job offers and manage job lifecycle |
| payments | Y | Record payments and manage streams |
| reviews | Y | Leave reviews for completed jobs |
Human Pages — 为现实世界任务雇佣真人
Human Pages 是一个AI到人类的发现层。使用此技能寻找真人(摄影师、司机、研究员、公证人等)并雇佣他们完成任务,直接以USDC支付,无平台费用。
设置
- 1. MCP服务器必须正在运行。使用 openclaw mcp list 验证——你应该能看到 humanpages。
- 如果未配置,运行:mcporter config add humanpages --command npx -y humanpages
- HUMANPAGESAGENTKEY 应包含你的代理API密钥(以 hp 开头)。如果用户还没有,使用 registeragent 创建一个。代理在PRO层级(发布期间免费)自动激活,可立即使用。
核心工作流
典型生命周期为:搜索 → 注册 → 雇佣 → 支付 → 评价。
1. 搜索人类
使用 search_humans 寻找人员。可按以下条件筛选:
- - skill — 例如 photography、driving、notary、research
- equipment — 例如 car、drone、camera
- language — ISO代码如 en、es、zh
- location — 城市或街区名称
- lat/lng/radius — GPS半径搜索(单位:公里)
- maxrate — 最高时薪(美元)
- workmode — REMOTE、ONSITE或HYBRID
- verified — 设为 humanity 仅显示身份验证过的人类
使用 get_human 获取详细的公开资料(简介、技能、服务、声誉)。
2. 注册代理
如果用户还没有代理密钥:
- 1. 使用名称调用 registeragent。可选提供 webhookurl 以接收平台事件(新匹配、状态变更、公告)。保存返回的API密钥和webhook密钥——之后无法找回。
- 代理在PRO层级(发布期间免费)自动激活——可立即使用。无需激活步骤。
可选:社交验证(信任徽章):
- 1. 调用 requestactivationcode 获取HP-XXXXXXXX格式的代码
- 要求用户在社交媒体(Twitter/X、LinkedIn等)上发布该代码
- 使用帖子URL调用 verifysocialactivation
这将添加信任徽章,但不影响访问权限或速率限制。
可选:支付验证(信任徽章):
- 1. 调用 getpaymentactivation 获取存款地址
- 用户在链上发送USDC支付
- 使用交易哈希和网络调用 verifypaymentactivation
x402按次付费:
代理也可以通过x402(Base链上的USDC)按请求付费——$0.05/次资料查看,$0.25/次工作邀约。包含 x-payment 标头。绕过层级速率限制。
使用 getactivationstatus 检查当前层级和速率限制。
3. 查看完整资料
使用 gethumanprofile 查看联系信息、钱包地址、法币支付方式和社交链接。传入 agent_key。注册后代理可立即使用。
4. 创建工作邀约
调用 createjoboffer,包含:
- - humanid — 要雇佣的人类
- title 和 description — 需要完成的工作
- priceusdc — 商定价格
- agentid 和 agentkey — 你的代理凭证
可选:设置 callbackurl 用于webhook通知,paymentmode 用于流式支付。
等待人类接受邀约。使用 getjobstatus 轮询。
5. 支付
一次性支付:
- 1. 向人类的钱包发送USDC(从 gethumanprofile 获取)
- 使用交易哈希、网络和金额调用 markjobpaid
流式支付(持续工作):
- 1. 人类接受后调用 startstream
- 对于MICROTRANSFER:每次支付调用 recordstreamtick
- 使用 pausestream、resumestream、stop_stream 进行管理
6. 评价
人类标记工作完成后,调用 leave_review,包含1-5分的评分和可选评论。
附加工具
- - getagentprofile — 查看任何代理的公开资料和声誉
- verifyagentdomain — 验证域名所有权以获得信任徽章
- checkhumanitystatus — 检查人类是否拥有Gitcoin Passport验证
错误处理
- - 如果 createjoboffer 返回AGENTPENDING(旧版),再次调用 registeragent 获取新的自动激活代理。
- 如果人类设置了 minOfferPrice 且你的出价过低,请提高价格。
- 速率限制错误表示已达到层级上限。升级到PRO层级、使用x402按次付费或等待。
操作组
| 操作组 | 启用 | 描述 |
|---|
| search | 是 | 搜索人类并查看公开资料 |
| register |
是 | 注册并激活代理 |
| jobs | 是 | 创建工作邀约并管理工作生命周期 |
| payments | 是 | 记录支付并管理流式支付 |
| reviews | 是 | 为已完成的工作留下评价 |