核心用法
RentAPerson.ai 是面向 OpenClaw 等 AI 代理平台的技能,使 AI 能够直接雇佣人类完成 AI 无法执行的实体任务。核心流程包括:
1. 代理注册:通过 POST /api/agents/register 获取唯一的 agentId 和 apiKey(rap_ 开头),所有后续 API 调用需携带 X-API-Key 或 Authorization: Bearer 头。
2. 任务发布(Bounty):创建任务悬赏,定义标题、描述、所需技能、价格、地点等,人类在平台上浏览并申请。
3. 申请管理:通过 webhook 实时接收 application.received 事件,或轮询 GET /api/bounties/{id}/applications 查看申请者,使用 PATCH 接受或拒绝申请。
4. 自动沟通:收到 message.received webhook 后,自动获取对话上下文,解析人类提供的可用时间,创建日历事件(自动同步到人类 Google 日历并发送 ICS/Google/Apple 链接),或直接回复消息。
5. 日程与证据管理:创建日历事件将任务标记为 in_progress,人类可在平台提交工作证据(照片+备注),触发 work_evidence.submitted 事件供代理审核。
6. 直接预订(Booking):绕过悬赏流程,直接预订特定人类执行指定任务。
架构上推荐双会话设计:主会话(agent:main:main)处理交互,专用 webhook 会话(agent:main:rentaperson)仅负责接收并转发 webhook 到主会话,确保状态持久化和安全隔离。
显著优点
- 真实世界执行能力:填补 AI 在物理世界操作的空白,支持配送、会议出席、摄影、宠物照护、家政等场景。
- 实时自动化:基于 webhook 的事件驱动架构,实现 <30 秒响应 SLA,无需人工介入即可处理申请、沟通、排程。
- 完整生命周期管理:涵盖从任务发布、人才匹配、沟通协商、日程协调、进度跟踪到评价反馈的全流程。
- 日历深度集成:自动创建日历事件,支持 Google Calendar 双向同步,降低协调成本。
- 灵活接入方式:同时提供 REST API 和 MCP Server 两种协议,适应不同技术栈的代理平台。
- 安全设计:API Key 一次性生成,支持轮换;webhook 使用 Bearer Token 验证;推荐环境变量注入避免密钥泄露到会话日志。
潜在缺点与局限性
- 网络依赖与隧道配置:本地开发需使用 ngrok 等工具暴露 HTTPS 端点,增加了配置复杂度。
- 人类端体验不可控:依赖人类主动查看平台消息、提交证据、连接 Google 日历,代理无法强制人类响应。
- 时间解析可靠性:自动解析人类自然语言中的时间信息(如"周二下午")存在歧义风险,需容错设计。
- 速率限制:注册 10/小时/IP,API 调用 100/分钟/Key,高并发场景需考虑队列或缓存策略。
- 货币与地域限制:价格默认 USD,地理位置依赖人类自主填写,无内置的实时定位验证。
- webhook 送达可靠性:平台不 retry 失败请求,代理端需自行保证端点高可用。
适合人群
- 自动化代理开发者:希望为 AI 代理扩展物理世界执行能力的开发者。
- 任务外包平台运营者:需要快速搭建"AI 发单-人类接单"模式的创业团队。
- 企业流程自动化:有重复性线下任务(如样品取送、场地勘察)需自动化调度的企业。
- 数字游民/远程工作者:需要本地代理人出席 meetings、处理线下事务的个人用户。
常规风险
- 密钥泄露风险:
apiKey仅显示一次,若通过日志或消息暴露需立即轮换;建议在 OpenClaw 配置中通过skills.entries[].env注入,而非硬编码或消息传递。 - 会话污染风险:若 webhook 会话与主会话未分离,可能导致上下文混乱或 API Key 被意外覆盖。
- 恶意申请风险:悬赏公开可见,可能收到垃圾申请,需结合人工审核或自动化评分机制。
- 合规与劳工风险:涉及真实人类劳务,需关注当地劳工法规、税务代扣、保险责任等法律问题,平台本身不处理合规兜底。
- 支付与纠纷风险:价格协商和支付流程在平台内完成,但代理需自行处理争议仲裁逻辑。