Axiom 钱包

当用户希望通过 MCP 与其 Axiom 钱包进行交互时，使用此技能。

Axiom 钱包可用于：

• 查看已存档的付款方式
• 查阅近期交易记录
• 为用户请求的购买启动由服务器托管的浏览器结账流程（费用将从已存档的银行卡中扣除）

Axiom 的 MCP 端点地址为：

https://mcp.useaxiom.ai/mcp

何时使用此技能

当用户要求您执行以下操作时，请使用 Axiom 钱包：

• 使用 Axiom 进行购买或付款
• 检查其 Axiom 付款方式或账户信息
• 查看近期 Axiom 交易记录

请勿将此技能用于无关的网页浏览、超出可用 MCP 工具范围的账户设置修改，或用户未明确请求的推测性购买。

认证

完整认证指南详见 references/authentication.md。

快速摘要：

1. 注册 Axiom：mcporter config add axiom --url https://mcp.useaxiom.ai/mcp
2. 启动认证：mcporter auth axiom --reset --oauth-timeout 300000 --log-level info（后台运行，并在日志中打印 OAuth URL）
3. 从 mcporter 的日志输出中解析 OAuth 授权 URL
4. 使用无头浏览器访问该 URL：agent-browser open ""（或 browser-use open ""）
5. 从渲染后的页面中读取激活 URL：agent-browser eval "document.querySelector('a[href*=\"activate\"]')?.href"
6. 将激活 URL 发送给用户，供其在手机端确认授权
7. 用户完成授权后，mcporter 将自动完成 OAuth 交换流程
8. 验证认证结果：mcporter call axiom.get_payment_method

重要提示：OAuth 授权 URL 与激活 URL 是两个不同的 URL。Agent 应导航至授权 URL；用户应在手机端打开激活 URL。切勿将授权 URL 发送给用户。认证文档中提供了两种 URL 的示例。

如需清除缓存的令牌，请执行：mcporter auth axiom --reset

启动购买及提交澄清请求需要 payments:write OAuth 权限范围；轮询购买状态则需要 payments:read。若购买工具因权限范围不足而被拒绝，请重置认证并重新连接，以确保客户端请求当前所需的全部权限范围。

可用工具

• get_payment_method — 返回已存档的银行卡信息（仅品牌名称和卡号后四位）。在尝试购买前，应先调用此方法验证付款方式是否存在。
• list_transactions — 列出近期交易记录（可选参数 limit，按时间倒序排列，最新交易在前）。
• make_purchase — 购买入口函数。校验请求内容，在可能范围内解析商品/规格的可用性，创建交易意图授权，并启动 Axiom 的服务器托管式浏览器结账流程。必需参数包括：userCommand（近乎逐字保留用户原始指令）、merchant（含 merchantName 和 merchantURL）、itemName；可选参数包括 itemSubtotal（不含运费、税费及手续费的商品小计）和 preferences。该函数立即返回 status，绝不会等待浏览器流程完成。
• get_purchase_status — 轮询由 make_purchase 启动的浏览器购买流程状态。传入 browserPurchaseSessionID，并省略 timeoutMs 参数（或使用客户端所支持的最长超时值）。该函数会阻塞，直至下一次进入“暂停”或“终态”状态，然后返回如下信息：公开的 progressStage / progressLabel、审批链接、澄清请求、终态结果、电子收据以及购物车详情。它不流式传输增量进度 —— 您需在循环中反复调用本函数。端到端购买通常耗时约 10–15 分钟。
• submit_purchase_clarification — 当 get_purchase_status 返回 status: "awaiting_user_input" 时，提交用户的回答。需传入 browserPurchaseSessionID、userInputRequest.requestID，以及 selectedOptionID、userInput 或二者皆有。随后继续轮询 get_purchase_status。
• get_transaction — 根据 ID 获取单笔交易详情，包括其状态、商户、金额、审批状态、收据及审计轨迹。可用于回溯已完成的购买或审查历史记录。

发起购买

Axiom 在服务端全程运行结账流程。您负责解析请求并启动流程；Axiom 则负责购物车获取、结账、联系/收货信息填写、配送方式选择、支付授权、银行卡信息录入、订单结果识别以及收据捕获。您永远无法看到或输入任何银行卡详情。

1. 验证付款方式。

   • 调用 get_payment_method，以便用户确认将使用哪张已存档的银行卡进行扣款。
   • 若不存在已存档的付款方式，请告知用户前往其 Axiom 账户设置中添加银行卡，并终止后续流程。

2. 解析购买请求。

   • userCommand 应尽可能逐字保留用户原始输入 —— 它是审计与意图记录。请勿改写，也请勿将已解析的具体信息合并进该字段（这些信息应填入 itemName / merchant.* 中）。
   • 根据上下文（如历史对话轮次、用户档案、记忆等）尽可能具体地解析 merchant.merchantName、merchant.merchantURL 和 itemName。严禁虚构。
   • 若用户提供商品详情页 URL，或您能合理推断并支撑该 URL，则优先使用；否则使用您已知的商户首页 URL。
   • 若已知所需规格（如尺寸、颜色、存储容量、口味、数量等），请将其包含在 itemName 中。
   • 当用户声明预算或价格已知时，传入 itemSubtotal（单位为美元，不含运费、税费及手续费），该值将在支付时作为单品总额上限。
   • 切勿虚构缺失的关键商品信息。流程可在打开浏览器会话前即返回澄清请求或不可用响应。

3. 调用 make_purchase。

   • 若返回 status: "running"，请保存 browserPurchaseSessionID 和 transactionID，然后调用 get_purchase_status。
   • 若返回 status: "needs_clarification"，请原样向用户呈现 question 及任意 options。若 source: "intent_sufficiency" 或 source: "purchase_request_resolution"，请将用户的答复整合进已解析字段，并再次调用 make_purchase。
   • 若返回 status: "unavailable"，请向用户呈现 reason、question 及任意 options / availableOptions。仅当用户选择一个可用选项或更改请求后，方可再次调用 make_purchase。
   • 若返回 status: "mandate_denied"，请将返回的 reason 告知用户并终止流程。这是正常的业务域结果，而非 MCP 工具故障。
   • 若 status 为 failed、cancelled 或 human_needed，请将返回的 reason / message 呈现给用户。这些均为正常终态结果，而非 MCP 工具故障。

4. 轮询 get_purchase_status。

   • 持续轮询，直至 status 变为 completed、awaiting_approval、awaiting_user_input、human_needed、failed 或 cancelled。
   • 对于 running 状态，请使用 progressStage 和 progressLabel 向用户展示进度。请勿暴露或推断浏览器内部任务/阶段名称。
   • 对于 awaiting_approval 状态，请将 approvalLink 发送给用户，并在其完成审批后继续轮询。
   • 对于 awaiting_user_input 状态，请向用户呈现 userInputRequest.question 及任意 userInputRequest.options，然后调用 submit_purchase_clarification，传入 browserPurchaseSessionID、userInputRequest.requestID，以及所选选项或自由文本答案。
   • 对于 completed 状态，请汇总 receipt、finalTotal 和 cart。购物车中的金额字段已是公开的美元数值；无需期望原始“美分”字段。
   • 对于 human_needed、failed 或 cancelled 状态，请根据返回的 reason / message 告知用户发生了什么。

安全与行为规范

• 发起购买前，必须验证已存档付款方式的存在性。
• 除非 get_purchase_status 明确返回 completed，否则不得声称购买成功。
• 若支出规则、审批要求或策略检查阻止了购买，请立即中止并告知用户原因。
• 若 make_purchase 返回 mandate_denied，请立即中止并告知用户原因 —— 不得通过改写输入尝试绕过该拒绝。
• 严禁跳过审批流程；必须将 approvalLink 发送给用户，并等待其完成审批。
• 严禁暴露 OAuth 令牌、会话详情、Cookie 或浏览器状态。
• 严禁伪造商户、金额、税费、运费、收据或交易详情 —— 仅报告工具实际返回的内容。

故障排查

mcporter 未找到或版本过旧

必须安装并配置 mcporter ≥0.8.0，且确保其位于系统 PATH 中。可通过 mcporter --version 命令验证。OpenClaw 在加载技能时会检查所需二进制文件是否就绪。

认证已过期或失败

请重置并重新运行认证流程：

mcporter auth axiom --reset

跨设备审批超时

请启动全新的认证流程，并发送新的审批链接或激活码。

无已存档付款方式

请告知用户前往其 Axiom 账户设置中添加银行卡，并终止后续流程。

购买需您审批

get_purchase_status 返回 awaiting_approval 并附带 approvalLink。请将该链接发送给用户，并持续轮询；用户完成审批后，流程将继续执行。

授权被拒

make_purchase 返回 mandate_denied —— 例如商户属于受限类别，或请求未被明确认定为购买行为。请将返回的原因告知用户并终止流程。请勿使用改写后的输入重新运行。

购买失败或需人工介入

get_purchase_status 返回 failed、cancelled 或 human_needed。请将返回的 reason / message 呈现给用户；这些均为正常终态结果，而非 MCP 工具故障。