核心用法
OpenClaw Paid Actions 是一个基于 Solana 链上支付的自动化执行框架,允许开发者为特定操作设置 USDC 价格门槛,确保"先付费、后执行"的业务逻辑。其典型流程包含六个环节:查询可用动作(list)、生成支付指引(quote/invoice)、等待链上确认(wait/status)、验证交易(confirm/pay)、最终执行(execute)。
显著优点
1. 链上支付确权:通过 Solana 主网 USDC 转账实现不可篡改的支付证明,杜绝"未付先享"
2. 灵活定价模型:支持按动作独立定价(如 X shoutout 0.03 USDC),可扩展性强
3. 安全隔离执行:动作以独立子进程运行,通过环境变量注入输入,输出受 maxOutputBytes 限制防爆破
4. 异步事件通知:支持 notifySessionKey 机制,支付完成后网关推送系统事件
潜在缺点与局限性
- 链上延迟依赖:Solana 网络拥堵时 confirmation 时间不可控,默认 15 分钟超时可能不足
- 私钥管理风险:invoiceSecret 用于签名票据,泄露可导致伪造支付凭证
- 命令注入隐患:虽然配置要求预审核 scripts/paid-actions 目录,但动态 command 数组仍存在理论上的注入面
- 单链绑定:仅支持 Solana USDC,未覆盖 ETH/BTC 等其他主流公链
适合人群
- 内容创作者:付费转发、定制化 shoutout 服务
- 开发者社区:付费代码审查、优先技术支持队列
- SaaS 平台:按次计费的 API 调用、报告生成等微服务
常规风险
- 票据双花:需确保 invoiceStore 持久化可靠,重启后状态一致性
- 汇率波动:USDC 虽为稳定币,但智能合约风险、桥接风险仍存在
- 监管合规:涉及加密货币支付需评估当地法规(尤其美国 SEC、欧盟 MiCA)
- Gas 费转嫁:小额支付场景下链上手续费可能超过服务定价本身