Verdix

安装指南

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

什么是

Verdix 可帮助 AI 代理在转账、付款、授权或 x402 付款前评估 Base 上的收款地址。它会检查包括 OFAC 制裁名单、诈骗和网络钓鱼名单、地址投毒相似地址、销毁地址以及被标记的部署者等信号；更高等级还会检查地址年龄、合约和链上行为。
此 Openclaw Skills 集成仅提供操作说明：不会运行代码，无需 API 密钥，也绝不会索要私钥或助记词。每次检查均通过 x402 使用 Base 上的 USDC 按次付费。评估结果只是风险信号，并不保证地址安全。

应用场景

向用户以前从未付款过的收款方转账前。
向不熟悉的地址付款、转移代币、授权或进行 x402 付款前。
用户询问某个钱包是否安全或可能涉及诈骗时。
收款地址可能是为利用地址投毒而设计的相似地址时。
对值得进行标准或深度检查的高价值转账进行检查，但须经用户批准。

工作原理

选择检查等级：lite（$0.01）、quick（$0.02）、standard（$0.10）或 deep（$0.50）。普通转账默认使用 quick；较大额转账或 quick 结果为 caution 时适合使用 standard；deep 适用于金额非常大或首次进行的转账。
在对话中首次进行付费检查前，告知用户检查等级和价格并取得明确批准，除非用户已授予预算或长期授权。
向对应等级的 endpoint 发送包含完整 Base 地址的 POST 请求。初始请求会返回 x402 付款报价；x402 客户端随后可授权报价中的 USDC 付款，并重复发送相同请求。
阅读响应字段，包括 verdict、reasons、checks performed 和 timestamp。Lite 结果还会指出受限或未执行的检查。
根据评估结果采取行动：出现 danger 时停止，除非用户看到原因后明确选择继续；出现 caution 时暂停并作出说明；将 safe 视为特定时点的结果而非保证；绝不能将 lite 的 no_known_risk 描述为 safe。
如果检查未完成或失败，应默认拒绝通过。503 或 data_unavailable 结果不代表通过；等待 Retry-After 后最多重试一次。如果仍无法完成，询问用户如何继续。

配置指南

Verdix 无需本地安装、账户或 API 密钥。请使用支持 x402 的钱包工具、现有的 x402 付款技能、官方 x402 客户端库，或已安装的 verdix-mcp 服务器。每次成功完成检查后，使用 Base 上的 USDC 按次付款；遵守钱包自身的限额，并在首次付费检查前取得用户批准，除非已获得授权。
查看某个等级的当前价格，但不发起付费检查：
curl -i https://api.verdixapi.com/risk/address/quick
GET 或 HEAD 请求会返回该等级的 402 报价，不会运行检查或产生任何费用。如需请求检查，请将包含完整地址的 JSON（0x 加 40 个十六进制字符）POST 到所选 endpoint，然后使用 x402 客户端处理付款报价，并在请求中附上付款标头后重复发送 POST。绝不要支付超过所列等级价格的金额，也不要接受非 Base 上 USDC 的报价。如果地址格式错误，请让用户重新提供，而不要猜测或自行更正。
参考资料：代理文档 https://api.verdixapi.com/llms.txt、OpenAPI 规范 https://api.verdixapi.com/openapi.json 和价格信息 https://api.verdixapi.com/pricing。

数据架构

每个等级的 endpoint 都接受包含完整收款地址的 JSON 请求体：
字段 类型 描述
address String Base 地址，格式为 0x 加 40 个十六进制字符。
字段 描述
address 已检查的地址。
chain 链标识符；Verdix 仅支持 Base。
tier 使用的检查等级：lite、quick、standard 或 deep。
price_usd 检查价格。
risk_score 服务返回的风险评分。
verdict safe、caution 或 danger；lite 可能返回 no_known_risk，而不是 safe。
reasons 风险信号或需要谨慎的原因。若结果为 caution 或 danger，应向用户展示这些内容。
checked 实际运行的检查。
as_of 结果的时间戳。
Lite 响应还包含 limited_checks、checks_performed、not_checked 和 full_check，其中 full_check 指向 quick 等级。data_unavailable:... 原因表示检查未完成，不得视为安全。只有完整的 HTTP 200 响应才会结算付款；未完成的检查不会收费。

高级特性

四种按次付费的等级可让代理平衡检查深度与成本：lite 检查名单；quick 增加地址年龄和合约信号；standard 增加链上行为分析；deep 目前执行与 standard 相同的检查，适用于风险更高的场景。
标准 x402 v2 付款流程在 Base 上使用 USDC 进行精确金额付款。付款方的 x402 客户端会签署 EIP-3009 授权；只有收到完整的 200 响应后才会结算付款。
免费的 GET 或 HEAD 请求可获取当前 402 价格报价，不会收费或运行检查。
兼容的调用方式包括现有的 x402 钱包工具、官方 x402 客户端库，以及适用于各个等级的 verdix-mcp 工具。
安全失败处理会区分未完成的检查、格式错误的地址和未接受的付款。遇到 503 时必须等待 Retry-After，且只能重试一次；付款后若再次收到 402，不应追加更高金额的付款。
此技能建议复用同一地址近期的检查结果，而不是重复付费检查，并在大额转账前与用户核对完整收款地址。

name: verdix description: | Check a recipient address on Base before sending it funds, using the Verdix risk API.
Use before any transfer, payout, approve or x402 payment to an address the user has not
paid before, or when the user asks "is this address safe?", "check this wallet",
"is 0x... a scam?". Returns a verdict with reasons: OFAC sanctions, scam and phishing
lists, address-poisoning lookalikes, burn addresses, phishing-lure tokens, flagged
deployers and (higher tiers) address age, contract signals and on-chain behaviour. Each check is paid
per call via x402 in USDC on Base: $0.01 to $0.50. No account or API key.
version: 1.0.0