Alby 比特币闪电支付

要解决什么问题

AI Agent 在帮用户完成真实任务时，常会碰到两类和钱相关的缺口：需要用自己的 Lightning 钱包付款或收款，以及访问标了 HTTP 402 的付费 API（L402、X402、MPP 等）。这类操作不能靠「猜 CLI 参数」完成——文档明确要求在拼命令前先跑 npx -y @getalby/cli@0.8.0 --help，只使用帮助里列出的 flag。

本技能把 Alby CLI + Nostr Wallet Connect（NWC） 的用法写成 Agent 可执行的流程：连钱包、查余额、发收款、拉流水，以及在用户明确要消费付费资源时走 fetch，必要时再用 discover 在 402index.io 上找 Lightning 可付的服务。

技能如何工作

连接与密钥解析顺序（无需把 connection secret 读进对话）：--connection-secret / -c → 命名钱包 --wallet-name / -w（~/.alby-cli/connection-secret-<name>.key）→ 环境变量 NWC_URL → 默认 ~/.alby-cli/connection-secret.key。未配置时引导 auth（支持一键 NWC 的钱包，如 Alby Hub）或 connect。

常用钱包命令：pay（闪电地址、BOLT-11、keysend，以及从闪电余额出资的链上/稳定币地址）、receive（闪电地址或按金额开票）、get-balance、list-transactions；另有 HOLD 发票、sign-message、wait-for-payment 等。

402 与发现：fetch 自动识别付费协议；若任务无关却遇到 402，应先告知用户 URL 与费用再付。discover 仅在没有免费/内置能力、且用户要探索付费 API 时使用——不要在每次任务前盲目搜 402index，已有 URL 则直接 fetch。

展示金额对人用 sats；法币换算避免过多小数位。

边界与安全

• 绝不在日志或聊天中打印、粘贴 connection secret 的任何片段（含 pubkey、relay 等）。
• 不要读取 secret 文件内容；必要时只检查文件是否存在。
• 无内置钱包时可建议 Alby Hub、LNCURL、CoinOS、Rizful 等，并说明托管/自托管差异。
• 常见故障：未连接钱包、中继超时、余额不足、402 发票过期或超过 fetch 单笔上限——按表对症重试或调高/调低最大支出。