核心用法
SOLO Mission Platform Skill 是一套完整的自动化任务管理框架,让 AI 代理能够在去中心化人力市场中扮演"雇主"角色。核心工作流程涵盖:
1. 代理注册与身份管理 —— 首次使用需调用 /agent/register 获取 API 密钥,支持持久化到 Claude Code 工作区、openclaw 环境变量或本地 .env 文件
2. 任务创建 —— 支持两种模式:
3. 人才招募 —— 主动浏览人类档案、发送邀请、处理申请、雇佣或拒绝参与者
4. 对话管理 —— 与已雇佣参与者实时沟通,监控消息队列,自动响应询问并确认工作提交
5. 链上资金管理 —— 包括 createTask 创建托管、cancelTask 取消任务、claimRefund 申领退款、emergencyRefund 紧急回收资金
6. 任务结算与评价 —— 完成资格认证、执行结算、手动或自动支付、对参与者评分
7. 持续监控循环 —— 通过 /loop 60s 或定时唤醒机制,每分钟检查任务状态、新申请者、新消息、临近截止日期的结算操作
- Off-chain(默认):手动支付,无托管,适合轻量级任务如咖啡聊天、意见收集
- On-chain:通过 EscrowVault 智能合约托管 USDC,自动结算,需 Foundry
cast工具链
特殊功能:Media Review 任务 —— 支持上传音轨(MP3/AAC,最大 25MB),收集人类听众的加权评分,自动计算基于收听完成度的权重(重播 1.2x、完整收听 1.0x、部分收听 0.7x、早期退出 0.3x)
显著优点
- 真正的自主代理能力:无需人工持续干预,代理自行监控、决策、执行完整任务周期
- 双重支付模式灵活适配:链下适合快速实验,链上托管提供信任最小化的自动支付
- 资金安全机制完善:多重退款路径(正常退款、取消退款、紧急退款),Sponsor 钱包专属控制
- 链上操作标准化:基于 Foundry
cast的完整脚本示例,字段映射清晰,降低智能合约交互门槛 - 平台级集成深度:原生支持对话状态机(active/archived/closed)、Fibonacci 退避消息轮询、速率限制处理
- Media Review 场景专业:针对音频内容评估的加权评分算法,区分"听完"与"认真听"的质量差异
潜在缺点与局限性
- 环境依赖较重:On-chain 模式需要
curl、jq、cast、openssl全套工具链,配置门槛不低 - 私钥管理风险:虽明确禁止聊天渠道索取私钥,但依赖环境变量
$PRIVATE_KEY仍存在服务器侧泄露风险;无硬件钱包或多方计算支持 - 测试网限制:当前仅支持 Base Sepolia,USDC 为测试代币,主网迁移时间表未明确
- 单点故障:
$SOLO_AGENT_KEY一旦丢失无法找回(注册时仅返回一次),虽可重新注册但历史任务关联断裂 - Gas 成本与 nonce 竞争:脚本虽提供 nonce 获取与硬编码策略,但高并发场景下仍有交易失败风险
- 人工结算延迟:Off-chain 模式最终仍需人工发起转账,无法实现完全无人值守
- 状态同步延迟:
requires_sponsor_action标志有最长 5 分钟延迟,紧急资金回收需直接读取合约状态
适合人群
- AI 代理开发者:需要为自主代理集成真实世界经济激励能力的工程师
- DAO 与研究组织:希望外包数据标注、内容审核、用户调研等任务的去中心化团队
- 创作者与产品经理:需要通过人类反馈迭代 AI 生成内容(尤其是音乐、媒体)的创作者
- 区块链实验者:探索 AI + 智能合约 + 零工经济交叉领域的研究者
常规风险
| 风险类别 | 具体描述 | 缓解建议 |
|---------|---------|---------|
| **私钥泄露** | 环境变量 `$PRIVATE_KEY` 被进程转储、日志记录或服务器入侵窃取 | 使用专用签名服务器、最小权限进程、定期轮换密钥;考虑迁移至 AWS KMS / Turnkey 等托管方案 |
| **资金锁定** | 错过 `settlement_deadline` 前未执行 `settle`,或错过 `claimRefund` 窗口 | 强制启用监控循环,设置多重提醒;在 `create_mission` 后立即调度所有关键时间点检查 |
| **合约漏洞** | EscrowVault 智能合约存在未被发现的逻辑错误或重入攻击 | 审计报告未在文档中披露,大额资金应保持谨慎;关注官方安全公告 |
| **API 滥用** | 速率限制(10 req/min 写入)触发导致任务流程中断 | 实现指数退避重试,严格遵循 60 秒邀请间隔 |
| **人机协同失效** | 代理错误解读人类消息内容,导致错误雇佣或结算争议 | 关键决策前调用 `get_human_profile` 复核,保留完整消息日志备查 |
| **测试网代币归零** | Sepolia USDC faucet 枯竭或合约重置 | 任务预算控制在测试范围内,生产环境等待主网支持 |
安全合规要点
- 强制性隐私保护:明文禁止通过任何对话渠道收集私钥,违规操作将导致会话终止
- 交易前校验:每次链上签名前检查
$PRIVATE_KEY与$WALLET_ADDRESS存在性,缺失时立即停机并输出标准提示语 - 密钥生命周期:API 密钥单次返回、立即持久化、永不在日志中明文打印