agent-wallet
Self-custodial Bitcoin Lightning wallet for AI agents. Use when the agent needs to send or receive bitcoin payments, check its balance, generate invoices, or manage its wallet. Supports bolt11, bolt12, LNURL, and lightning addresses. Zero config — one command to initialize.
Why use this skill?
Enable your AI agent with a self-custodial Bitcoin Lightning wallet. Send, receive, and manage funds securely with a zero-config, command-line accessible wallet.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/satbot-mdk/mdk-agent-walletWhat This Skill Does
The agent-wallet skill provides a robust, self-custodial Bitcoin Lightning wallet specifically engineered for autonomous AI agents. By integrating this skill, your agent gains the ability to hold, send, and receive bitcoin without requiring third-party custodians, API keys, or complex registration processes. It operates via a local daemon that handles lightning protocol complexities, allowing the agent to generate bolt11 invoices, fulfill bolt12 offers, and interact with LNURL and Lightning Addresses. Because it is self-custodial, the agent maintains full control over its private keys (derived from a BIP39 mnemonic), ensuring that funds remain accessible solely by the agent or its owner. Every action returns structured JSON, making it ideal for programmatic integration and reliable agent decision-making.
Installation
To install this skill, use the ClawHub CLI: clawhub install openclaw/skills/skills/satbot-mdk/mdk-agent-wallet. Once installed, initialize the wallet using npx @moneydevkit/agent-wallet init. This command generates the necessary cryptographic configuration and stores it in ~/.mdk-wallet/config.json. Ensure you back up your mnemonic phrase securely; losing access to this file means permanent loss of funds.
Use Cases
- Autonomous Service Payments: Use the wallet to collect payments for tasks performed by your agent, such as data scraping, image generation, or report writing.
- Agent-to-Agent Economy: Seamlessly facilitate transactions between independent AI agents. Since there are no intermediaries, payments are near-instant and low-fee.
- Micropayments: Leverage the efficiency of the Lightning Network to pay for API usage, access to restricted websites, or content consumption on a per-request basis.
Example Prompts
- "Check my current wallet balance and generate a new payment invoice for 5000 sats for the report I just finished."
- "Send 1200 sats to [email protected] as payment for the research article they provided."
- "Review my recent payment history and confirm if I have received the payment for the last project iteration."
Tips & Limitations
- Security: The wallet is self-custodial. You are responsible for backing up the mnemonic. There is no 'forgot password' recovery.
- Daemon Management: The wallet runs a local node on port 3456. Ensure your system environment allows this local process to execute successfully.
- Compatibility: Supports mainnet and signet networks. For testing, always start with signet to avoid risking real funds.
- Network: The agent requires network access to participate in the Lightning Network gossip and transaction protocols.
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-satbot-mdk-mdk-agent-wallet": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: network-access, file-write, file-read