A powerful Bitcoin Lightning payment CLI and self-custodial wallet designed specifically for AI agents and automated workflows.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install bitkit-cli
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install bitkit-cli using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Bitkit CLI?
Bitkit CLI is a specialized tool that enables AI agents to interact with the Bitcoin Lightning Network through a robust, JSON-native interface. As a key component in the ecosystem of Openclaw Skills, it provides full self-custody over funds, supporting BOLT 11 invoices, LNURL, and Lightning Addresses. It streamlines liquidity management through the Blocktank LSP, allowing agents to easily order inbound capacity without manual peer management.
By leveraging the Lightning Development Kit (LDK), Bitkit CLI offers a high-performance daemon mode that minimizes startup latency. This makes it ideal for high-frequency automated environments where agents need to pay or receive micro-payments instantly. The skill also integrates the Pubky network for secure, end-to-end encrypted messaging, allowing agents to negotiate terms or exchange invoices privately.
Bitkit CLI Use Cases
- Automated payment processing for AI agent services and digital micro-transactions.
- Establishing self-custodial Bitcoin wallets for autonomous digital entities.
- Sending and receiving end-to-end encrypted messages via the Pubky network.
- Managing Lightning Network liquidity and channel opening through seamless LSP integration.
- Building autonomous e-commerce bots that handle both on-chain and Lightning payments.
How Bitkit CLI Works
- The agent initializes a local wallet with a BIP39 seed phrase stored as plaintext or encrypted for secure operations.
- A persistent background daemon is started to ensure instant command execution and provide a local HTTP API.
- The agent generates a fresh Bitcoin address to fund the internal on-chain wallet.
- Lightning liquidity is secured by ordering an inbound channel from an LSP, ensuring the agent can receive payments.
- The agent creates or pays BOLT 11 invoices, LNURLs, or Lightning Addresses to participate in the network.
- Real-time notifications for payment arrivals or channel state changes are handled via webhooks or WebSockets.
Bitkit CLI Setup
To install Bitkit CLI for use with Openclaw Skills, run the following command:
curl -sSL https://raw.githubusercontent.com/synonymdev/bitkit-cli/main/install.sh | sh
Initialize your wallet (recommended to use plaintext for autonomous agent use):
bk init --no-password --json
Start the background daemon to enable the HTTP API and speed up execution:
bk start --json
Bitkit CLI Data Schema & Taxonomy
Bitkit CLI organizes its data within a configurable directory, typically ~/.bitkit/. The structure includes critical security and configuration files:
| File | Description |
|---|---|
seed.enc |
Encrypted or plaintext BIP39 seed storage |
api-password |
Auto-generated 64-character hex password for the HTTP API |
config.toml |
Node configuration including network, sync sources, and webhooks |
[network]/ |
Directory containing network-specific databases and channel state |
All CLI outputs follow a standard JSON envelope structure:
ok: Boolean indicating success.data: Object containing the successful payload.error: String containing error details (on failure).code: Integer representing the exit code.
Bitkit CLI Advanced Features
- Daemon Mode: Provides an HTTP API and persistent LDK node state for ultra-fast command execution.
- Pubky Messaging: Built-in end-to-end encrypted messaging for secure agent-to-agent communication protocol.
- Auto-Liquidity: Background monitor that automatically triggers LSP channel orders when inbound capacity is low.
- Webhooks & WebSockets: Real-time event streaming for automated response to payments and channel lifecycle updates.
- Multi-Wallet Support: Ability to run multiple independent agents on the same machine using unique data directories.
SKILL.md
Loading
Related Openclaw Skills
Immortal Brain: Proactive Autonomous AI Agent
A highly autonomous AI agent that independently manages the full lifecycle of tasks through proactive research, planning, and execution.
Tesla Commands
A specialized tool for controlling Tesla vehicle climate, charging limits, and schedules through the MyTeslaMate API.
Nordpool Finland Energy Prices
A specialized tool for fetching real-time Finnish electricity prices and identifying the cheapest windows for EV charging.
Unit Converter
A versatile CLI-based utility for converting between metric, imperial, and digital measurement systems.
Add Agent
The Add Agent skill automates the deployment of new, isolated agents with dedicated Telegram bots and synchronized resources.
Seedream Image Generation
A high-performance AI image generation tool for Openclaw Skills using the Seedream API and Doubao-Seedream models.
Featured*
