Proxy Pay MCP:自主 AI 支付 - Openclaw Skills
作者:互联网
2026-04-14
什么是 Proxy Pay MCP?
Proxy Pay MCP 是一款专门为 AI 代理提供安全金融层而设计的工具。通过集成此技能,开发者可以赋予其代理执行真实世界金融交易的能力,例如支付云服务费用、购买数字资产或管理订阅。该技能充当了高级代理逻辑与金融基础设施之间的桥梁,确保所有支出都受严格的、用户定义的策略约束。在 Openclaw Skills 生态系统中,Proxy Pay MCP 是构建需要在商业环境中独立运行的代理的关键组件。
此技能为代理提供了声明支付意图的能力,随后系统会根据支出策略对其进行评估。如果请求符合预设限制,将立即发行一张虚拟卡。这种架构确保了即使是完全自主的代理也处于财务控制之下,并具有包括商家限制和高额购买的人工审批阈值在内的多层保护。对于使用 Openclaw Skills 的开发者来说,这为代理化商业提供了一个生产级的解决方案。
下载入口:https://github.com/openclaw/skills/tree/main/skills/proxyhq/proxy-payments
安装与下载
1. ClawHub CLI
从源直接安装技能的最快方式。
npx clawhub@latest install proxy-payments
2. 手动安装
将技能文件夹复制到以下位置之一
全局模式~/.openclaw/skills/
工作区
/skills/
优先级:工作区 > 本地 > 内置
3. 提示词安装
将此提示词复制到 OpenClaw 即可自动安装。
请帮我使用 Clawhub 安装 proxy-payments。如果尚未安装 Clawhub,请先安装(npm i -g clawhub)。
Proxy Pay MCP 应用场景
- 管理和支付循环发生的 SaaS 订阅和 API 使用费。
- 为特定任务按需配置 AWS 或 Google Cloud 等云资源。
- 处理代理需要购买数字资产或研究材料的采购任务。
- 通过将交易与特定的代理意图匹配,实现自动化费用对账。
- 实施预算受限的研究项目,由 AI 代理管理其自身的资金分配。
- AI 代理使用
proxy.intents.create工具生成支付意图,并指定金额和商家。 - 系统根据分配给代理的支出策略评估该意图,检查限制和约束条件。
- 如果意图符合策略,则自动配置虚拟卡;否则,它将进入待定状态等待人工批准。
- 一旦意图获批,代理将检索敏感的卡片详情(卡号、CVV)以完成结账流程。
- 交易将被实时追踪,代理使用
proxy.receipts.attach工具上传证据以供审计。 - 所有金融活动都会针对初始意图进行对账,从而在 Openclaw Skills 中提供透明的审计追踪。
Proxy Pay MCP 配置指南
- 在 useproxy.ai 注册 Proxy 账户并完成所需的 KYC/KYB 验证。
- 在 Proxy 控制面板中创建一个“支出策略”和一个“代理”,以定义支出边界。
- 通过运行以下命令使用 Claude Code 进行身份验证:
claude mcp add proxy --transport http https://mcp.useproxy.ai/api/mcp
- 从
~/.claude/.credentials.json中提取您的访问令牌,并将其作为PROXY_TOKEN添加到您的环境变量中。 - 更新您的
config/mcporter.json文件以包含 Proxy MCP 服务器配置:
{
"mcpServers": {
"proxy": {
"baseUrl": "https://mcp.useproxy.ai/api/mcp",
"headers": {
"Authorization": "Bearer ${PROXY_TOKEN}"
}
}
}
}
- 通过调用
mcporter list proxy确认设置,以确保所有工具均可用。
Proxy Pay MCP 数据架构与分类体系
Proxy Pay MCP 将数据组织成多个实体,以确保为 Openclaw Skills 用户提供清晰的财务报告和合规性。
| 实体 | 关键属性 | 用途 |
|---|---|---|
| 支付意图 | intentId, amount, status, merchant |
记录代理的支出请求。 |
| 虚拟卡 | cardId, last4, expiry, status |
用于结账的已发行支付工具。 |
| 策略 | limits, merchant_allowlist, thresholds |
应用于所有交易的治理规则。 |
| 交易 | transactionId, amount, timestamp |
来自银行网络的实际分类账条目。 |
| 收据 | url, intentId, description |
链接到特定交易的数字证据。 |
| name | description | homepage | metadata |
|---|---|---|---|
| proxy-mcp | AI agent payments via Proxy. Create payment intents, provision virtual cards, check balances, and track transactions. OAuth authentication required. | https://useproxy.ai | clawdbot: requires: bins: mcporter |
Proxy Pay MCP
Give your OpenClaw agent a credit card. Proxy lets AI agents autonomously request and use virtual payment cards within policy-defined spending limits.
Features
- Intent-Based Payments — Agents declare what they want to buy, cards are auto-provisioned within policy
- Spending Policies — Set per-transaction limits, daily/monthly caps, merchant restrictions, and approval thresholds
- Virtual Cards — Single-use or limited cards issued instantly when policy allows
- Human-in-the-Loop — High-value intents require human approval before card issuance
- Balance & Funding — Check spending power, get ACH/wire/crypto deposit details
- Transaction Tracking — Monitor charges, attach receipts, reconcile against intents
- KYC/KYB Verification — Onboarding status and completion links
Setup
1. Create a Proxy Account
- Go to useproxy.ai and sign up
- Complete KYC/KYB verification
- Create a Spend Policy with your desired limits
- Create an Agent and assign the policy
- Fund your balance (ACH, wire, or USDC on Solana)
2. Authenticate via OAuth
Proxy uses OAuth for MCP authentication. Use Claude Code to authorize, then extract the token for mcporter.
Step 1: Add Proxy MCP to Claude Code
claude mcp add proxy --transport http https://mcp.useproxy.ai/api/mcp
Step 2: Authorize in Claude Code
claude
# In session, run: /mcp
# Complete OAuth in browser
Step 3: Extract token
jq -r '.mcpOAuth | to_entries | .[] | select(.key | startswith("proxy")) | .value.accessToken' ~/.claude/.credentials.json
Step 4: Add to environment
# Add to ~/.clawdbot/.env
PROXY_TOKEN=eyJhbGciOiJ...
Step 5: Configure mcporter
Add to config/mcporter.json:
{
"mcpServers": {
"proxy": {
"baseUrl": "https://mcp.useproxy.ai/api/mcp",
"description": "Proxy Pay — AI agent payments",
"headers": {
"Authorization": "Bearer ${PROXY_TOKEN}"
}
}
}
}
Step 6: Test
mcporter list proxy
mcporter call 'proxy.proxy.tools.list()'
Alternative: Agent Token (Autonomous)
For fully autonomous agents, use an agent token instead of OAuth:
- In the Proxy dashboard, go to Agents and create an MCP token
- Add to
~/.clawdbot/.env:PROXY_AGENT_TOKEN=proxy_agent_... - Configure mcporter with the agent token header:
{ "mcpServers": { "proxy": { "baseUrl": "https://mcp.useproxy.ai/api/mcp", "headers": { "Authorization": "Bearer ${PROXY_AGENT_TOKEN}" } } } }
Agent tokens are scoped to a single agent and its assigned policy.
Available Tools (25)
Onboarding & Profile
| Tool | Description |
|---|---|
proxy.user.get |
Get authenticated user profile |
proxy.kyc.status |
Check KYC verification status |
proxy.kyc.link |
Get KYC completion link |
Balance & Funding
| Tool | Description |
|---|---|
proxy.balance.get |
Get available spending power and charge summaries |
proxy.funding.get |
Get ACH, wire, and crypto deposit details with QR code |
Policies
| Tool | Description |
|---|---|
proxy.policies.get |
Get the policy attached to the current agent |
proxy.policies.simulate |
Dry-run an intent against policy rules (returns allow/deny) |
Payment Intents (Core Flow)
| Tool | Description |
|---|---|
proxy.intents.create |
Create a payment intent (auto-issues card if within policy) |
proxy.intents.list |
List payment intents |
proxy.intents.get |
Get intent details including card info |
proxy.intents.request_approval |
Request human approval for an intent |
proxy.intents.approval_status |
Check approval status |
proxy.intents.approve |
Approve a pending intent (human only) |
proxy.intents.reject |
Reject a pending intent (human only) |
Cards
| Tool | Description |
|---|---|
proxy.cards.list |
List cards (filter by agent or status) |
proxy.cards.get |
Get card details |
proxy.cards.get_sensitive |
Get full PAN, CVV, expiration for payment |
proxy.cards.freeze |
Freeze a card |
proxy.cards.unfreeze |
Unfreeze a card |
proxy.cards.rotate |
Rotate card credentials |
proxy.cards.close |
Close a card permanently |
Transactions & Receipts
| Tool | Description |
|---|---|
proxy.transactions.list_for_card |
List transactions for a card |
proxy.transactions.get |
Get transaction details |
proxy.receipts.attach |
Attach a receipt or evidence to an intent |
proxy.evidence.list_for_intent |
List receipts attached to an intent |
Merchant Lookup
| Tool | Description |
|---|---|
proxy.merchants.resolve |
Resolve a merchant name/domain to a canonical label |
proxy.mcc.explain |
Explain a merchant category code (MCC) |
proxy.merchants.allowlist_suggest |
Suggest allowlist matches for a merchant name |
Utilities
| Tool | Description |
|---|---|
proxy.tools.list |
List all available Proxy MCP tools |
Usage Examples
Check Balance
mcporter call 'proxy.proxy.balance.get()'
Create a Payment Intent
mcporter call 'proxy.proxy.intents.create(
description: "AWS monthly bill",
merchantName: "Amazon Web Services",
amount: 14999,
currency: "USD"
)'
Amount is in cents (14999 = $149.99). If within policy limits, a virtual card is auto-issued.
Get Card Details for Payment
# Get intent with card info
mcporter call 'proxy.proxy.intents.get(intentId: "int_abc123")'
# Get sensitive card data (PAN, CVV) for checkout
mcporter call 'proxy.proxy.cards.get_sensitive(
cardId: "card-uuid-here",
intentId: "int_abc123",
reason: "Paying AWS invoice"
)'
Simulate Before Spending
mcporter call 'proxy.proxy.policies.simulate(
amount: 50000,
currency: "USD",
merchantName: "OpenAI",
description: "API credits"
)'
Returns whether the intent would be auto-approved, need approval, or be denied.
Attach a Receipt
mcporter call 'proxy.proxy.receipts.attach(
intentId: "int_abc123",
url: "https://example.com/invoice-2026-01.pdf",
description: "January invoice"
)'
Intent Flow
- Agent calls
proxy.intents.createwith amount, merchant, and description - Policy evaluated — checks limits, merchant restrictions, approval thresholds
- If auto-approved → virtual card issued instantly, returned in response
- If needs approval → status =
pending_approval, agent pollsapproval_status - Human approves/rejects via dashboard or
intents.approve/intents.reject - Agent uses card — calls
cards.get_sensitivefor PAN/CVV to complete purchase - Transaction matched — webhook reconciles charge against intent
- Receipt attached — agent uploads evidence for audit trail
Error Codes
| Code | Meaning |
|---|---|
POLICY_REQUIRED |
Agent has no policy assigned — attach one in the dashboard |
ONBOARDING_INCOMPLETE |
KYC not completed — use kyc.link to finish |
AGENT_NOT_FOUND |
Agent token invalid or agent deleted |
FORBIDDEN |
Action not allowed for this auth type |
INTENT_NOT_FOUND |
Intent ID doesn't exist or not owned by user |
CARD_NOT_FOUND |
Card ID doesn't exist or not accessible |
Notes
- OAuth tokens give full account access (balance, funding, all agents' cards)
- Agent tokens are scoped to one agent and its policy — cannot see other agents' data
- Card-sensitive data requires both a
cardIdandintentIdfor compliance - Amounts are in cents — $10.00 = 1000, $149.99 = 14999
- Policies are enforced server-side — agents cannot bypass limits
- Human approval tools (
approve,reject) require OAuth (human) tokens
Resources
- Proxy Dashboard
- Proxy Documentation
- MCP Endpoint
- GitHub
相关推荐
专题
+ 收藏
+ 收藏
+ 收藏
+ 收藏
+ 收藏
+ 收藏
最新数据
相关文章
Calibre 工作区管理器:自动化电子书库元数据 - Openclaw Skills
Seedance 助手:精通即梦 AI 视频生成 - Openclaw 技能
视觉 RPA:AI 驱动的桌面自动化 - Openclaw Skills
Clawzempic:优化大模型成本与显存 - Openclaw Skills
Feed to Markdown: RSS 和 Atom 转 Markdown 转换器 - Openclaw Skills
CUCHD 教职工门户登录:自动身份验证 - Openclaw Skills
RAG 工程师:优化检索增强生成 - Openclaw 技能
每日销售摘要:自动化电商报表 - Openclaw Skills
Microsoft 365 CLI 工具包:自动化 Outlook 和 OneDrive - Openclaw Skills
Splunk: 机器数据与 SIEM 分析 - Openclaw Skills
AI精选
