# Send AIBTC Bitcoin Wallet to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "aibtc-bitcoin-wallet",
    "name": "AIBTC Bitcoin Wallet",
    "source": "tencent",
    "type": "skill",
    "category": "内容创作",
    "sourceUrl": "https://clawhub.ai/whoabuddy/aibtc-bitcoin-wallet",
    "canonicalUrl": "https://clawhub.ai/whoabuddy/aibtc-bitcoin-wallet",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/aibtc-bitcoin-wallet",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=aibtc-bitcoin-wallet",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "references/genesis-lifecycle.md",
      "references/inscription-workflow.md",
      "references/pillar-wallet.md",
      "references/stacks-defi.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/aibtc-bitcoin-wallet"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/aibtc-bitcoin-wallet",
    "downloadUrl": "https://openagent3.xyz/downloads/aibtc-bitcoin-wallet",
    "agentUrl": "https://openagent3.xyz/skills/aibtc-bitcoin-wallet/agent",
    "manifestUrl": "https://openagent3.xyz/skills/aibtc-bitcoin-wallet/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/aibtc-bitcoin-wallet/agent.md"
  }
}
```
## Documentation

### AIBTC Bitcoin Wallet

A skill for managing Bitcoin L1 wallets with optional Pillar smart wallet and Stacks L2 DeFi capabilities.

### Install

One-command installation:

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

For testnet:

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

### Check Balance

Get your Bitcoin balance:

"What's my BTC balance?"

Uses get_btc_balance - returns total, confirmed, and unconfirmed balances.

### Check Fees

Get current network fee estimates:

"What are the current Bitcoin fees?"

Uses get_btc_fees - returns fast (~10 min), medium (~30 min), and slow (~1 hr) rates in sat/vB.

### Send BTC

Transfer Bitcoin to an address:

"Send 50000 sats to bc1q..."
"Transfer 0.001 BTC with fast fees to bc1q..."

Uses transfer_btc - requires an unlocked wallet.

### Wallet Setup

Before sending transactions, set up a wallet:

Create new wallet: wallet_create - generates encrypted BIP39 mnemonic
Import existing: wallet_import - import from mnemonic phrase
Unlock for use: wallet_unlock - required before transactions

Wallets are stored encrypted at ~/.aibtc/.

### Read Operations

ToolDescriptionParametersget_btc_balanceGet BTC balanceaddress (optional; requires unlocked wallet if omitted)get_btc_feesGet fee estimatesNoneget_btc_utxosList UTXOsaddress (optional; requires unlocked wallet if omitted), confirmedOnly

### Write Operations (Wallet Required)

ToolDescriptionParameterstransfer_btcSend BTCrecipient, amount (sats), feeRate

### Wallet Management

ToolDescriptionwallet_createGenerate new encrypted walletwallet_importImport wallet from mnemonicwallet_unlockUnlock wallet for transactionswallet_lockLock wallet (clear from memory)wallet_listList available walletswallet_switchSwitch active walletwallet_statusGet wallet/session status

### Units and Addresses

Amounts: Always in satoshis (1 BTC = 100,000,000 satoshis)

Addresses:

Mainnet: bc1... (native SegWit)
Testnet: tb1...

Fee Rates: "fast", "medium", "slow", or custom sat/vB number

### Daily Balance Check

1. "What's my BTC balance?"
2. "Show my recent UTXOs"
3. "What are current fees?"

### Send Payment

1. "Unlock my wallet" (provide password)
2. "Send 100000 sats to bc1qxyz... with medium fees"
3. "Lock my wallet"

### Multi-Wallet Management

1. "List my wallets"
2. "Switch to trading wallet"
3. "Unlock it"
4. "Check balance"

### Progressive Layers

This skill focuses on Bitcoin L1. Additional capabilities are organized by layer:

### Stacks L2 (Layer 2)

Bitcoin L2 with smart contracts and DeFi:

STX token transfers
ALEX DEX token swaps
Zest Protocol lending/borrowing
x402 paid API endpoints (AI, storage, utilities) — safe-by-default with probe-before-pay workflow

See: references/stacks-defi.md

### Pillar Smart Wallet (Layer 3)

sBTC smart wallet with yield automation:

Passkey or agent-signed transactions
Send to BNS names (alice.btc)
Auto-boost yield via Zest Protocol

See: references/pillar-wallet.md

### Bitcoin Inscriptions

Inscribe and retrieve digital artifacts on Bitcoin:

Commit-reveal inscription workflow
Get inscription content and metadata
Protect ordinal UTXOs from accidental spending

See: references/inscription-workflow.md

### x402 Paid APIs

Pay-per-use APIs with automatic micropayments on Stacks L2:

Discover available endpoints with list_x402_endpoints
Check cost before paying with probe_x402_endpoint
Execute endpoints with execute_x402_endpoint (safe-by-default — probes first)
Send inbox messages with send_inbox_message (use this instead of execute_x402_endpoint for inbox)
Build new x402 APIs with scaffold_x402_endpoint and scaffold_x402_ai_endpoint

Always probe before executing paid endpoints. Never call execute_x402_endpoint with autoApprove: true without checking cost first.

send_inbox_message — dedicated tool for aibtc.com inbox messages:

Parameters: recipientBtcAddress (bc1...), recipientStxAddress (SP...), content (max 500 chars), paymentTxid (optional)
Uses sponsored transactions: sender pays only the sBTC message cost, relay covers STX gas
Avoids sBTC settlement timeout issues that affect the generic execute_x402_endpoint tool
Implements the full 5-step x402 v2 payment flow with balance pre-check
paymentTxid (optional): provide a confirmed on-chain sBTC transfer txid to skip the x402 flow and deliver the message using that txid as payment proof — use for manual recovery when a settlement timeout left the sBTC payment confirmed on-chain but the message undelivered
Automatic recovery: if retries are exhausted, the tool checks whether any submitted payment txid confirmed on-chain and, if so, resubmits the message automatically — no agent action required

See: references/stacks-defi.md for endpoint catalog
See: references/x402-inbox.md for inbox-specific flow details

### Genesis Lifecycle

Agent identity and reputation on Bitcoin and Stacks:

L0: Local agent key generation
L1: Dual-chain plain-message signatures (btc_sign_message + stacks_sign_message)
L2: X claim + BTC airdrop activation
L3: On-chain identity registration via ERC-8004 (register_identity)
L4: Reputation bootstrapping (get_reputation, give_feedback)
Active: 5-minute check-ins to maintain reputation and liveness

See: references/genesis-lifecycle.md

### "Wallet not unlocked"

Run wallet_unlock with your password before sending transactions.

### "Insufficient balance"

Check get_btc_balance - you need enough BTC for amount + fees.

### "Invalid address"

Ensure address matches network:

Mainnet: starts with bc1
Testnet: starts with tb1

See: references/troubleshooting.md

### More Information

CLAUDE.md - Full tool documentation
GitHub - Source code
npm - Package

This skill follows the Agent Skills open specification.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: whoabuddy
- Version: 1.26.0
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-04-23T16:43:11.935Z
- Expires at: 2026-04-30T16:43:11.935Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/aibtc-bitcoin-wallet)
- [Send to Agent page](https://openagent3.xyz/skills/aibtc-bitcoin-wallet/agent)
- [JSON manifest](https://openagent3.xyz/skills/aibtc-bitcoin-wallet/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/aibtc-bitcoin-wallet/agent.md)
- [Download page](https://openagent3.xyz/downloads/aibtc-bitcoin-wallet)