openclaw-paid-actions

# OpenClaw Paid Actions

Use this skill when an action must be paid before it runs.

Tool: `openclaw_paid_action`

This skill is instruction-only. It expects a trusted installed implementation of the `openclaw-paid-actions` plugin that provides `openclaw_paid_action`.

Actions:
- `list`: List configured paid actions.
- `quote`: Build USDC payment instructions for an action.
- `invoice`: Create a signed invoice token for an action/input.
- `status`: Check current invoice payment status.
- `wait`: Poll until the invoice is paid (or timeout/expiry).
- `confirm` (or `pay` alias): Validate payment transaction on-chain, then mark invoice paid.
- `execute`: Run the action after invoice is confirmed paid.

## Typical Flow

1. Call `openclaw_paid_action` with `action: "list"` to discover action IDs.
2. Call `openclaw_paid_action` with `action: "invoice"` and `actionId` (plus optional `input`, `recipient`, `memo`).
3. Send the returned `invoiceMessage` or `paymentInstructions` to the payer.
4. After payment is received, call `openclaw_paid_action` with `action: "confirm"` and `invoice` (or `invoiceId`) plus `transaction` to validate on-chain and mark paid.
   You can also pass `paymentProofText` with the raw user reply; the tool extracts the Solana tx signature automatically.
5. Call `openclaw_paid_action` with `action: "wait"` (or `status`) to know when it is paid.
6. Call `openclaw_paid_action` with `action: "execute"` and `invoice` to run after payment.

## Plugin Config

Configure under `plugins.entries.openclaw-paid-actions.config`:

```json
{
  "network": "solana:mainnet",
  "payTo": "${OPENCLAW_USDC_PAY_TO}",
  "invoiceSecret": "${OPENCLAW_PAID_ACTIONS_INVOICE_SECRET}",
  "invoiceStorePath": "${OPENCLAW_PAID_ACTIONS_INVOICE_STORE_PATH}",
  "allowRunAsRoot": false,
  "requirePersistentInvoiceSecret": true,
  "requireInvoiceStorePath": true,
  "enforceReviewedScripts": true,
  "reviewedScriptsRoot": "scripts/paid-actions",
  "requiredNodeMajor": 20,
  "defaultInvoiceWait...