OpenClaw:Z-ZERO人工智能代理MCP服务器
为AI代理构建的零信任支付协议 模型上下文协议（MCP）.让您的代理商（Claude、Cursor、Antigravity）能够安全地进行真实世界的购买，而无需看到真实的卡号。
是什么让它与众不同：
- 🔐 零信任 --AI永远不会看到PAN、CVV或到期。卡数据仅存在于RAM中，通过Playwright注入，然后擦除。
- 🌐 Web3+菲亚特 --自动检测加密货币结账（EIP-681）并路由到链上USDT转账。对于菲亚特来说，又回到了JIT Visa。
- 🧠 智能路由 --云知识库(
get_merchant_hints)为Shopify、Etsy、WooCommerce等提供特定于平台的结账手册。 - 🔄 自愈 --通过以下方式记录失败的签出
report_checkout_fail供管理员审查，提高未来的成功率。
______________________________________________________________________
运作原理
sequenceDiagram
actor User
participant AI as AI Agent
participant MCP as MCP Tools
participant API as Z-ZERO API
participant DB as Supabase DB
User->>AI: "Buy me this Shopify item"
Note over AI: Scans available MCP Tools
AI->>MCP: Reads description of auto_pay_checkout
MCP-->>AI: "⚠️ MANDATORY: Read mcp://resources/sop first"
Note over AI: Fetches SOP before proceeding
AI->>MCP: Fetch resource mcp://resources/sop
MCP-->>AI: Platform rules + 3-Group payment SOP
Note over AI: "Shopify = physical goods. Must collect shipping first."
AI->>MCP: get_merchant_hints("_platform_shopify")
MCP->>API: GET /api/checkout-hints?domain=_platform_shopify&fields=merchant
API->>DB: Query checkout_hints table
DB-->>API: Platform hints data
API-->>MCP: Returns pre_steps + notes only
MCP-->>AI: "Fill shipping form first, click Next..."
Note over AI: Navigates checkout, fills shipping, waits for payment page
AI->>MCP: request_payment_token(amount, card_alias)
MCP-->>AI: Token: temp_auth_XYZ (1hr TTL)
AI->>MCP: execute_payment(token, checkout_url)
Note over MCP: Playwright auto-fills card form, burns token after use
MCP-->>AI: Success — payment complete
AI-->>User: "Done! Your Shopify item has been ordered."______________________________________________________________________
快速安装（推荐）
npx z-zero-mcp-server添加到您的Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"openclaw": {
"command": "npx",
"args": ["-y", "z-zero-mcp-server@latest"],
"env": {
"Z_ZERO_API_KEY": "zk_live_your_passport_key_here"
}
}
}
}获取您的护照密钥： 卡钳、储物室/仪表板/试剂
______________________________________________________________________
需求
- Node.js v18+ —
- 护照密钥 --开始于
zk_live_，从上面的仪表板获取
______________________________________________________________________
可用的MCP工具
第1组——钱包配置（被动）
| 工具 | 说明 |
|---|---|
list_cards | 列出所有虚拟卡别名和余额 |
check_balance | 检查卡别名的可支配美元余额 |
get_deposit_addresses | 获取加密货币存款地址（EVM+Tron）以充值余额 |
set_api_key | 立即激活新的护照密钥，无需重新启动 |
show_api_key_status | 检查当前是否加载了护照密钥（仅前缀） |
第2组——手动四步付款（主动）
| 工具 | 说明 |
|---|---|
request_payment_token | 为特定金额（1小时TTL）发行JIT一次性Visa代币 |
execute_payment | 通过Playwright使用支付令牌自动填写结账表单 |
cancel_payment_token | 取消未使用的代币并退款到钱包 |
request_human_approval | 在继续之前暂停并请求人工确认 |
第三组——智能自动驾驶仪
| 工具 | 说明 |
|---|---|
auto_pay_checkout | 全自动结账——自动检测Web3或菲亚特并完成付款 |
get_merchant_hints | 从知识库中获取特定于平台的结账手册（预步骤+选择器） |
report_checkout_fail | 记录失败的签出URL以供管理员审核（自我修复反馈循环） |
📖 注： 版本检查在每个API调用中自动处理。不需要单独的工具。
______________________________________________________________________
REST API参考
Z-ZERO后端托管在 https://www.clawcard.store。所有端点都需要 Bearer 使用您的Passport密钥的令牌。
⚠️ 使用上面的MCP工具，而不是直接调用REST。 如果必须调用REST，请使用下面的确切路径。
GET /api/tokens/cards
返回您的卡列表、余额和存款地址。
curl -X GET "https://www.clawcard.store/api/tokens/cards" \
-H "Authorization: Bearer zk_live_your_key"别名（也适用）：
GET /api/v1/cards← 用于猜测REST风格路径的代理
POST /api/tokens/issue
发放JIT支付令牌。
POST /api/tokens/resolve
解析令牌到卡数据（仅限服务器端）。
POST /api/tokens/burn
烧毁一个用过的代币。
POST /api/tokens/cancel
取消未使用的令牌（退款余额）。
______________________________________________________________________
故障排除
“Z_ZERO_API_KEY丢失”
- 首选 卡钳、储物室/仪表板/试剂
- 复制您的护照密钥（以开头
zk_live_) - 将其添加到您的配置中
Z_ZERO_API_KEY - 重启 克劳德桌面/光标
“无效的API密钥”（401）
- 仔细检查您是否复制了完整密钥（例如。
zk_live_c0g3l) - 确保没有多余的空格或换行符
“404未找到” /api/v1/cards
- 这是一个遗留路径别名，现在应该可以使用了。如果不能，请使用
/api/tokens/cards直接。
______________________________________________________________________
*安全性：OpenClaw从不存储您的护照密钥。它通过环境变量传递，卡数据在执行过程中仅存在于易失性RAM中。*