核心功能
agent-wallet 是由 MoneyDevKit 开发的自托管式比特币闪电网络钱包，专为 AI 代理设计。该工具允许代理在无需人工干预的情况下自主管理比特币资金，执行收发付款、生成发票、查询余额等操作。
显著优点
1. 真正的自托管架构：钱包生成并本地存储 BIP39 助记词（~/.mdk-wallet/config.json），代理完全掌控私钥，无需依赖第三方托管服务。
2. 零配置体验：单命令 npx @moneydevkit/agent-wallet init 即可完成初始化，自动生成助记词、派生钱包 ID、启动本地守护进程，无需 API 密钥或账户注册。
3. 完整的闪电网络协议支持：兼容 BOLT11 发票、BOLT12 可重用报价、LNURL 和闪电地址（Lightning Address），覆盖当前主流闪电网络支付场景。
4. 本地守护进程设计：在 localhost:3456 运行 HTTP 服务，仅绑定本地接口，不外露于公网；自动轮询入账（每30秒），无需配置 Webhook。
5. JSON 标准化输出：所有命令返回结构化 JSON，便于代理程序解析处理。
潜在局限与风险
- 助记词安全管理：私钥以明文形式存储于本地文件系统，若运行环境权限配置不当或遭遇系统入侵，存在资金被盗风险。强烈建议备份助记词并严格限制
~/.mdk-wallet/目录权限。
- 单点故障：本地守护进程若崩溃或端口冲突（3456被占用），钱包服务将中断。需自行监控进程状态。
- 依赖 MoneyDevKit 基础设施：出站连接依赖 MDK 的闪电网络基础设施，存在第三方服务可用性风险（尽管私钥始终本地掌控）。
- npm 供应链风险：通过
npx执行，需信任 npm 包来源。建议生产环境锁定具体版本号。
适合人群
- 需要自主收发比特币的 AI 代理开发者
- 追求自托管、抗审查支付方案的技术团队
- 构建代理间价值交换系统的开发者
- 熟悉闪电网络基础概念的比特币用户
常规风险提示
⚠️ 资金安全风险：助记词即资金本身，丢失或泄露将导致不可逆损失。
⚠️ 测试环境建议：首次使用建议先用少量资金验证流程。
⚠️ 版本锁定：生产环境务必使用 npx @moneydevkit/agent-wallet@<version> 指定版本，避免自动更新引入未审计代码。
⚠️ 备份义务：init 完成后立即备份助记词，系统不提供恢复机制。