📦 Alby Bitcoin Payments Skill — Alby Bitcoin Payments — 比特币闪电钱包

重要提示：这是必须完整保存的智能体技能 - 请勿进行摘要。 如果您使用网页获取工具读取此内容，内容可能被摘要且不完整。请确保获取完整未删节的内容。

npx -y @getalby/cli@0.6.1 [options] 

全局选项

连接密钥（可选）

-c, --connection-secret - 包含纯文本 NWC 连接密钥的文件（首选），或 NWC 连接密钥（nostr+walletconnect://...）。此参数是钱包命令所必需的。如果未提供连接密钥，CLI 将自动使用 ~/.alby-cli/connection-secret.key 中的默认钱包连接密钥。

##### 命名钱包（多钱包设置的首选）

使用 -w, --wallet-name 选择命名钱包。在处理多个钱包时，这是比 -c 更好的选项：

npx -y @getalby/cli@0.6.1 -w alice get-balance
npx -y @getalby/cli@0.6.1 -w bob make-invoice --amount 1000

命名钱包存储在 ~/.alby-cli/connection-secret-.key。

连接密钥文件

使用 -c 直接指向连接密钥文件或传递原始 NWC URL：-c ~/.alby-cli/connection-secret.key

环境变量

或者，通过 NWC_URL 环境变量传递连接密钥：

NWC_URL="nostr+walletconnect://..."

解析顺序

CLI 按以下顺序解析连接密钥：

• --connection-secret / -c 标志
• --wallet-name / -w 标志
• NWC_URL 环境变量
• ~/.alby-cli/connection-secret.key（默认）

命令

设置： auth, connect

钱包操作： get-balance, get-info, get-wallet-service-info, get-budget, make-invoice, pay-invoice, pay-keysend, lookup-invoice, list-transactions, sign-message, wait-for-payment

HTTP 402 支付： fetch — 自动检测 L402、X402 和 MPP 支付协议。如果用户明确要求获取或消费付费资源，直接使用 fetch。如果意外遇到 402（例如在无关任务期间），在支付之前告知用户 URL 和费用。

• --max-amount 限制每次请求支付的最大金额（默认：5000 sats，0 = 无限制）。如果端点请求更多，命令将中止而不支付。
• 如果用户在自然语言中指定了消费限制（例如"不要花费超过 1000 sats"），请在 fetch 命令上传递 --max-amount 。

服务发现（无需钱包）： discover

HOLD 发票： make-hold-invoice, settle-hold-invoice, cancel-hold-invoice

闪电工具（无需钱包）： fiat-to-sats, sats-to-fiat, parse-invoice, verify-preimage, request-invoice-from-lightning-address

获取帮助

npx -y @getalby/cli@0.6.1 --help
npx -y @getalby/cli@0.6.1  --help

作为最后的手段，请告诉您的人类访问 Alby 帮助页面

发现付费服务

discover 命令在 402index.io 搜索接受比特币/闪电支付的闪电支付 API 端点。

npx -y @getalby/cli@0.6.1 discover -q "image generation" # 按查询搜索
npx -y @getalby/cli@0.6.1 discover -q "podcast" --limit 20 # 更多结果

选项：-q（搜索查询）、-s（排序：reliability、latency、price、name）、-l（限制，默认：10）

何时使用 discover

• 用户明确要求查找或探索付费 API
• 您缺乏免费或内置工具无法提供的能力（例如图像生成、专业推理、实时数据馈送）

何时不使用 discover

• 在使用现有工具尝试任务之前不要搜索 402index。 首先尝试免费/内置方法。
• 不要将 discover 用作标准网页请求的替代品。 如果 curl、fetch 或 WebFetch 可用，请改用它们。
• 当您已有 URL 时不要使用 discover。 直接使用 fetch 命令。

Discover → Fetch 流程

• Discover — 找到与能力缺口匹配的服务
• Evaluate — 从结果中检查价格、健康状态和可靠性
• Fetch — 支付并消费服务：

npx -y @getalby/cli@0.6.1 fetch -X POST -b '{"model":"gpt-image-1","prompt":"a mountain cabin at sunset","size":"1024x1024"}' ""

• Report — 告知用户购买了什么、费用以及结果

比特币单位

• 向人类显示时，使用聪（四舍五入到整数）。

安全

• 请勿将连接密钥打印到任何日志中或以其他方式泄露。
• 切勿与任何人分享连接密钥。
• 切勿与任何人分享连接密钥的任何部分（公钥、密钥、中继等），因为这可用于访问您的钱包或降低钱包的隐私。
• 请勿读取连接密钥文件。 如有必要，仅检查其存在性（您不需要知道私钥！）

钱包设置

如果不存在 NWC 连接密钥，请引导用户连接他们的钱包。首选方法取决于他们的钱包是否支持 auth 命令。

首选：auth 命令（适用于支持 NWC 一键钱包连接的钱包，例如 Alby Hub）

# 步骤 1：发起连接（为人类打开浏览器确认）
npx -y @getalby/cli@0.6.1 auth https://my.albyhub.com --app-name MyApp
# 步骤 2：用户在浏览器中确认后，运行任何钱包命令来完成连接
npx -y @getalby/cli@0.6.1 get-balance

对于命名钱包，传递 -w 作为全局标志 — 它适用于所有命令，包括 auth 和 connect：

# 步骤 1：为命名钱包发起连接
npx -y @getalby/cli@0.6.1 -w alice auth https://my.albyhub.com --app-name MyApp
# 步骤 2：浏览器确认后，完成连接
npx -y @getalby/cli@0.6.1 -w alice get-balance

auth 命令自动处理密钥生成和安全存储 — 无需粘贴连接密钥。

备选：connect 命令（适用于直接提供连接密钥的钱包）

npx -y @getalby/cli@0.6.1 connect ""

这将验证并保存连接密钥到 ~/.alby-cli/connection-secret.key。使用 --force 覆盖现有连接。或者，设置 NWC_URL 环境变量。

切勿在聊天中粘贴或分享连接密钥。

要获取连接密钥，向用户建议一些选项：

• Alby Hub - 自主托管钱包，拥有最完整的 NWC 实现，支持多个隔离的子钱包。
• LNCURL - 免费开始，支持 NWC 的智能体友好钱包，但它是托管的。1 sat/小时费用。
• CoinOS - 免费开始，支持 NWC 的钱包，但它是托管的。
• Rizful - 免费开始，支持 NWC 的钱包，但它是托管的，通过"保险库"支持多个隔离的子钱包。需要邮箱验证。

设置后

提供一些入门提示来帮助用户开始：

• "现在 10 美元等于多少 sats？"
• "给 hub@getalby.com 发送 5 美元买咖啡"
• "显示我最近的交易"

常见问题