clawcard

你可以通过 clawcard CLI 使用 ClawCard。所有命令都支持 --json，可输出机器可读的数据。调用这些命令时始终传入 --json。

快速入门

clawcard agent info --json                             # Your identity, email, phone, balance
clawcard agent pay <slug> '<json>' --json              # Pay for any capability
clawcard agent catalog --json                          # Browse all capabilities
clawcard agent catalog-search "flights" --json         # Search capabilities
clawcard agent files list --json                       # Your files
clawcard agent creds --json                            # Your credentials

创建新资源前，务必先检查是否已有可用资源。 每次购买前都要列出卡片。对于同一商户，重复使用处于开启状态的 merchant_locked 卡片。

核心功能

功能	命令参考
电子邮件（发送、接收、读取）	reference/email.md
短信（发送、接收）	reference/sms.md
虚拟卡（创建、付款、管理）	reference/cards.md
文件存储（上传、列出、下载）	reference/files.md
凭据（存储、获取机密信息）	reference/credentials.md
浏览器结账（导航、填写表单、付款）	reference/checkout.md

目录 — 约 300 项付费 API 功能

你的 Agent 可以通过目录使用约 300 项付费功能。所有调用都会从你的账户余额中扣款。

如何为任意功能付费：

clawcard agent pay <slug> '<json body>' --json

浏览完整目录： clawcard agent catalog --json 按关键词搜索： clawcard agent catalog-search "web scraping" --json

类别	示例	价格范围	参考
搜索	web-search、news-search、image-search	$0.01-0.09	reference/catalog-search.md
抓取与提取	scrape-url、crawl-site、extract-data	$0.01-0.05	reference/catalog-scrape.md
人员与公司	enrich-person、enrich-company、find-contacts、find-email	$0.01-0.06	reference/catalog-enrich.md
社交媒体	tiktok-profile、instagram-posts、reddit-search	$0.06	reference/catalog-social.md
媒体生成	image-gen、music-gen、transcribe、text-to-speech	$0.03-0.11	reference/catalog-media.md
金融与市场	stock-quote、sec-filings、exchange rates	$0.01-0.06	reference/catalog-finance.md
旅行	flight-search、hotel-search	$0.01-0.06	reference/catalog-travel.md
地图与天气	geocode、directions、weather	$0.01	reference/catalog-maps.md
计算	run-code、screenshot	$0.01-0.06	reference/catalog-compute.md
参考	wolfram、translate	$0.01-0.06	reference/catalog-reference.md
营销与 SEO	seo-keywords	$0.01-0.03	reference/catalog-marketing.md
小众数据	sneaker-prices、property-value	$0.01-0.04	reference/catalog-data.md

重要提示：异步功能

部分功能（视频生成、音乐生成、深度研究、网站爬取）需要一段时间才能完成。它们会返回任务 ID，而不是立即返回结果。你必须轮询相应的状态 slug 才能获取结果。

每次轮询都会产生费用。 两次轮询之间请等待 10-15 秒，以免浪费余额。

音乐生成的示例流程：

# 1. Start generation ($0.11)
clawcard agent pay music-gen '{"prompt":"upbeat lo-fi beat","customMode":false,"instrumental":true,"model":"V4"}' --json
# → returns { data: { data: { taskId: "abc123" } } }

# 2. Wait 15 seconds, then poll ($0.01 per poll)
clawcard agent pay music-status '{"taskId":"abc123"}' --json
# → returns status: "PENDING" or "TEXT_SUCCESS" or "FIRST_SUCCESS" with audioUrl

异步功能的状态 slug：

• music-gen → 使用 music-status 轮询
• lyrics-gen → 使用 lyrics-status 轮询
• image-gen-gpt、image-gen-nano、video-gen-*（StableStudio）→ 使用 stablestudio-status 轮询
• stability-3d、stability-audio → 使用 stability-status 轮询
• replicate-run → 使用 replicate-status 轮询
• clado-deep-research → 使用 clado-research-status 轮询
• allium-sql → 使用 allium-sql-status 轮询，然后使用 allium-sql-results
• dune-sql → 使用 dune-results 轮询
• tako-deep-search → 使用 tako-deep-status 轮询
• crawl-site → 使用 crawl-status 轮询
• deep-research → 使用 parallel-task-status 轮询

浏览器结账（MCP）

在网站上购买商品（域名、订阅、SaaS 注册）时，请使用 clawcard-browser MCP 服务。它会启动一个装有 ClawCard Pay 扩展的浏览器。

设置： 如果无法使用浏览器 MCP 工具，请帮助用户进行配置：

• Claude Code： clawcard mcp 或 claude mcp add clawcard-browser -e CLAWCARD_API_KEY=<key> -- npx @clawcard/browser
• mcporter（OpenClaw 等）： 添加到 ~/.mcporter/mcporter.json：

  "clawcard-browser": {
    "command": "npx",
    "args": ["@clawcard/browser"],
    "env": { "CLAWCARD_API_KEY": "<key>" }
  }
  

• Cursor / VS Code： 添加到 .cursor/mcp.json 或 MCP 配置中，格式与上面相同

流程：

1. 创建卡片：clawcard agent cards create --amount <cents> --type merchant_locked --memo "description" --json
2. 启动浏览器：使用 launch_browser 工具打开结账 URL
3. 使用 snapshot、click、fill 浏览页面并填写非支付字段
4. 填写支付信息：使用 fill_checkout 工具，提供卡片 ID 和账单详情
5. 扩展会直接填写卡号、有效期和 CVC——你不会看到卡号
6. 检查页面并提交

MCP 工具：

工具	功能
launch_browser	打开装有 ClawCard Pay 扩展的浏览器
navigate	前往某个 URL
snapshot	获取包含 @e1 引用的页面无障碍树
click	根据引用点击元素
fill	根据引用在字段中输入内容
detect_checkout	检查页面是否为结账页面（返回置信度和金额）
fill_checkout	安全填写卡片和账单字段（卡片详情不会传给大模型）
screenshot	捕获页面
close_browser	关闭会话

安全性： 卡片详情（PAN、CVV）会直接从服务端发送到浏览器扩展。大模型不会看到或处理卡号。只会返回末四位。

提示

• 如需使用 API 功能，请运行 clawcard agent pay——它会自动从你的余额中付款。
• 如需在网站上购物，请使用 clawcard-browser MCP 工具和虚拟卡。
• 默认使用 merchant_locked 卡。仅在一次性购物时使用 single_use 卡。
• 切勿在未告知用户的情况下悄悄支付订阅费用。务必先提醒用户。
• 如需某项功能，请搜索目录：clawcard agent catalog-search "<what you need>" --json
• 如需充值：clawcard billing topup