agent-wallet-nwc-bridge

What This Skill Does

The agent-wallet-nwc-bridge acts as a crucial middleware component for the OpenClaw ecosystem, enabling Nostr Wallet Connect (NIP-47) capabilities for your local @moneydevkit/agent-wallet. By bridging standard NWC requests to your local wallet, it allows you to utilize Bitcoin-based applications like Stacker.News directly with your autonomous agent's funds. It operates as a persistent systemd user service, ensuring that your wallet remains accessible and responsive to authorized NIP-47 requests from your configured relays.

Installation

1. Clone the repository: git clone https://github.com/kristapsk/agent-wallet-nwc-bridge
2. Enter the directory and install dependencies: cd agent-wallet-nwc-bridge && npm install
3. Initialize your environment: cp -n nwc.env.example nwc.env
4. Setup the identity: node index.js init --relay wss://nos.lol
5. Execute the systemd installer: ./install_systemd_user.sh
6. Confirm status: systemctl --user status agent-wallet-nwc-bridge.service

Use Cases

• Autonomous Payment Processing: Configure your AI agent to pay invoices generated by other web services seamlessly.
• Wallet Integration: Connect your agent-wallet to platforms like Stacker.News or other NWC-enabled lightning apps to enable balance management and automated tipping or spending.
• Budget Management: Use the built-in NWC URI permissions to define specific spending limits for different applications, ensuring security while allowing automation.

Example Prompts

• "OpenClaw, please check my agent-wallet-nwc-bridge logs to ensure it is connected to the relay and listening for requests."
• "Update my NWC_DEFAULT_BUDGET_SATS in the agent-wallet-nwc-bridge environment configuration to 5000 sats."
• "Restart the agent-wallet-nwc-bridge service because I updated my relay connection settings in nwc.env."

Tips & Limitations

• Security: Always treat your state.json file as sensitive data; it contains private keys related to your NWC connection. Ensure file permissions are restricted to your user.
• Reliability: Since it uses systemd, ensure your Linux environment is configured to allow user services to start on boot (loginctl enable-linger <username>).
• Scope: This bridge only handles NIP-47 communication; it does not replace the @moneydevkit/agent-wallet itself, which must be installed and functioning correctly as the source of truth for your lightning funds.