#nevermined #payments #discord #security-policy

@nevermined-io/openclaw-plugin

OpenClaw plugin for Nevermined — exposes subscriber and builder tools as gateway methods

Install

openclaw plugins install clawhub:@nevermined-io/openclaw-plugin

@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-io/nevermined under the nevermined-io 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

bash

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.

text

/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:

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