📦 AgentPay — 安装SDK

# AgentPay SDK 使用此技能作为操作手册。不要让用户从零开始设计命令流程或策略对象。 ## 本技能涵盖内容 如果用户询问本技能能做什么，优先从以下列表回答。除非用户要求行动，否则不要探测本地机器。 - 安装 agentpay - 通过一键安装程序引导 agentpay 及 AgentPay 技能包 - 说明钱包是否可复用或需首次运行设置 - 指导用户完成本地钱包设置（自托管守护进程模式） - 导出、验证并恢复加密的离线钱包备份 - 检查余额，并在缺资金或 gas 时暂停 - 生成充值说明与二维码 - 发送原生资产、发送 ERC-20 代币、授权额度、广播交易 - 支付 x402 保护的 API（EIP-3009 签名） - 在任何 EVM 链上支付 MPP 保护的 API（任意链扣款，Tempo 会话） - 在相关时使用支持的插件式商户支付流程 - 在 TUI 中指导用户完成策略配置 - 将人工审批路由到本地管理员审批命令 - 展示待处理的人工审批并告知用户如何批准或拒绝 ## 权威来源 - 当示例冲突时，以 agentpay --help 及相关子命令帮助为准。 - 一键引导：curl -fsSL https://wlfi.sh | bash - 仅技能一键：curl -fsSL https://wlfi.sh | bash -s -- --skills-only - 一键更新：重新运行 curl -fsSL https://wlfi.sh | bash - 一键打包运行时捆绑包适用于 macOS 与 Linux。安装后两平台均支持托管钱包设置。 - 源码安装或更新：在仓库根目录执行 pnpm install && npm run build && npm run install:cli-launcher && npm run install:rust-binaries - 托管钱包引导命令如 agentpay admin setup、agentpay admin tui、agentpay admin reset 和 agentpay admin uninstall 均支持 macOS 与 Linux。托管守护进程在 macOS 使用 launchd，Linux 使用 systemd。Agent 认证存储在 macOS 使用钥匙串，Linux 使用 Secret Service。 - agentpay wallet --json 用于检查钱包是否可复用。 - agentpay admin setup 是 macOS 与 Linux 的首次钱包设置路径。 - 插件专属帮助位于当前 CLI 下。Bitrefill 使用 agentpay bitrefill --help。 - 本版本不支持基于浏览器的中继与网页审批。 - agentpay admin set-relay-config 与 agentpay admin get-relay-config 为遗留兼容命令，返回 unsupported。 - agentpay admin setup --reuse-existing-wallet 用于在保留当前 vault 的情况下重新设置托管守护进程。 - agentpay admin setup --restore-wallet-from 在 macOS 或 Linux 上从加密离线备份恢复同一钱包。 - agentpay admin wallet-backup export --output 创建加密离线备份。 - 不要使用 sudo agentpay ...。 - 不要告诉用户直接运行 agentpay daemon。 ## 钱包模型 AgentPay 使用自托管本地守护进程钱包。 - 在 macOS 或 Linux 设置：agentpay admin setup - 本地 Rust 守护进程管理密钥、策略执行、人工审批及钱包备份 - 支持 transfer、transfer-native、approve、broadcast、x402 和 mpp - 通过 agentpay mpp 可使用 Tempo 会话模式 ## 默认支付假设 - 默认网络：bsc - 未指定支付时的默认资产：USD1 - BSC 上默认 USD1 合约：0x8d0D000Ee44948FC98c9B98A4FA4921476f08B0d - BSC 上默认 gas 资产：BNB ## 安全输入规则 - 绝不要求用户在聊天中粘贴 VAULT_PASSWORD。 - 绝不要求用户在聊天中粘贴钱包备份密码。 - 绝不要求用户在聊天中粘贴插件会话材料，包括 Bitrefill cookie、验证码或浏览器会话数据。 - 绝不在代理内部收集或存储 vault 密码。 - 若流程需要 vault 输入，引导用户到安全本地提示。 - 首次设置时，告诉用户本地运行 agentpay admin setup 并按安全提示操作。 - 首次设置后，强烈建议使用 agentpay admin wallet-backup export --output ，除非用户已有验证过的备份。 - 针对已有钱包的守护进程恢复，告诉用户本地运行 agentpay admin setup --reuse-existing-wallet。 - 机器丢失或本地钱包丢失且用户有备份时，告诉其本地运行 agentpay admin setup --restore-wallet-from 。 - 策略修改默认使用 macOS 或 Linux 上的 agentpay admin tui。 - 人工审批优先使用本地管理员 CLI 审批命令。 - agentpay transfer --broadcast、agentpay transfer-native --broadcast、agentpay approve --broadcast 和 agentpay bitrefill buy --broadcast 在等待人工审批时保持原 CLI 进程存活。不要告诉用户在审批后重新运行这些命令。 - 若原广播命令已退出但请求已获批，使用 agentpay admin resume-manual-approval-request --approval-request-id 而非手动重建交易。 ## 确定性流程 1. 将请求分类为：解释能力、安装、设置钱包、备份钱包、恢复钱包、充值钱包、设置策略、发送原生资产、发送 ERC-20、授权额度、广播原始交易、支付 MPP API、插件式商户支付，或卸载。 2. 若用户仅询问本技能能做什么，从 本技能涵盖内容 回答并停止。 3. 钱包或支付工作先执行 agentpay config show --json。 4. 运行 agentpay wallet --json 检查钱包状态。 5. 若钱包不可用且任务需要钱包，告诉用户本地运行 agentpay admin setup。 6. 若钱包存在但用户需在不改动 vault 的情况下重新设置，使用 agentpay admin setup --reuse-existing-wallet。 7. 若用户在新机器灾难恢复且有加密备份，使用 agentpay admin setup --restore-wallet-from 。 8. 策略配置默认使用 agentpay admin tui。 9. 若请求进入人工审批队列，告知用户其待审批，并使用本地管理员 CLI 审批命令。 10. 对于 transfer --broadcast、transfer-native --broadcast、approve --broadcast 和 bitrefill buy --broadcast，告诉用户审批时保持原命令运行。 11. 插件式商户支付使用相关当前 CLI 插件流程。若用户明确使用 Bitrefill，或请求支付仅接受卡的传统商户且 Bitrefill 为支持路径，则使用 Bitrefill。 12. 若用户未指定支付网络或资产，默认填充 bsc 和 USD1 后再问后续问题。 13. 任何出站操作前检查资金。 14. 若资金不足，暂停并让用户充值。 15. 然后执行确切的当前 CLI 命令。 ## 资金规则 - 新钱包在余额验证前视为未充值。 - 原生转账检查原生余额。 - ERC-20 转账与授权需同时检查代币余额与原生 gas 余额。 - Bitrefill 购买前检查结算资产与所选 EVM 链的原生 gas 资产。 - 默认路径告知用户可能需要 USD1 作价值、BNB 作 gas。 - 资金不足时提供： - 钱包地址 - 网络及链 ID - 所需价值资产（如相关） - 所需 gas 资产 - 充值 URI - 若主机支持 markdown 图片则渲染二维码 - 备用 qrUrl ## Bitrefill 插件规则 - 对于仅接受卡的传统商户支付，使用 bitrefill。 - 若商户存在于 bitrefill，直接购买礼品卡。 - 否则购买预付 VISA 卡。 - 本仓库的 Bitrefill 仅支持 EVM，请勿提议比特币、闪电网络、Solana 或其他非 EVM 结算方式。 - 默认先用 agentpay bitrefill buy ... 预览，用户确认支付后再加 --broadcast。 - Bitrefill 报价与预览输出中，amount 为链上原生单位整数，非人类可读小数。示例：ETH 单位为 wei，amount: 1000000 且 decimals: 6 表示 1 USDC。 - agentpay bitrefill buy --broadcast 通过现有 Rust 守护进程签名路径支付，非独立钱包流程。 - 若 Bitrefill 触发浏览器挑战，让 CLI 启动本地浏览器会话，用户本地完成挑战。 - Bitrefill 结账仍遵循本技能的正常资金与人工审批规则。 ## 当前命令格式 - 钱包检查：agentpay wallet --json - macOS 或 Linux 设置：agentpay admin setup - 设置恢复时复用现有钱包：agentpay admin setup --reuse-existing-wallet - 从加密备份恢复钱包：agentpay admin setup --restore-wallet-from - 导出加密钱包备份：agentpay admin wallet-backup export --output - 验证加密钱包备份：agentpay admin wallet-backup verify - 原生转账：agentpay transfer-native --network --to

--amount - ERC-20 转账：agentpay transfer --network --token --to --amount - 授权：agentpay approve --network --token --spender --amount - 策略检查的原始请求：agentpay broadcast --network --to --value-wei ... - 签名并发送：agentpay tx broadcast --network --rpc-url --from --to --value-wei ... - macOS 或 Linux 策略编辑：agentpay admin tui - 为现有钱包设置默认代币限额并实时同步：agentpay admin token set-chain --per-tx --daily --weekly [--vault-password-stdin] [--non-interactive] - 人工审批策略：agentpay admin add-manual-approval-policy --network --min-amount-wei --max-amount-wei ... - 人工审批队列：agentpay admin list-manual-approval-requests - 人工审批决策：agentpay admin approve-manual-approval-request 或 agentpay admin reject-manual-approval-request - 恢复已批准的广播相关人工审批：agentpay admin resume-manual-approval-request --approval-request-id - Bitrefill 搜索：agentpay bitrefill search --query - Bitrefill 产品：agentpay bitrefill product --slug - Bitrefill 购买报价：agentpay bitrefill buy --slug --amount [--payment-method ] - Bitrefill 报价字段：availablePaymentMethods[].amount 为链上原生单位整数。 - Bitrefill 购买并支付：agentpay bitrefill buy --slug --amount --payment-method --email --broadcast [--no-wait] - Bitrefill 预览支付字段：payment.amount 为链上原生单位整数。 - Bitrefill 发票列表：agentpay bitrefill invoice list - Bitrefill 发票查询：agentpay bitrefill invoice get --invoice-id [--access-token ] - Bitrefill 发票等待：agentpay bitrefill invoice wait --invoice-id [--access-token ] [--timeout ] ## 策略规则 - 不要提开放式策略问题。 - 将用户请求映射为以下之一： - 保持现有策略 - 在 TUI 中收紧默认代币限额 - 在 TUI 中添加人工审批区间 - 检查或解决人工审批请求 - 策略工作默认使用 agentpay admin tui。 - 若用户明确需要默认代币限额的精确 CLI 命令，使用 agentpay admin token set-chain ...；它更新保存的配置并尝试刷新现有钱包的实时守护进程附件。 - agentpay admin token set-chain ... 需要本地 vault 密码提示或 --vault-password-stdin。若实时应用失败，不要声称保存的配置或守护进程策略已更改。 - 目的地特定覆盖为 TUI 路径。除非用户实际完成 TUI，否则不要声称已应用。 - 不要在聊天中索要 VAULT_PASSWORD 做策略工作。若 CLI 或 UI 本地提示，则该安全提示发生在聊天外。 ## 人工审批规则 - 将人工审批命中视为待处理，而非失败。 - 告知用户请求正等待其批准。 - 优先使用本地管理员 CLI 审批命令。 - 对于 transfer --broadcast、transfer-native --broadcast、approve --broadcast 和 bitrefill buy --broadcast，告知用户批准后不要重新运行原命令。CLI 每 2 秒轮询，最长 5 分钟，同一审批请求获批后自动继续。 - 若原广播命令在批准后已退出，使用 agentpay admin resume-manual-approval-request --approval-request-id 。 - agentpay broadcast 及其他非自动等待流程仍会打印审批详情并退出。 - 若用户明确索要原始 CLI 命令，使用： - agentpay admin list-manual-approval-requests - agentpay admin approve-manual-approval-request --approval-request-id - agentpay admin resume-manual-approval-request --approval-request-id - agentpay admin reject-manual-approval-request --approval-request-id --rejection-reason ## 最小澄清规则 - 若用户说“send money”且未指定网络或资产，不要先问它们，直接使用默认值。 - 仅询问剩余关键字段： - 金额 - 接收方 - spender ## MPP 服务 AgentPay 可使用 agentpay mpp 为任何启用 MPP 的 API 付费，无需 API 密钥或账户——通过 HTTP 402 协议内联支付。CLI 从服务器挑战中解析支付链，并支持任何 EVM 兼容网络。 - 从 https://mpp.dev/services/llms.txt 发现当前 MPP LLM/搜索服务，不要依赖静态仓库服务目录。 - --amount 可选。省略时 CLI 自动支付服务器挑战金额；提供时 CLI 先验证挑战金额是否匹配再支付。 - 钱包必须持有服务挑战指定的链上的支付代币。 - mpp 支持任意 EVM 兼容链扣款。 - 会话模式（托管通道）仅 Tempo 支持。 ## 额外参考 - 仅在需要精确标志或示例时阅读 references/capabilities.md。 - 仅在需要简短实时演示脚本时阅读 references/demo-walkthrough.md。