计量型 API 市场

提供一个轻量生产级模板，实现：OpenClaw Skill → 公共 API 端点 → 使用量计量 → 加密货币支付网关 → BTC/ETH 钱包。

该技能包含一个可运行的参考服务器（Fastify + SQLite），具备以下功能：

• 接受 结构化 JSON 输入
• 执行 高价值转换（可通过插件“转换器”扩展）
• 返回 结构化 JSON 输出
• 强制执行 签名 API 密钥认证
• 检查 预付余额，每次调用后扣除并记录使用情况
• 接收 支付回调（类似 Coinbase Commerce / BTCPay Server 的模式）
• 在账本中应用 2.5% 平台手续费（费用地址可配置）

工作流程（按顺序执行）

1）选择产品化的功能能力（用户付费的核心服务）

从以下维度选择一个转换器：

• 高杠杆性（能创造或维持收益）
• 可重复性（被频繁调用）
• 可防御性（基于数据、启发式规则、工作流或自动化 —— 不是“通用摘要”类功能）

推荐默认选项：

• 收入/报价优化器
• 广告文案优化器
• 客户线索评分
• 合同风险预警

若不确定，可先使用内置的 revenue-amplifier 转换器，后续再替换。

2）本地运行参考服务器

使用 scripts/server/ 目录中的内建服务器。

典型启动步骤：

• cd scripts/server
• npm install
• cp .env.example .env 并编辑配置
• npm run dev

在 .env 中设置初始定价：

• COST_CENTS_PER_CALL=25 # 每次调用 $0.25

3）创建 API 密钥

使用 scripts/server/admin/create_key_pg.js（或管理员 HTTP 端点）创建密钥并设置初始余额。

4）从 OpenClaw 技能 / 代理中集成

调用公共端点时需携带：

• x-api-key
• x-timestamp（毫秒级 Unix 时间戳）
• x-signature = hex(HMAC_SHA256(api_secret, ${timestamp}.${rawBody}))

5）接入真实支付

将支付处理器的回调地址指向 /v1/payments/webhook/:provider。

支持适配器模式的支付提供商：

• 初始阶段可使用“手动充值”（通过管理脚本）
• 后续可接入 Coinbase Commerce 或 BTCPay Server

6）上线部署

部署至支持 TLS 的环境（Cloudflare / Fly.io / Render / AWS / GCP）。在边缘层和应用内均设置速率限制。

内置资源

scripts/server/

可运行的参考实现：

• Fastify API 服务器（长期运行）
• Postgres 账本（用于存储余额、使用记录、积分）
• 签名 API 密钥认证
• 速率限制与基础反滥用机制
• 回调端点（支持多个）

scripts/nextjs-starter/

适用于 Vercel 的 Next.js API 实现：

• 无 listen() 的无服务器 API 路由
• Postgres 账本（推荐使用 Supabase Transaction Pooler）
• 保持相同的认证、计价与回调逻辑

references/

仅在需要时查阅：

• references/api_reference.md – 端点契约与认证/签名说明
• references/billing_ledger.md – 定价策略、费用逻辑、幂等性处理
• references/providers.md – 支付提供商适配器（Coinbase/BTCPay 模式）