aibtc-bitcoin-wallet

What This Skill Does

The aibtc-bitcoin-wallet is a powerful Bitcoin L1 management skill for the OpenClaw AI agent. It allows agents to interact directly with the Bitcoin blockchain, providing capabilities to create and manage wallets, query balances and UTXOs, and execute transactions. Beyond simple L1 transfers, it serves as the foundational layer for complex agentic workflows, including Stacks L2 integration, DeFi operations, and interactions with sBTC yield-generating smart wallets. By abstracting the complexities of BIP39 key management, UTXO selection, and fee estimation, it enables agents to act as autonomous financial controllers for their users.

Installation

Installation is streamlined via Node Package Manager (NPM). For mainnet usage, execute the following command in your terminal:

npx @aibtc/mcp-server@latest --install

If you are developing or testing applications, use the testnet flag:

npx @aibtc/mcp-server@latest --install --testnet

This command registers the server with OpenClaw and prepares the secure storage directory at ~/.aibtc/.

Use Cases

This skill is designed for high-frequency financial tasks where manual intervention is inefficient. Typical use cases include:

• Automated Treasury Management: Agents can monitor specific addresses for incoming payments and trigger responses.
• Portfolio Rebalancing: Agents can move BTC between internal wallets or bridge funds to Stacks L2 for yield generation.
• Transaction Optimization: Agents can fetch real-time network fees to optimize transaction costs based on urgency, selecting 'fast', 'medium', or 'slow' tiers.
• Secure Key Handling: Agents maintain local encrypted storage, ensuring that private keys never leave the host machine while remaining available for programmatic signing.

Example Prompts

1. "What is the current balance of my active wallet and show me the network fee estimates for a fast transaction?"
2. "Unlock the trading wallet and send 50,000 sats to bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh with medium fee rates."
3. "List all my available wallets and switch to the primary account to check my confirmed balance."

Tips & Limitations

• Safety First: Always lock your wallet using wallet_lock after completing transactions to prevent unauthorized access.
• Unit Awareness: All amounts are processed in satoshis (1 BTC = 100,000,000 sats). Ensure your logic handles conversions accurately to avoid accidental overpayment.
• Fees: Fee rates are estimated based on current network congestion. High-priority transactions should always explicitly request a 'fast' fee setting.
• Persistence: While local storage is encrypted, ensure the server hosting the agent has appropriate file-level permissions to protect the ~/.aibtc/ directory.