@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/neverminedunder thenevermined-ioorg 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-signatureheader) 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