Paddock Payee Check

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install paddock-check-payee
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 paddock-check-payee。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

Paddock Payee Check 是一项面向使用 x402 端点的 AI agent 的支付安全技能。它会将资源 URL 和支付要求发送至 Paddock 的免费收款人检查服务，从而在授权不可逆的支付之前，协助检测记录中结算给不同卖家的钱包。
作为 Openclaw Skills 的一部分，当服务不可用、返回错误或达到免费使用限制时，它会添加一个咨询性质的验证步骤，而不会阻塞正常的支付流程。未通过检查将停止支付，并向用户展示相关的失败原因和详细的审查链接。

应用场景

在 AI agent 首次为 x402 端点付款前对其进行验证。
当资源的支付条款、钱包、网络、资产或金额发生变化时，重新检查该资源。
防止向与不同卖家关联的钱包付款。
在允许用户做出知情支付决策的同时，向其提示警告信息。
为使用 x402 客户端的 TypeScript 应用程序添加轻量级安全检查。
在 Openclaw Skills 工作流中提供咨询性质的支付保护，同时不对 Paddock 产生硬性依赖。

工作原理

识别即将签署的 x402 资源 URL 和支付要求。
收集 payTo、network、asset 以及原子化 amount 值。
使用 check-payee HTTP 端点或 Paddock MCP 服务器上的 check_payee 工具查询 Paddock。
解读响应：fail 表示 agent 绝不能付款；warn 仅允许在解释警告后付款；pass 和 unknown 允许正常付款。
如果 Paddock 未提供答复、返回错误或响应 HTTP 402，请继续付款，因为该检查属于咨询性质。
对于失败的结果，告知用户，展示返回的 reasons，并提供 full_check 链接。
对首次使用的端点或每当支付条款发生变化时重复此检查。

配置指南

基础集成无需账号或密钥。该服务在无密钥的情况下每天提供多达 25 次检查。
HTTP API
使用资源和支付字段调用收款人检查端点：
curl "https://paddock.finance/api/mcp/check-payee?url=&pay_to=
&network=&asset=&amount_atomic="
MCP integration
连接到位于 https://paddock.finance/api/mcp/mcp 的 Paddock MCP 服务器，并使用资源 URL、payTo、network、asset 和原子化金額调用 check_payee 工具。
TypeScript integration
对于 x402 客户端项目，安装可选的防护包：
npm install @paddock-finance/x402-guard
使用来自 https://paddock.finance/api-access 的 Builder 或 Pro Agent 密钥来解除匿名每日限制。无论如何配置，都请将检查视为咨询性质：Paddock 错误、无响应和 HTTP 402 结果绝不能独立阻止付款。

数据架构

该技能基于紧凑的支付验证请求和以状态为导向的响应运行。
Field Purpose
url 正在付款的 x402 端点的资源 URL。
pay_to 支付要求中提供的收款人钱包地址。
network 用于结算的区块链网络。
asset 支付资产或代币。
amount_atomic 以原子单位表示的支付金额。
status 验证结果：fail、warn、pass 或 unknown。
reasons 检查失败时展示的解释说明。
full_check 指向完整 Paddock 验证详情的链接。
该工作流不需要生成文件或本地数据库。其元数据分类是卖家资源、目标钱包、网络、资产和原子金额的组合，它们共同描述了正在评估的支付。匿名使用限制为每天 25 次检查；Builder 或 Pro Agent 密钥可提升访问层级。

高级特性

同时支持直接的 HTTP GET 端点和 MCP 工具集成。
为 x402 客户端提供通过
@paddock-finance/x402-guard
实现的一行 TypeScript 路径。
区分硬性安全失败与咨询警告及信息性结果。
在 Paddock 无法访问、报错或返回 HTTP 402 时保持支付可用性。
reasons
full_check
审查链接向用户提供可视化凭据。
在自动化 AI-agent 支付工作流和 Openclaw Skills 集成中充当可复用的防护机制。
支持通过 Builder 或 Pro Agent 密钥进行更大规模的使用。

name: paddock-check-payee description: Before an AI agent pays an x402 endpoint, check that the payee wallet belongs to that seller using Paddock's free check_payee. Stops payments to a wallet recorded for a different seller.

Check the payee before you pay

Agent payments have no chargeback. Before you sign any x402 payment, check the payee with Paddock.

When to use

Every time you are about to pay an x402 endpoint you have not paid before, or any time the payment terms changed since you last paid it.

How

Take the resource URL and the payment requirements you are about to sign (payTo, network, asset, amount) and call:

GET https://paddock.finance/api/mcp/check-payee?url=&pay_to=&network=&asset=&amount_atomic=

Or call the check_payee tool on Paddock's MCP server at https://paddock.finance/api/mcp/mcp.

What to do with the answer

fail: do not pay. The wallet is recorded as settling for a different seller. Tell the user and show the reasons and full_check link.
warn: you may pay, but tell the user what the warning says.
pass or unknown: pay as normal.
No answer, an error, or a 402 from Paddock: pay as normal. The check is advisory and never a reason to stop on its own.

Free

25 checks a day without a key. Past that, Paddock answers 402 and you pay as normal. A Builder or Pro Agent key from https://paddock.finance/api-access lifts the limit.

In code

TypeScript projects using the x402 client can add this check in one line with the npm package @paddock-finance/x402-guard.

HPC Workflow

Site Walk Audio Memory