Cloudflare Wallets：Handle 预约、产品状态与现在能做什么

Announcing Cloudflare Wallets

AI 参与说明（Agent：Cursor）：本文根据用户提供的产品博客，对照 Cloudflare 官方文档、新闻稿、Agents SDK 的 Agentic Payments 文档、Cloudflare v4 OpenAPI / REST 探测，以及 npm 上的公开包名整理。资料核对于 2026-09-11。当时 Cloudflare Wallets 只开放 Handle 预约，尚未开放充值、支付、Virtual Wallet 或控制面 API。运行记录：模型 grok-4.6，提供方 xAI，执行入口 Cursor。reasoning effort 与 CLI 版本未取得运行记录。

结论：你已经申请到的用户名，现在只是一个绑定到 Cloudflare 账户的 Handle，还不能当钱包用。 Cloudflare Wallet handle 可以把名字占住、公开一页 HANDLE.cloudflare.pay，并登记“产品可用时通知我”。它还不能充值、付款、收款，也不能给 Agent 签发 Virtual Wallet 或 API key。2026-08-04 的新闻稿写的是 Full wallet access, including onramping and offramping funds and the ability to issue Virtual Wallets, will be available in the coming months。到 2026-09-11，开发者文档、OpenAPI 和 REST 路由都还没有 Wallets 控制面。 Cloudflare Wallets docs Press release, 2026-08-04

A reserved handle associates the name with your Cloudflare account, publishes a page at HANDLE.cloudflare.pay showing only the handle, and registers your account to be notified when Cloudflare Wallets becomes available. A reserved handle does not yet let you send, receive, or hold funds. What is available today

阅读前先看这几个词

它要解决什么

Agent 很难自己开通付费 API：没有稳定身份，也没有原生付款方式。注册页、绑卡、生成 API key 都是给人点的。Cloudflare 把这件事拆成买卖两边：

• 卖方：Monetization Gateway 计划让站点对任意受 Cloudflare 保护的资源收费，结算走 x402。
• 买方：Cloudflare Wallets 计划让账户持有稳定币，再把受限额约束的 Virtual Wallet 交给 Agent。

Wallets will add another tool to Cloudflare’s Agents SDK, enabling AI agents to easily purchase necessary APIs and content using micropayments. Announcement

Handle 的角色是身份，不是余额。官方例子是 research.example.cloudflare.pay：商户可以看到“这是某个组织派出的某个 Agent”，也可以不强制声明身份。它建立在 Web Bot Auth 那种密钥对之上，目的是把难记的 keypair 变成人类可读名字，而不是另发明一套身份 schema。 Announcement

flowchart TB
  market["Agentic commerce 两边"] --> sell["卖方 Monetization Gateway"]
  market --> buy["买方 Cloudflare Wallets"]
  sell --> edge["边缘校验 x402 并放行请求"]
  buy --> account["Account Wallet<br/>人充值、设规则、提现"]
  account --> virtual["Virtual Wallet<br/>Agent 用 API key 花限额内的钱"]
  virtual --> pay["付给 x402 兼容端点"]
  edge --> origin["源站 / API / MCP tool"]
  pay --> edge

图里的充值、Virtual Wallet 和 Monetization Gateway 规则引擎，截至 2026-09-11 都还是“将要”，不是已经能调用的产品面。

现在到底开放了什么

官方开发者站点里，Wallets 文档目录只有概述和 FAQ 两页，最后更新是 2026-08-19。没有 get-started、没有 API reference、没有 Workers binding。 wallets/llms.txt

Anyone with a Cloudflare account can reserve a Cloudflare Wallet handle. Each account can reserve one handle. Cloudflare reserves the right to reject or reclaim wallet handle reservations for any reason. FAQ

已经申请了用户名，现在能做什么

把你申请的那个名字理解成 Handle，而不是已经开通的钱包。接下来只做这几件事：

1. 确认预约落在正确账户上。 用当初登录的那个 Cloudflare 账户打开 cloudflare.pay。每账户只能占一个名字，占错账户就占错身份。
2. 打开公开页。 地址是 https://<handle>.cloudflare.pay。官方说这一页目前只展示 Handle，用来证明名字已经和账户关联。
3. 等官方通知。 预约会把账户登记进“Wallets 可用时通知”名单。没有公开的开通开关、Dashboard 菜单或 Wrangler 命令可以提前打开支付。
4. 不要指望改名。 Handles are allocated first come, first served, and Cloudflare does not currently offer a way to change, release, or move a handle once it is reserved. 连 rebrand 后改名也要走 Support。 FAQ
5. 不要把预约当成额度或 KYC 完成。 上线时仍可能因地区、资格或 Cloudflare 审核拿不到 Account Wallet。新闻稿写的 onramp / offramp 也只在 supported geographies，并另提供 self-funding via stablecoins 给 eligible users。 Announcement

上线后，按官方设计，人用的是 Account Wallet，Agent 用的是 Virtual Wallet。Virtual Wallets, by contrast, are designed for agents and operate via API keys. Its maximum spend will be capped by the limit set by the owner of the Account Wallet. 计划中的护栏包括 allowance、allow list、maximum transaction size。这些配置面现在都还没出现在文档或 API 里。 docs Announcement

flowchart TB
  now["现在：已预约 Handle"] --> page["HANDLE.cloudflare.pay 公开页"]
  now --> notify["登记产品通知"]
  now --> wait["等待 Account Wallet 开通"]
  wait --> fund["以后：充值稳定币"]
  fund --> rules["设额度 / 白名单 / 单笔上限"]
  rules --> vw["签发 Virtual Wallet 与 API key"]
  vw --> agent["Agent 在限额内付 x402 端点"]

API 开了吗

没有。 这里要把两件事分开：Cloudflare Wallets 自己的控制面，以及已经存在的 x402 / Agents SDK 付款。

针对 Wallets 控制面，2026-09-11 的核验结果是：

• Cloudflare OpenAPI spec 里没有 wallet / wallets 产品路径。能搜到的 pay-* 属于账单、payment-methods 和 Pay Per Crawl，与 Cloudflare Wallets 不是同一产品。
• 对 Cloudflare v4 REST 探测 /accounts/{account_id}/wallets、/wallet、/wallets/handles 等路径，返回 7000: No route for that URI。这是“路由不存在”，不是权限不足。
• npm 上不存在 @cloudflare/wallets（registry 对该包名返回 404）。网上一些“今天就 import { Wallet } from '@cloudflare/wallets'”的教程，没有对应的官方包或文档页。
• Changelog 也没有 Wallets GA / API 条目；产品文档停在 Handle 预约。

官方用的是将来时：Virtual Wallets … operate via API keys、Wallets will add another tool to Cloudflare’s Agents SDK。那是路线图，不是已经发布的 SDK 入口。 Announcement

卖方那一侧同样还没 GA。Monetization Gateway 在 2026-07-01 开放 waitlist：charge for any web page, dataset, API, or MCP tool behind Cloudflare，结算走 x402。博客仍使用 will provide / will verify 这类将来时，并指向 waitlist，而不是一份已发布的规则 API。 Monetization Gateway

现在想付钱或收费，该走哪条路

Handle 解决不了付款。今天能跑通的是 Agents SDK 的 Agentic Payments：用你自己的链上钱包（通常是测试网 USDC）去付已经实现 x402 或 MPP 的端点。这和 Cloudflare Wallets 不是同一个产品；Wallets 以后要替代的，正是你现在自己保管私钥、自己设限额这件事。

x402 is a payment standard created by Coinbase. It uses on-chain stablecoin payments and defines three HTTP headers — PAYMENT-REQUIRED, PAYMENT-SIGNATURE, and PAYMENT-RESPONSE — to carry challenges, credentials, and receipts. Agentic Payments

买方最小路径（官方 Agents SDK 示例，网络用 base-sepolia，测试 USDC 来自 Circle faucet）：

import { Agent } from "agents";
import { withX402Client } from "agents/x402";
import { privateKeyToAccount } from "viem/accounts";

export class MyAgent extends Agent {
	async onStart() {
		const { id } = await this.mcp.connect(`${this.env.WORKER_URL}/mcp`);
		const account = privateKeyToAccount(this.env.MY_PRIVATE_KEY);

		this.x402Client = withX402Client(this.mcp.mcpConnections[id].client, {
			network: "base-sepolia",
			account,
		});
	}

	onPaymentRequired(paymentRequirements): Promise<boolean> {
		// 人审回调；传 null 则自动付款
	}

	async onToolCall(toolName: string, toolArgs: unknown) {
		return await this.x402Client.callTool(this.onPaymentRequired, {
			name: toolName,
			arguments: toolArgs,
		});
	}
}

这段代码来自 Pay from Agents SDK。私钥放在 .dev.vars / wrangler secret，不要写进源码。它证明的是：Agent 今天可以用自有 EVM 账户付 x402 保护的 MCP tool。它不能证明 Cloudflare 已经替你托管余额，也不能把付款记到你预约的 Handle 上。

卖方今天也可以不靠 Monetization Gateway，直接在 Worker 里用 x402-hono 或 paidTool 收费，收款地址是普通的 0x... 钱包，facilitator 示例是 https://x402.org/facilitator。 Charge for HTTP content Charge for MCP tools

和 Wallets 容易混在一起、但已经存在的产品：

sequenceDiagram
  participant Agent
  participant Server
  participant Facilitator
  Agent->>Server: GET /resource
  Server-->>Agent: 402 + PAYMENT-REQUIRED
  Agent->>Agent: 用自有私钥签名付款
  Agent->>Server: 重试 + PAYMENT-SIGNATURE
  Server->>Facilitator: verify / settle
  Facilitator-->>Server: 链上结算确认
  Server-->>Agent: 资源 + PAYMENT-RESPONSE

等 Cloudflare Wallets 真正开放后，理想情况是 Virtual Wallet 替你完成“签名与限额”这一步，Handle 再可选地声明身份。在那之前，把生产收入或生产采购压在 Wallets 上没有官方接口可依赖。

和优先技术栈怎么对齐

作者侧如果已经在 Workers + Agents SDK 上跑 Agent，现在能做的是：协议与产品代码按 x402 / MPP 接好，私钥和收款地址先用自己的钱包。Cloudflare Wallets 到来后，替换的应是资金托管和限额，而不是重写 HTTP 402 握手。Dashboard 规则、Terraform 和“付给 HANDLE.cloudflare.pay”这类控制面，只能等官方文档出现后再迁。

参考资料

• Announcing Cloudflare Wallets，2026-08-04
• Cloudflare Wallets docs，文档页显示 Last updated Aug 19, 2026
• Cloudflare Wallets FAQ
• Press release: Cloudflare Gives AI Agents an Identity and a Wallet，2026-08-04
• Announcing the Monetization Gateway，2026-07-01
• Agentic Payments
• Pay from Agents SDK
• x402 in Agents docs
• 站内相关：Convex Agent Component 与 Cloudflare Agents SDK：关页后继续生成并恢复聊天