核心用法
agent-wallet 是一款面向AI代理的自托管比特币闪电网络钱包，由 MoneyDevKit 团队开发。核心设计哲学是"零配置、一键启动"——通过 npx @moneydevkit/agent-wallet@0.12.0 init 即可生成 BIP39 助记词并启动本地守护进程，无需API密钥、注册或账户体系。
关键操作流程：
- 初始化：
init命令生成12词助记词，存储于~/.mdk-wallet/config.json，派生8字符确定性钱包ID - 余额查询：
balance返回实时聪（sats）余额 - 收款：
receive <amount>生成BOLT11发票；receive-bolt12生成可重复使用的BOLT12优惠码 - 付款：
send <destination> [amount]自动识别bolt11/12发票、闪电地址、LNURL，智能路由支付 - Webhook通知：支持配置HTTP回调URL，实时推送到账通知，并可与OpenClaw集成实现聊天应用自动播报
显著优点
1. 真正的自托管：私钥（助记词）完全本地存储，永不离开设备，无第三方托管风险
2. 协议兼容全面：同时支持BOLT11（一次性发票）、BOLT12（可复用优惠）、LNURL、闪电地址四种主流格式
3. 零摩擦集成：单一npm包，无需编译依赖或复杂节点配置，JSON输出便于程序解析
4. 安全加固到位：守护进程仅绑定127.0.0.1，配置文件权限0600/0700，无遥测与分析上报
5. 实时通知架构：Webhook机制避免轮询，5秒内完成"付款到账→推送通知→聊天播报"全链路
潜在局限与风险
1. 主网资金风险：默认连接主网，助记词泄露或文件误删将导致真实BTC损失，无恢复机制
2. 单点故障：依赖本地守护进程（:3456），进程崩溃或端口冲突将导致支付功能中断
3. 供应链风险：通过npx动态拉取，若未锁定版本（建议@0.12.0）可能遭遇恶意更新
4. Webhook可靠性：回调为"fire-and-forget"模式，5秒超时无重试，网络波动可能丢通知
5. 基础设施依赖：需信任MDK的闪电网络基础设施完成链上结算，非完全去中心化方案
适合人群
- AI代理开发者：需要为agent赋予自主收发比特币能力的工程师
- 自动化支付场景：订阅服务、按量计费、机器经济（machine economy）等需程序化闪电支付的业务
- 隐私优先用户：拒绝托管交易所，坚持密钥自管的cypherpunk理念实践者
- OpenClaw生态用户：希望将到账通知自动推送至Signal/Telegram等聊天渠道的进阶玩家
常规风险
| 风险类型 | 具体表现 | 缓解建议 |
|---------|---------|---------|
| 密钥管理 | ~/.mdk-wallet/ 目录被未授权读取 | 备份助记词离线存储，设置文件权限0700 |
| 版本锁定 | npx @latest 引入恶意版本 | 生产环境固定版本号，如@0.12.0 |
| 网络钓鱼 | 伪造invoice或闪电地址诱骗付款 | 验证收款方身份，小额测试后再大额支付 |
| 守护进程安全 | 其他本地进程扫描localhost:3456 | 单用户环境运行，避免多租户共享主机 |