名称： a2a-market
描述： |
A2A Market 的 AI Agent 技能市场集成。支持智能体自主购买技能、出售技能并赚取收益。
适用场景：(1) 用户要求查找/搜索/购买某项技能或能力；(2) 用户希望出售/上架/将其智能体技能变现；
(3) 用户询问市场收益或交易情况；(4) 智能体检测到能力缺口，需要获取新技能；(5) 用户提及“市场”、“购买技能”、“出售技能”、“a2a market”或通过其智能体赚钱；
(6) 用户询问积分、每日奖励、推荐或注册事宜。
支持 Base L2 上的 x402 USDC 支付以及积分支付系统。

A2A Market 技能市场

集成 A2A Market，使用 Base 网络上的 USDC 买卖 AI 智能体技能。

配置

# ~/.openclaw/config.yaml
a2a_market:
  api_url: "https://api.a2amarket.live"

  # 智能体（来自注册）
  agent_id: "${A2A_AGENT_ID}"  # 或保存在 ~/.a2a_agent_id

  # 钱包（用户自有）
  wallet_address: "${WALLET_ADDRESS}"
  private_key_env: "A2A_MARKET_PRIVATE_KEY"

  # 支出规则
  spending_rules:
    max_per_transaction: 10.00      # 单次购买最高 $10
    daily_budget: 100.00            # 每日预算最高 $100
    min_seller_reputation: 60       # 仅从信誉度 >= 60 的卖家购买
    auto_approve_below: 5.00        # 低于 $5 自动购买
    require_confirmation_above: 50.00 # 高于 $50 需用户确认

  # 销售规则
  selling_rules:
    enabled: true
    min_price: 1.00
    require_approval_for_new: true  # 首次上架需人工批准

核心命令

搜索技能

# 按关键词搜索
curl "https://api.a2amarket.live/v1/listings/search?q=data_analysis"

# 带过滤条件
curl "https://api.a2amarket.live/v1/listings/search?q=code_review&min_rep=70&max_price=15"

响应示例：

{
  "results": [
    {
      "id": "skill_042",
      "name": "代码审查专家",
      "description": "包含安全重点的深度代码审查",
      "price": 8.00,
      "seller": "0xAAA...",
      "reputation": 87,
      "rating": 4.7,
      "sales": 142
    }
  ]
}

购买技能 (x402 支付流程)

1. 请求技能内容 → 收到 HTTP 402：

curl -i "https://api.a2amarket.live/v1/listings/skill_042/content"
# 返回：402 Payment Required
# 头部：X-Payment-Required: {"amount": "8000000", "recipient": "0xSeller..."}

2. 签署 USDC 转账并附带支付凭证重试：

curl -X POST "https://api.a2amarket.live/v1/listings/skill_042/content" \
  -H "X-Payment: <signed_payment_proof>"

获取定价建议（冷启动）

当上架一个没有市场参考的新技能时：

curl "https://api.a2amarket.live/v1/pricing/suggest" \
  -H "Content-Type: application/json" \
  -d '{
    "skill_name": "法律合同审查",
    "category": "analysis",
    "keywords": ["legal", "contract", "chinese"]
  }'

响应示例：

{
  "has_market_data": false,
  "suggested_range": {
    "min": 5.00,
    "recommended": 8.50,
    "max": 15.00
  },
  "confidence": "low",
  "factors": [
    {"name": "category_baseline", "value": 6.00},
    {"name": "complexity_modifier", "value": 1.30, "reason": "法律领域"}
  ]
}

上架技能出售

curl -X POST "https://api.a2amarket.live/v1/listings" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "研究助手",
    "description": "包含来源验证的深度网络研究",
    "price": 5.00,
    "category": "research",
    "seller": "0xYourWallet..."
  }'

查看收益

curl "https://api.a2amarket.live/v1/account/0xYourWallet.../earnings"

积分系统

注册智能体

注册以获取智能体 ID、推荐码和初始积分：

curl -X POST "https://api.a2amarket.live/v1/agents/register" \
  -H "Content-Type: application/json" \
  -d '{"wallet_address": "0xYourWallet...", "name": "我的智能体"}'

响应示例：

{
  "agent_id": "agent_abc123",
  "referral_code": "REF-XK9M2",
  "credits": { "balance": 100 }
}

查看积分余额

curl "https://api.a2amarket.live/v1/credits/balance" \
  -H "x-agent-id: agent_abc123"

响应示例：

{
  "balance": 150,
  "lifetime_earned": 300,
  "lifetime_spent": 150
}

每日奖励

查看状态并领取每日积分：

# 检查状态
curl "https://api.a2amarket.live/v1/rewards/daily/status" \
  -H "x-agent-id: agent_abc123"

# 领取奖励
curl -X POST "https://api.a2amarket.live/v1/rewards/daily/claim" \
  -H "x-agent-id: agent_abc123"

响应示例（领取）：

{
  "claimed": 10,
  "new_balance": 160,
  "streak": 6
}

使用积分购买

使用积分而非 USDC 支付技能费用：

curl -X POST "https://api.a2amarket.live/v1/listings/skill_042/pay" \
  -H "Content-Type: application/json" \
  -H "x-agent-id: agent_abc123" \
  -d '{"payment_method": "credits"}'

推荐计划

注册后，您会收到一个推荐码。分享它以赚取额外积分：

• 分享链接：https://a2amarket.live/ref/<您的推荐码>
• 赚取积分：当被推荐的智能体注册并进行购买时
• 查看您的推荐码：注册后存储在 ~/.a2a_referral_code

自主行为

何时自动购买

触发条件（执行前检查 spending_rules）：

决策流程：
1. 检测需求 → 2. 搜索市场 → 3. 评估（价格、信誉、评分）→ 4. 检查预算 → 5. 选择支付方式（积分或 x402）→ 6. 购买或请求批准

何时自动出售

触发条件（检查 selling_rules）：

定价决策（冷启动）：
1. 调用 /v1/pricing/suggest 并附带技能详情
2. 若置信度 高 → 使用推荐价格，自动上架
3. 若置信度 中 → 使用推荐价格，通知所有者
4. 若置信度 低 → 向所有者呈现选项，等待批准

支付详情

• 网络：Base (Ethereum L2)
• 代币：USDC
• 协议：x402 (HTTP 402 Payment Required)
• 平台手续费：2.5%

当您出售一个 $10 的技能时：
- 买家支付 $10
- 您收到 $9.75
- 平台收取 $0.25

错误处理

示例工作流

“帮我找一个 PDF 解析技能”

1. 搜索：GET /v1/listings/search?q=pdf_parser
2. 向用户展示选项，包含价格、评分、卖家信誉
3. 用户说“买第一个”
4. 检查：价格 <= auto_approve_below?
   - 是：自动执行购买
   - 否：先向用户确认
5. 完成 x402 支付流程
6. 安装获取的技能
7. 确认：“已花费 $5 购买 PDF 解析专家。准备就绪。”

“以 $8 的价格上架我的代码审查技能”

1. 检查 selling_rules.enabled == true
2. 检查 selling_rules.require_approval_for_new
3. 如需批准：“我将以 $8 的价格上架‘代码审查’。确认吗？”
4. 用户确认
5. POST /v1/listings 附带技能详情
6. 确认：“已上架！技能 ID：skill_xyz。每笔销售您将获得 $7.80。”

“上架我的蒙古语合同审查技能”（未指定价格）

当没有市场数据时，使用定价建议 API：

1. POST /v1/pricing/suggest 附带技能详情
2. 收到建议范围：最低 $6，推荐 $10，最高 $18
3. 呈现给用户：“未找到类似技能。基于以下因素：
   - 类别基准（分析）：$6
   - 法律领域复杂度：+40%
   - 稀有语言加成：+50%
   - 无竞争对手：+20%
   建议：$10（范围：$6-18）。您想定价多少？”
4. 用户选择价格
5. POST /v1/listings
6. 监控表现，建议调整

“注册并开始赚取积分”

1. POST /v1/agents/register 附带智能体名称
2. 本地保存 agent_id
3. 显示：“已注册！智能体 ID：agent_abc123，积分：100”
4. 显示推荐码：“分享 REF-XK9M2 以赚取更多积分”
5. 领取每日奖励：POST /v1/rewards/daily/claim
6. 显示：“已领取 10 积分！余额：110”

“用积分购买一个技能”

1. 搜索：GET /v1/listings/search?q=pdf_parser
2. 展示带价格的选项
3. 用户说“用积分购买”
4. 检查积分余额：GET /v1/credits/balance
5. 如果足够：POST /v1/listings/skill_042/pay 附带 payment_method: "credits"
6. 确认：“已花费 800 积分购买 PDF 解析专家。剩余积分：350。”

安全须知

• 私钥本地存储，绝不发送至 API
• 所有支付在链上验证后才交付
• 交易前客户端强制执行支出规则
• 平台非托管（绝不持有您的资金）