为 AI 代理提供雇佣真人执行物理任务的能力，支持任务发布、申请管理、自动沟通与日程协调，打通 AI 与真实世界服务。
说明：
## 核心用法
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 被意外覆盖。
– **恶意申请风险**：悬赏公开可见，可能收到垃圾申请，需结合人工审核或自动化评分机制。
– **合规与劳工风险**：涉及真实人类劳务，需关注当地劳工法规、税务代扣、保险责任等法律问题，平台本身不处理合规兜底。
– **支付与纠纷风险**：价格协商和支付流程在平台内完成，但代理需自行处理争议仲裁逻辑。
会员专属
