@nevermined-io/openclaw-plugin

OpenClaw plugin for Nevermined — exposes AI agent payment operations as gateway tools callable from any OpenClaw channel (Telegram, Discord, WhatsApp, etc.).

Official source & provenance

This plugin is published from the nevermined-io/payments monorepo (subdirectory openclaw/) by Nevermined AG.

| | | |---|---| | npm package | @nevermined-io/openclaw-plugin — published with npm provenance attestations from this repo's release.yml workflow. | | GitHub repository | https://github.com/nevermined-io/payments (subdirectory openclaw/) | | License | Apache-2.0 | | Security policy | https://github.com/nevermined-io/payments/security/policy | | Issue tracker | https://github.com/nevermined-io/payments/issues |

✅ Official ClawHub listing. The official skill lives at clawhub.ai/nevermined/nevermined-payments under the @nevermined org publisher. Treat any other ClawHub publisher as a third-party mirror until further notice. The canonical npm package is @nevermined-io/openclaw-plugin.

🔐 Never log payment tokens. x402 access tokens (the payment-signature header) are bearer credentials. Treat them like API keys: redact them in any debug output, log pipeline, or telemetry exporter (pino, winston, OpenTelemetry, etc.).

Installation

openclaw plugin install @nevermined-io/openclaw-plugin@^1.1

The plugin requires @nevermined-io/payments@^1.1 as a peer dependency. Pin both packages in production deployments (lockfiles, container images) so SDK upgrades are explicit and reviewable.

Authentication

The plugin supports two ways to provide your Nevermined API key:

Option A: Slash command (recommended)

Use the /nvm_login command from any chat channel. This opens a browser window where you authenticate with Nevermined, and the API key is captured automatically.

/nvm_login              # Login to sandbox (default)
/nvm_login live         # Login to live environment
/nvm_login <api-key>    # Paste an API key directly
/nvm_logout             # Remove stored API key

On headless servers where a browser can't open, the command provides manual instructions with a login URL.

Option B: Manual configuration

Add your API key directly to openclaw.json:

{
  "plugins": {
    "entries": {
      "openclaw-plugin": {
        "enabled": true,
        "config": {
          "nvmApiKey": "sandbox:eyJhbG...",
          "environment": "sandbox",
          "planId": "<your-plan-id>",
          "agentId": "<your-agent-id>",
          "creditsPerRequest": 1,
          "enablePaidEndpoint": false,
          "agentEndpointPath": "/nevermined/agent"
        }
      }
    }
  }
}

Configuration

| Field | Required | Default | Description | |-------|----------|---------|-------------| | nvmApiKey | No | — | Your Nevermined API key (or use /nvm_login) | | environment | No | sandbox | sandbox or live | | planId | No | — | Default plan ID for subscriber tools | | agentId | No | — | Default agent ID for multi-agent plans | | creditsPerRequest | No | 1 | 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 |

Available Tools

Slash Commands

| Command | Description | |---------|-------------| | /nvm_login [environment] | Authenticate via browser login or paste an API key | | /nvm_logout | Remove stored API key |

Subscriber Tools

| Tool | Description | Key Params | |------|-------------|------------| | nevermined_checkBalance | Check credit balance for a plan | planId | | nevermined_getAccessToken | Get an x402 access token | planId, agentId | | nevermined_orderPlan | Purchase a crypto payment plan (two-step: returns a quote until confirm: true is passed) | planId, confirm | | nevermined_orderFiatPlan | Order a fiat payment plan (two-step: returns a quote until confirm: true is passed) | planId, confirm | | nevermined_queryAgent | Query an agent end-to-end (HTTPS recommended) | agentUrl, prompt, planId, agentId |

Builder Tools

| Tool | Description | Key Params | |------|-------------|------------| | nevermined_registerAgent | Register an agent with a plan | name, agentUrl, planName, priceAmounts, priceReceivers, creditsAmount, tokenAddress | | nevermined_createPlan | Create a payment plan | name, priceAmounts, priceReceivers, creditsAmount, tokenAddress | | nevermined_listPlans | List your plans | — |

Documentation

• User Guide — step-by-step tutorial building a paid Weather Oracle agent
• Commands Reference — full parameter documentation for all tools
• Setup Reference — detailed configuration options
• Nevermined Docs
• Payments SDK

License

Apache-2.0