# Send agent-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. 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. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "mdk-agent-wallet",
    "name": "agent-wallet",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/satbot-mdk/mdk-agent-wallet",
    "canonicalUrl": "https://clawhub.ai/satbot-mdk/mdk-agent-wallet",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/mdk-agent-wallet",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=mdk-agent-wallet",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "mdk-agent-wallet",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-04T16:30:18.350Z",
      "expiresAt": "2026-05-11T16:30:18.350Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=mdk-agent-wallet",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=mdk-agent-wallet",
        "contentDisposition": "attachment; filename=\"mdk-agent-wallet-0.3.3.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "mdk-agent-wallet"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/mdk-agent-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/mdk-agent-wallet",
    "downloadUrl": "https://openagent3.xyz/downloads/mdk-agent-wallet",
    "agentUrl": "https://openagent3.xyz/skills/mdk-agent-wallet/agent",
    "manifestUrl": "https://openagent3.xyz/skills/mdk-agent-wallet/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/mdk-agent-wallet/agent.md"
  }
}
```
## Documentation

### agent-wallet

Self-custodial Lightning wallet for AI agents, built by MoneyDevKit. One command to init. All output is JSON.

Source: @moneydevkit/agent-wallet on npm · GitHub

### Security & Transparency

This skill runs @moneydevkit/agent-wallet — an npm package published by MoneyDevKit. What it does:

Generates and stores a BIP39 mnemonic at ~/.mdk-wallet/config.json — this IS your private key. Treat it like a password.
Runs a local daemon on localhost:3456 — HTTP server for wallet operations. Binds to localhost only (not externally accessible).
Connects outbound to MDK's Lightning infrastructure.
Persists payment history to ~/.mdk-wallet/.

No data is sent to external servers beyond standard Lightning protocol operations. You can verify this by inspecting the source code or the published npm tarball.

Recommended: Pin a version (npx @moneydevkit/agent-wallet@0.11.0) in production.

### Quick Start

# Initialize wallet (generates mnemonic)
npx @moneydevkit/agent-wallet init

# Get balance
npx @moneydevkit/agent-wallet balance

# Create invoice
npx @moneydevkit/agent-wallet receive 1000

# Pay someone
npx @moneydevkit/agent-wallet send user@getalby.com 500

### How It Works

The CLI automatically starts a daemon on first command. The daemon:

Runs a local HTTP server on localhost:3456
Connects to MDK's Lightning infrastructure
Polls for incoming payments every 30 seconds
Persists payment history to ~/.mdk-wallet/

No webhook endpoint needed — the daemon handles everything locally.

### First-time initialization

npx @moneydevkit/agent-wallet init

This command:

Generates a BIP39 mnemonic — 12-word seed phrase that IS your wallet
Creates config at ~/.mdk-wallet/config.json
Derives a walletId — deterministic 8-char hex ID from your mnemonic
Starts the daemon — local Lightning node on port 3456

The wallet is ready immediately. No API keys, no signup, no accounts. The agent holds its own keys.

### View existing config

npx @moneydevkit/agent-wallet init --show

Returns { "mnemonic": "...", "network": "mainnet", "walletId": "..." }.

Note: init will refuse to overwrite an existing wallet. To reinitialize:

npx @moneydevkit/agent-wallet stop
rm -rf ~/.mdk-wallet  # WARNING: backup mnemonic first!
npx @moneydevkit/agent-wallet init

### Commands

All commands return JSON on stdout. Exit 0 on success, 1 on error.

CommandDescriptioninitGenerate mnemonic, create configinit --showShow config (mnemonic redacted)startStart the daemonbalanceGet balance in satsreceive <amount>Generate invoicereceiveGenerate variable-amount invoicereceive <amount> --description "..."Invoice with custom descriptionreceive-bolt12Generate a BOLT12 offer (variable amount, reusable)send <destination> [amount]Pay bolt11, bolt12, lnurl, or lightning addresspaymentsList payment historystatusCheck if daemon is runningstopStop the daemonrestartRestart the daemon

### Balance

npx @moneydevkit/agent-wallet balance

→ { "balance_sats": 3825 }

### Receive (generate invoice)

# Fixed amount
npx @moneydevkit/agent-wallet receive 1000

# Variable amount (payer chooses)
npx @moneydevkit/agent-wallet receive

# With description
npx @moneydevkit/agent-wallet receive 1000 --description "payment for service"

→ { "invoice": "lnbc...", "payment_hash": "...", "expires_at": "..." }

### Receive BOLT12 Offer

npx @moneydevkit/agent-wallet receive-bolt12

→ { "offer": "lno1..." }

BOLT12 offers are reusable and don't expire — share one offer and receive unlimited payments to it. Unlike BOLT11 invoices, the payer chooses the amount.

### Send

npx @moneydevkit/agent-wallet send <destination> [amount_sats]

Destination auto-detection:

bolt11 invoice: lnbc10n1... (amount encoded, no arg needed)
bolt12 offer: lno1...
lightning address: user@example.com
LNURL: lnurl1...

For lightning addresses and LNURL, amount is required:

npx @moneydevkit/agent-wallet send user@getalby.com 500

### Payment History

npx @moneydevkit/agent-wallet payments

→ { "payments": [{ "paymentHash": "...", "amountSats": 1000, "direction": "inbound"|"outbound", "timestamp": ..., "destination": "..." }] }

### Upgrading

# Stop the running daemon
npx @moneydevkit/agent-wallet stop

# Run with @latest to pull the newest version
npx @moneydevkit/agent-wallet@latest start

Your wallet config and payment history in ~/.mdk-wallet/ are preserved across upgrades.

### Usage Notes

Denomination: use ₿ prefix with sats (e.g. ₿1,000 not "1,000 sats")
Self-custodial: the mnemonic IS the wallet. Back it up. Lose it, lose funds.
Daemon: runs a local Lightning node on :3456. Auto-starts, persists to disk.
Agent-to-agent payments: any agent with this wallet can pay any other agent's invoice or lightning address.

### What's Next?

Want to accept payments from customers? Use the moneydevkit skill to add checkouts to any website. Agent-wallet handles agent-to-agent payments; moneydevkit handles customer-to-agent payments. Together they give your agent full payment superpowers.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: satbot-mdk
- Version: 0.3.3
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-04T16:30:18.350Z
- Expires at: 2026-05-11T16:30:18.350Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/mdk-agent-wallet)
- [Send to Agent page](https://openagent3.xyz/skills/mdk-agent-wallet/agent)
- [JSON manifest](https://openagent3.xyz/skills/mdk-agent-wallet/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/mdk-agent-wallet/agent.md)
- [Download page](https://openagent3.xyz/downloads/mdk-agent-wallet)