LNbits 钱包管理器

启用助手安全、高效地管理 LNbits 闪电网络钱包。

🛑 关键协议 🛑

1. 切勿泄露密钥：不得显示 Admin Keys（管理员密钥）、User IDs（用户 ID）或 Wallet IDs（钱包 ID）。
2. 明确确认机制：在执行支付操作前，必须向用户请求“是/否”确认。
   • 格式示例：“我即将向 [备注/目标地址] 发送 [金额] sats。是否继续？(y/n)”
3. 支付前先查余额：调用 pay 命令前，必须先调用 balance，以避免错误。
4. 生成发票时必须同时提供发票文本与 QR 码：生成发票时，你必须做到以下两点：(a) 显示 payment_request 文本，便于用户复制；(b) 在单独一行输出 MEDIA: 后紧跟 qr_file 路径。此步骤严禁跳过。

使用方法

0. 初始化 / 创建钱包

若用户尚未拥有 LNbits 钱包，你可在演示服务器上为其创建一个。

python3 {baseDir}/scripts/lnbits_cli.py create --name "My Wallet"

操作说明：

1. 运行该命令。CLI 将以 JSON 格式在标准输出（终端中可见）打印包含 adminkey 和 base_url 的信息。
2. 切勿泄露密钥（本场景同样适用）：不得在聊天回复中重复、引用或展示输出中的 adminkey 或任何其他敏感字段。用户可在其本地终端中看到命令输出——该密钥仅应在此处出现。
3. 仅以自然语言向用户说明，例如：

   “已创建新钱包。上方命令输出中包含你的 adminkey 和 base_url。请从终端中复制这两个值，并将其分别填入配置文件或 .env 中的 LNBITS_API_KEY 和 LNBITS_BASE_URL 字段。请勿将 adminkey 粘贴至本对话或其他任何聊天窗口中。”

1. 查询余额

获取当前钱包余额（单位：sats）。

python3 {baseDir}/scripts/lnbits_cli.py balance

2. 创建发票（收款）

生成 Bolt11 发票用于接收资金。默认始终附带 QR 码。

• amount：金额（单位：sats，整数）。
• memo：可选描述信息。
• --no-qr：跳过 QR 码生成（如无需 QR 码）。

# 默认生成带 QR 码的发票
python3 {baseDir}/scripts/lnbits_cli.py invoice --amount 1000 --memo "Pizza"

# 不生成 QR 码的发票
python3 {baseDir}/scripts/lnbits_cli.py invoice --amount 1000 --memo "Pizza" --no-qr

⚠️ 强制响应格式：生成发票时，你的回复必须包含以下两项：

1. 可复制的发票文本：完整显示 payment_request 字符串，供用户复制
2. QR 码图像：在单独一行输出 MEDIA: 后紧跟 qr_file 路径

精确格式要求（请严格遵循）：

这是你的 100 sats 发票：

lnbc1u1p5abc123...

MEDIA:./clawd/.lnbits_qr/invoice_xxx.png

关键要求：MEDIA: 与文件路径必须位于同一行。该格式将触发 QR 码图像发送给用户。

2b. 为已有发票生成 QR 码

将任意 Bolt11 字符串转换为 QR 码图像文件。

python3 {baseDir}/scripts/lnbits_cli.py qr 

返回结果示例：{"qr_file": "./.lnbits_qr/invoice_xxx.png", "bolt11": "..."}

3. 支付发票（付款）

⚠️ 必须经用户确认：需先解码验证金额与备注、再检查余额、获得用户确认后，方可执行支付。

# 步骤 1：解码以验证金额与备注
python3 {baseDir}/scripts/lnbits_cli.py decode 

# 步骤 2：支付（仅在用户确认后执行）
python3 {baseDir}/scripts/lnbits_cli.py pay 

错误处理

若 CLI 返回 JSON 错误（例如：{"error": "Insufficient funds"}），请向用户清晰摘要该错误信息，不得显示原始堆栈跟踪（stack trace）。