核心功能与用法
Agos Marketplace skill 提供了一套完整的自动化脚本工具,用于在 Agos 去中心化服务市场中创建采购订单。核心入口为 scripts/create_order.py 脚本,支持从环境变量 AGOS_API_BASE 读取目标端点(默认 https://market.agos.fun)。
主要执行路径:
1. 自动选单:省略 --listing-id 时自动获取并选择首个活跃服务列表
2. 订单创建:通过 POST /v1/openclaw/purchases 提交采购请求
3. 支付准备:可选 --prepare-payment 获取链上支付参数
4. 状态终局:可选 --wait 轮询至订单终态
关键参数映射:
脚本输出的 payment_preparation 字段直接对应 PaymentRouter.payForService() 合约调用参数,实现从订单创建到链上执行的无缝衔接。
显著优点
- 高度自动化:单条命令完成选单、下单、支付准备全流程
- 链上就绪:自动输出合约调用所需的 hex 编码参数和原子金额
- 灵活轮询:支持自定义超时(
--timeout-sec)与间隔(--interval-sec) - 环境可配置:通过
AGOS_API_BASE支持多环境部署
潜在局限
- 需外部签名:仅生成支付参数,实际链上转账需独立钱包/签名者执行
- 单链限制:默认锁定 BNB Chain(chainId=56),未显式支持多链切换
- 错误粒度:400/404 错误直接透传,缺乏业务层重试或降级策略
- 列表依赖:无活跃列表时流程中断,需前置卖家注册
适合人群
- 需要程序化采购 AI/计算服务的 dApp 开发者
- 构建自动化 agent 工作流的技术团队
- 熟悉 EVM 链交互的智能合约工程师
常规风险提示
- 私钥管理:
--buyer-wallet仅用于标识买家,实际支付需管控私钥的独立流程 - 原子金额精度:USDT 支付需注意 6 位小数转换,避免金额计算错误
- 网络延迟:
--wait轮询依赖节点同步状态,极端网络条件下可能误判终态