# Send Nostr Wallet Connect (NWC) bridge for mdk-agent-wallet, which is self-custodial Bitcoin Lightning wallet for AI agents. 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": "agent-wallet-nwc-bridge",
    "name": "Nostr Wallet Connect (NWC) bridge for mdk-agent-wallet, which is self-custodial Bitcoin Lightning wallet for AI agents.",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/kristapsk/agent-wallet-nwc-bridge",
    "canonicalUrl": "https://clawhub.ai/kristapsk/agent-wallet-nwc-bridge",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/agent-wallet-nwc-bridge",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=agent-wallet-nwc-bridge",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "package.json",
      "index.js",
      "README.md",
      "agent-wallet-nwc-bridge.service",
      "package-lock.json",
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.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/agent-wallet-nwc-bridge"
    },
    "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/agent-wallet-nwc-bridge",
    "downloadUrl": "https://openagent3.xyz/downloads/agent-wallet-nwc-bridge",
    "agentUrl": "https://openagent3.xyz/skills/agent-wallet-nwc-bridge/agent",
    "manifestUrl": "https://openagent3.xyz/skills/agent-wallet-nwc-bridge/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/agent-wallet-nwc-bridge/agent.md"
  }
}
```
## Documentation

### agent-wallet-nwc-bridge (skill)

This skill provides a small, self-hosted Nostr Wallet Connect (NIP-47) bridge that lets an NWC client (e.g. Stacker.News) send make_invoice / pay_invoice requests to a local @moneydevkit/agent-wallet.

It is intended to be run as a systemd user service.

### What you get

index.js bridge implementation
portable agent-wallet-nwc-bridge.service unit (uses %h)
installer script install_systemd_user.sh
env + state files (nwc.env, state.json) stored locally (not committed)

### Requirements

Linux with systemd user services
Node.js + npm
Nostr relay access (default example uses wss://nos.lol)

### Install

git clone https://github.com/kristapsk/agent-wallet-nwc-bridge
cd agent-wallet-nwc-bridge

npm install
cp -n nwc.env.example nwc.env

# initialize state + create wallet service pubkey
node index.js init --relay wss://nos.lol

# install + start as user service
./install_systemd_user.sh

# follow logs
journalctl --user -u agent-wallet-nwc-bridge.service -f

### Configure

Edit nwc.env:

NWC_RELAYS — comma-separated relay list (e.g. wss://nos.lol,wss://relay.damus.io)
NWC_STATE — defaults to state.json (relative to WorkingDirectory)
NWC_AUTO_REGISTER — 0 recommended (use explicit URIs/permissions)
NWC_DEFAULT_BUDGET_SATS — default spending cap when generating URIs

Security note: state.json contains NWC connection secrets. Do not commit it.

### Typical usage flow (Stacker.News)

Run the bridge.
Generate an NWC URI for receive and attach it in SN wallets UI.
Generate a separate NWC URI for send (spending permission) and attach it.
Verify end-to-end:

SN make_invoice requests appear in bridge logs
SN pay_invoice requests appear and result in a paid invoice

### Operations

Restart after changes:

systemctl --user restart agent-wallet-nwc-bridge.service

Disable:

systemctl --user disable --now agent-wallet-nwc-bridge.service

### Publishing to ClawHub

Ensure README.md, SKILL.md, and package.json are present.
Keep secrets out of git (nwc.env, state.json, node_modules/ are ignored by default).
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: kristapsk
- Version: 1.0.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-30T16:55:25.780Z
- Expires at: 2026-05-07T16:55:25.780Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/agent-wallet-nwc-bridge)
- [Send to Agent page](https://openagent3.xyz/skills/agent-wallet-nwc-bridge/agent)
- [JSON manifest](https://openagent3.xyz/skills/agent-wallet-nwc-bridge/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/agent-wallet-nwc-bridge/agent.md)
- [Download page](https://openagent3.xyz/downloads/agent-wallet-nwc-bridge)