@nevermined-io/openclaw-plugin 1.0.16 → 1.1.1

package/docs/guide.md

@@ -12,22 +12,24 @@ This guide walks through building a **Weather Oracle** — a paid agent that ser
 
 ## What You Get
 
-The plugin adds 7 payment tools and 2 slash commands to your OpenClaw gateway:
+The plugin adds 9 payment tools and 2 slash commands to your OpenClaw gateway:
 
 **Subscriber tools** — for users who consume paid services:
 
 | Tool | Purpose |
 |------|---------|
 | `nevermined_checkBalance` | Check remaining credits on a plan |
-| `nevermined_getAccessToken` | Get an x402 token for authenticating requests |
-| `nevermined_orderPlan` | Purchase a payment plan |
-| `nevermined_queryAgent` | Send a paid query to an agent (end-to-end) |
+| `nevermined_getAccessToken` | Get an x402 token for authenticating requests (crypto or fiat) |
+| `nevermined_orderPlan` | Purchase a crypto payment plan |
+| `nevermined_orderFiatPlan` | Purchase a fiat payment plan (returns Stripe checkout URL) |
+| `nevermined_listPaymentMethods` | List enrolled credit cards for fiat payments |
+| `nevermined_queryAgent` | Send a paid query to an agent (crypto or fiat) |
 
 **Builder tools** — for developers who create paid services:
 
 | Tool | Purpose |
 |------|---------|
-| `nevermined_registerAgent` | Register an agent with a payment plan |
+| `nevermined_registerAgent` | Register an agent with a payment plan (crypto or fiat) |
 | `nevermined_createPlan` | Create a standalone payment plan |
 | `nevermined_listPlans` | List your payment plans |
 
@@ -60,7 +62,7 @@ openclaw gateway restart
 You should see in the logs:
 
 ```
-Registered 7 Nevermined payment tools
+Registered 9 Nevermined payment tools
 ```
 
 ## Step 2: Authenticate
@@ -133,7 +135,7 @@ Add the returned IDs and enable the paid endpoint in your gateway config (`~/.op
 Restart the gateway. You should see:
 
 ```
-Registered 7 Nevermined payment tools
+Registered 9 Nevermined payment tools
 Registered paid endpoint at /nevermined/agent
 ```
 
@@ -189,6 +191,38 @@ The Claw calls `nevermined_queryAgent`, which:
 
 Should show 4 credits — one was consumed.
 
+## Fiat Payments (Credit Card)
+
+The plugin supports fiat payments via credit card delegation, allowing users who have enrolled a card through the [Nevermined App](https://nevermined.app) to pay for agent queries without cryptocurrency.
+
+### 1. Enroll a card
+
+Users enroll a credit card via the Nevermined App under Settings > Payment Methods.
+
+### 2. List enrolled cards
+
+> List my payment methods
+
+The Claw calls `nevermined_listPaymentMethods` and returns the enrolled cards with brand, last 4 digits, and expiration.
+
+### 3. Order a fiat plan
+
+> Order the fiat plan `<plan-id>`
+
+The Claw calls `nevermined_orderFiatPlan`, which returns a Stripe checkout URL. The user completes payment in a browser.
+
+### 4. Query an agent with fiat
+
+> Ask the Weather Oracle at `http://localhost:18789/nevermined/agent` about the weather in Paris, pay with my credit card
+
+The Claw calls `nevermined_queryAgent` with `paymentType: fiat`. The plugin:
+1. Looks up enrolled payment methods (or uses the specified `paymentMethodId`)
+2. Gets an x402 access token using the `nvm:card-delegation` scheme
+3. Sends the request with the `PAYMENT-SIGNATURE` header
+4. The agent verifies and settles as usual
+
+You can also set `paymentType: fiat` in the plugin config to make fiat the default for all calls.
+
 ## Custom Agent Handlers
 
 The plugin includes a mock weather handler for demonstration. To use your own logic, pass a custom `agentHandler` when registering the plugin:
@@ -216,12 +250,18 @@ The balance is cached for 60 seconds to avoid excessive API calls.
 
 ## How It Works
 
-The plugin implements the [x402 payment protocol](https://nevermined.ai/docs/api-reference/typescript/x402-protocol) for agent-to-agent payments:
+The plugin implements the [x402 payment protocol](https://nevermined.ai/docs/api-reference/typescript/x402-protocol) for agent-to-agent payments. It supports two payment schemes:
+
+- **Crypto** (`nvm:erc4337`) — on-chain payments using session keys and smart accounts
+- **Fiat** (`nvm:card-delegation`) — credit card payments via Stripe delegation
+
+Both schemes follow the same token flow:
 
 ```
 Subscriber Claw                    Builder Claw (Gateway)
       │                                     │
-      │  1. getX402AccessToken(planId)       │
+      │  1. getX402AccessToken(planId,       │
+      │     tokenOptions)                    │
       │─────────────────────────────────────>│  Nevermined API
       │<─────────────────────────────────────│  returns token
       │                                     │
@@ -236,7 +276,7 @@ Subscriber Claw                    Builder Claw (Gateway)
       │<─────────────────────────────────────│
 ```
 
-Credits are managed on-chain through the Nevermined Protocol. The `verifyPermissions` step checks the subscriber's balance without burning credits, and `settlePermissions` burns them only after successful processing.
+For crypto, credits are managed on-chain through the Nevermined Protocol. For fiat, credits are charged against the delegated card via Stripe. In both cases, `verifyPermissions` checks the subscriber's balance without consuming credits, and `settlePermissions` consumes them only after successful processing.
 
 ## Next Steps
 

package/docs/setup.md

@@ -23,7 +23,10 @@ The plugin reads its configuration from the `plugins.nevermined` section of your
           "agentId": "did:nv:def456...",
           "creditsPerRequest": 1,
           "enablePaidEndpoint": false,
-          "agentEndpointPath": "/nevermined/agent"
+          "agentEndpointPath": "/nevermined/agent",
+          "paymentType": "crypto",
+          "defaultSpendingLimitCents": 1000,
+          "defaultDelegationDurationSecs": 3600
         }
       }
     }
@@ -42,6 +45,9 @@ The plugin reads its configuration from the `plugins.nevermined` section of your
 | `creditsPerRequest` | No | `1` | Number of credits consumed per request. |
 | `enablePaidEndpoint` | No | `false` | Enable the x402 paid HTTP endpoint on the gateway. |
 | `agentEndpointPath` | No | `/nevermined/agent` | HTTP path for the paid agent endpoint. |
+| `paymentType` | No | `crypto` | Default payment type: `crypto` (nvm:erc4337) or `fiat` (nvm:card-delegation). |
+| `defaultSpendingLimitCents` | No | `1000` | Default max spend in cents ($10) for fiat payments. |
+| `defaultDelegationDurationSecs` | No | `3600` | Default delegation duration in seconds (1 hour) for fiat payments. |
 
 ### Environment Details
 

package/openclaw.plugin.json

@@ -18,7 +18,31 @@
       },
       "planId": {
         "type": "string",
-        "description": "Default payment plan ID (required for subscriber tools)"
+        "description": "(Deprecated) Single default plan ID. Use 'plans' array instead."
+      },
+      "fiatPlanId": {
+        "type": "string",
+        "description": "(Deprecated) Single fiat plan ID. Use 'plans' array instead."
+      },
+      "plans": {
+        "type": "array",
+        "description": "Available payment plans. Each entry has a planId, optional name, and paymentType (crypto or fiat).",
+        "items": {
+          "type": "object",
+          "properties": {
+            "planId": { "type": "string", "description": "The Nevermined plan ID" },
+            "name": { "type": "string", "description": "Human-readable plan name" },
+            "paymentType": {
+              "type": "string",
+              "enum": ["crypto", "fiat"],
+              "default": "crypto",
+              "description": "crypto (nvm:erc4337) or fiat (nvm:card-delegation)"
+            },
+            "credits": { "type": "number", "description": "Number of credits this plan grants" },
+            "price": { "type": "string", "description": "Human-readable price (e.g. '$1', '2 USDC')" }
+          },
+          "required": ["planId"]
+        }
       },
       "agentId": {
         "type": "string",
@@ -27,7 +51,12 @@
       "creditsPerRequest": {
         "type": "number",
         "default": 1,
-        "description": "Number of credits consumed per request"
+        "description": "Number of credits consumed per non-calendar tool request"
+      },
+      "creditsPerMinute": {
+        "type": "number",
+        "default": 1,
+        "description": "Credits consumed per minute of calendar meeting duration"
       },
       "enablePaidEndpoint": {
         "type": "boolean",
@@ -38,6 +67,22 @@
         "type": "string",
         "default": "/nevermined/agent",
         "description": "HTTP path for the paid agent endpoint"
+      },
+      "paymentType": {
+        "type": "string",
+        "enum": ["crypto", "fiat"],
+        "default": "crypto",
+        "description": "Default payment type for tools: crypto (nvm:erc4337) or fiat (nvm:card-delegation)"
+      },
+      "defaultSpendingLimitCents": {
+        "type": "number",
+        "default": 1000,
+        "description": "Default max spend in cents ($10) for fiat payments"
+      },
+      "defaultDelegationDurationSecs": {
+        "type": "number",
+        "default": 3600,
+        "description": "Default delegation duration in seconds (1 hour) for fiat payments"
       }
     }
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nevermined-io/openclaw-plugin",
-  "version": "1.0.16",
+  "version": "1.1.1",
   "description": "OpenClaw plugin for Nevermined — exposes subscriber and builder tools as gateway methods",
   "type": "module",
   "main": "./dist/index.js",
@@ -24,10 +24,10 @@
     "lint": "eslint src/ tests/ --ext .ts"
   },
   "peerDependencies": {
-    "@nevermined-io/payments": ">= 1.0.0"
+    "@nevermined-io/payments": ">= 1.1.0"
   },
   "devDependencies": {
-    "@nevermined-io/payments": "^1.0.10",
+    "@nevermined-io/payments": "^1.1.0",
     "@types/jest": "^29.5.0",
     "jest": "^29.7.0",
     "ts-jest": "^29.1.0",

package/skills/nevermined/SKILL.md

@@ -7,7 +7,7 @@ metadata:
 
 # Nevermined Tools
 
-This plugin provides gateway tools for interacting with Nevermined AI agent payments.
+This plugin provides gateway tools for interacting with Nevermined AI agent payments. Supports both crypto (on-chain) and fiat (credit card) payment flows.
 
 ## Authentication
 
@@ -25,21 +25,36 @@ Check credit balance for a payment plan.
 - `planId` (optional if set in config) — the plan to check
 
 ### `nevermined_getAccessToken`
-Get an x402 access token for authenticating agent requests.
+Get an x402 access token for authenticating agent requests. Supports crypto and fiat payment types.
 - `planId` (optional if set in config)
 - `agentId` (optional if set in config)
+- `paymentType` (optional) — `"crypto"` (default) or `"fiat"`
+- `paymentMethodId` (optional) — Stripe payment method ID for fiat. Auto-selects first enrolled card if omitted.
+- `spendingLimitCents` (optional) — max spend in cents for fiat (default: 1000)
+- `delegationDurationSecs` (optional) — delegation duration in seconds for fiat (default: 3600)
 
 ### `nevermined_orderPlan`
-Purchase a payment plan.
+Purchase a crypto payment plan.
 - `planId` (optional if set in config)
 
+### `nevermined_orderFiatPlan`
+Order a fiat payment plan — returns a Stripe checkout URL.
+- `planId` (optional if set in config)
+
+### `nevermined_listPaymentMethods`
+List enrolled credit cards available for fiat payments. No parameters.
+
 ### `nevermined_queryAgent`
-End-to-end agent query — acquires a token, calls the agent, returns the response.
+End-to-end agent query — acquires a token, calls the agent, returns the response. Supports crypto and fiat.
 - `agentUrl` (required) — the agent endpoint URL
 - `prompt` (required) — the prompt to send
 - `planId` (optional if set in config)
 - `agentId` (optional if set in config)
 - `method` (optional, default `POST`)
+- `paymentType` (optional) — `"crypto"` (default) or `"fiat"`
+- `paymentMethodId` (optional) — Stripe payment method ID for fiat
+- `spendingLimitCents` (optional) — max spend in cents for fiat
+- `delegationDurationSecs` (optional) — delegation duration in seconds for fiat
 
 ## Builder Tools
 
@@ -48,10 +63,11 @@ Register a new AI agent with a payment plan.
 - `name` (required) — agent name
 - `agentUrl` (required) — agent endpoint
 - `planName` (required) — plan name
-- `priceAmounts` (required) — comma-separated prices in wei
+- `priceAmounts` (required) — comma-separated prices in wei (crypto) or cents (fiat)
 - `priceReceivers` (required) — comma-separated receiver addresses
 - `creditsAmount` (required) — number of credits
 - `tokenAddress` (optional) — ERC20 token address (e.g. USDC). Omit for native token.
+- `pricingType` (optional) — `"crypto"` (default), `"erc20"`, or `"fiat"`
 
 ### `nevermined_createPlan`
 Create a standalone payment plan. Supports fiat (Stripe), ERC20 tokens (USDC), and native crypto pricing.