Receive Skill

Self-hosted receive skill for OpenClaw - receive money into your bank account via API.

Overview

Receive Skill is a Node.js/TypeScript application that enables OpenClaw agents to receive payments from others into the owner's bank account. It supports multiple payment providers (Wise, Bunq) and provides both a CLI interface and web dashboard.

Features

• Multi-Provider Support: Wise, Bunq
• Receive via IBAN: Get your SEPA IBAN to receive payments
• Webhook Notifications: Real-time notifications when money arrives
• Payment Tracking: Track all incoming payments
• CLI Interface: Complete command-line interface
• Web Dashboard: Browser-based interface
• Payment History: View and search received payments
• Statistics: Track total received, recent payments

Installation

Global Installation (Recommended)

npm install -g receive-skill

From Source

git clone https://github.com/kraskoruk/receive-skill.git
cd receive-skill
npm install
npm run build
npm link

Quick Start

1. Initialize Configuration

receive-skill config init

2. Add Payment Provider

For Wise:

receive-skill provider add wise --api-key YOUR_WISE_API_KEY

For Bunq:

receive-skill provider add bunq --api-key YOUR_BUNQ_API_KEY

3. Get Your Receiving IBAN

# Wise
receive-skill wise balances --profile YOUR_PROFILE_ID
receive-skill wise iban --profile YOUR_PROFILE_ID --balance YOUR_BALANCE_ID

# Bunq
receive-skill bunq accounts --user YOUR_USER_ID

4. View Incoming Payments

receive-skill payment list

5. Start Dashboard

receive-skill server start
# Open http://localhost:18791/dashboard

CLI Commands Reference

Configuration Commands

# Initialize configuration
receive-skill config init

# Get configuration value
receive-skill config get <key>

# List all configuration
receive-skill config list

# Show config file path
receive-skill config path

Provider Commands

# Add a provider
receive-skill provider add <name> --api-key <key>

# List configured providers
receive-skill provider list

# Get provider details
receive-skill provider get <name>

# Remove a provider
receive-skill provider remove <name>

# Test provider connection
receive-skill provider test <name>

Wise Commands

# Get profiles
receive-skill wise profiles

# Get balances with IBANs
receive-skill wise balances --profile <id>

# Get your receiving IBAN
receive-skill wise iban --profile <id> --balance <id>

# List incoming payments
receive-skill wise incoming --profile <id>

# Setup webhook
receive-skill wise webhook-setup --profile <id> --url <url>

# List webhooks
receive-skill wise webhook-list --profile <id>

Bunq Commands

# List accounts with IBANs
receive-skill bunq accounts --user <id>

# List incoming payments
receive-skill bunq incoming --user <id> --account <id>

# Create payment request
receive-skill bunq request --user <id> --account <id> --amount <amount> --currency <currency> --description <text>

# Get bunq.me link
receive-skill bunq bunqme --user <id>

Payment Commands

# List received payments
receive-skill payment list [--provider <name>] [--limit <n>]

# Get payment details
receive-skill payment get <id>

# Show statistics
receive-skill payment stats

# Show recent payments
receive-skill payment recent [--hours <n>]

# Search by sender
receive-skill payment search <query>

# Delete payment record
receive-skill payment delete <id>

Webhook Commands

# Configure webhook
receive-skill webhook setup --url <url> [--secret <secret>]

# Show webhook status
receive-skill webhook status

# Enable/disable webhook
receive-skill webhook enable
receive-skill webhook disable

# Test webhook
receive-skill webhook test

# Simulate incoming payment
receive-skill webhook simulate --provider <name> --amount <amount> --currency <currency>

Server Commands

# Start dashboard server
receive-skill server start [--port <port>] [--host <host>]

# Start in background
receive-skill server start --daemon

# Open dashboard
receive-skill server dashboard

Web Dashboard

The web dashboard provides a visual interface for:

• Provider configuration
• Viewing your receiving IBAN
• Tracking incoming payments
• Payment statistics
• Webhook configuration

receive-skill server start
open http://localhost:18791/dashboard

Webhooks

Configure webhooks to receive real-time notifications when payments arrive:

# Setup webhook URL
receive-skill webhook setup --url "https://your-server.com/webhooks"

# Wise will POST to /webhooks/wise
# Bunq will POST to /webhooks/bunq

Webhook payload example (Wise):

{
  "event_type": "balance-credited",
  "data": {
    "resource": {
      "id": 123456789,
      "amount": 1000.00,
      "currency": "EUR",
      "sender_name": "John Doe",
      "sender_iban": "DE89370400440532013000",
      "reference": "Invoice #123"
    }
  },
  "occurred_at": "2026-03-16T10:30:00Z"
}

Configuration

Configuration is stored in ~/.receive-skill/config.json:

{
  "version": "1.0.0",
  "providers": {
    "wise": {
      "apiKey": "wise-api-key",
      "environment": "production"
    },
    "bunq": {
      "apiKey": "bunq-api-key",
      "environment": "production"
    }
  },
  "webhook": {
    "url": "https://your-server.com/webhooks",
    "secret": "webhook-secret",
    "enabled": true
  }
}

Environment Variables

RECEIVE_SKILL_CONFIG_PATH=/path/to/config
RECEIVE_SKILL_WISE_API_KEY=your-wise-key
RECEIVE_SKILL_BUNQ_API_KEY=your-bunq-key
RECEIVE_SKILL_LOG_LEVEL=info

Security

• API keys stored in ~/.receive-skill/ with restricted permissions (0o600)
• Webhook signatures verified when secret is configured
• All payments logged with full audit trail

SEPA Instant

Wise supports SEPA Instant for immediate transfers:

• Incoming: Instant if sender's bank supports SEPA Instant
• Notification: Webhook fires immediately when money arrives
• Regular SEPA: 1 business day if instant not available

Architecture

receive-skill/
├── src/
│   ├── api/          # API clients (Wise, Bunq)
│   ├── commands/     # CLI commands
│   ├── core/         # Core logic (config, payments)
│   ├── server/       # Web server
│   └── types/        # TypeScript types
├── bin/              # CLI entry point
└── dashboard.html    # Web dashboard

License

MIT License with Additional Liability Disclaimer - see LICENSE file

IMPORTANT: By using this software, you agree that:

• The creators cannot be held liable for any financial losses or damages
• You use this software entirely at your own risk
• You are solely responsible for securing your API keys

Support

• GitHub Issues: https://github.com/kraskoruk/receive-skill/issues
• GitHub Discussions: https://github.com/kraskoruk/receive-skill/discussions

Disclaimer

⚠️ USE AT YOUR OWN RISK

Receive-skill involves real money transactions. The authors are not responsible for:

• Lost funds or failed transactions
• Unauthorized access to your accounts
• API errors from payment providers
• Any financial losses whatsoever