Clawtar

核心用法

Clawtar 是一个用于演示和练习 Cashu HTTP 402 支付流的教学型技能。它提供了一个受控的测试端点，让 AI 代理能够端到端地演练完整的付费墙处理流程：检测 402 状态码、解析 x-cashu 挑战头、获取用户支付授权、完成付款结算，并使用 X-Cashu 头重试请求。

使用流程

1. 初始请求：向 https://clawtar.cashutools.dev/v1/clawtar/ask POST JSON 请求，包含 question 和可选的 style 字段（funny/chaotic/wholesome）
2. 处理 402：若收到 402 响应，从 x-cashu 头提取 NUT-24 挑战（内含 NUT-18 付款请求 creqA...）
3. 结算付款（需用户授权）：使用 cocod 工具执行 cocod x-cashu handle 结算，或向用户索取有效 Cashu token
4. 重试请求：在重试请求中添加 X-Cashu: <token> 头
5. 获取结果：成功后返回包含神秘 fortune 解读的 JSON 响应

显著优点

• 零风险练习环境：使用 42 sat 的测试金额，适合学习和调试
• 真实协议对接：完整实现 Cashu NUT-18/NUT-24 标准
• 清晰的权限模型：强制要求在自主支付前获取用户授权
• 多风格输出：支持幽默、混沌、温馨三种 fortune 风格

潜在局限

• 演示性质：非生产级服务，端点稳定性不保证
• 单一薄荷依赖：仅接受 Minibits Mint 的 token
• 需外部工具：完整体验需要 cocod Cashu 钱包工具
• 小额限制：固定 42 sat 金额，无法测试大额场景

适合人群

• AI 代理开发者测试 Cashu 支付集成
• 学习 Cashu 协议的学生和开发者
• 需要验证 402 处理逻辑的系统

常规风险

• 权限绕过风险：必须严格遵守"先授权后支付"规则，避免擅自使用资金
• 挑战/Token 混淆：x-cashu 头是付款请求而非 token，不可误用
• 端点可用性：作为演示服务，可能随时下线或变更