> ## Documentation Index
> Fetch the complete documentation index at: https://neverminedag-sync-api-errors-9d14109.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# OpenClaw
> Integrate Nevermined payments into OpenClaw gateways to monetize AI agents from Telegram, Discord, WhatsApp, and any chat channel.
Nevermined integrates with [OpenClaw](https://openclaw.ai) to bring AI agent payments directly into messaging platforms. Install the plugin on an OpenClaw gateway and every connected channel gains full access to the Nevermined payment infrastructure:
* **Chat-native payments**: subscribers order plans, check balances, and query paid agents from Telegram, Discord, WhatsApp, or any other connected channel.
* **x402 built in**: the plugin handles the full payment lifecycle — token acquisition, permission verification, and credit settlement — automatically.
* **Builder and subscriber tools**: 7 payment tools and 2 slash commands cover both sides of the marketplace, from agent registration to paid queries.
* **Paid HTTP endpoint**: enable a single config flag and the gateway exposes an x402-compatible endpoint that verifies, processes, and settles requests without custom code.
## Architecture
```mermaid theme={null}
sequenceDiagram
participant User
participant Gateway as OpenClaw Gateway
participant Nevermined
User->>Gateway: Send message from chat channel
Gateway->>Nevermined: getAccessToken(planId, agentId)
Nevermined-->>Gateway: x402 access token
Gateway->>Nevermined: POST /agent + payment-signature
Nevermined->>Nevermined: verifyPermissions → settle credits
Nevermined-->>Gateway: Agent response + payment-response
Gateway-->>User: Return response in chat
```
## Features
The [Nevermined OpenClaw plugin](https://github.com/nevermined-io/openclaw-plugin) provides a complete set of tools for both builders and subscribers:
* **Payment Signature Authentication**: the paid endpoint extracts access tokens from the `payment-signature` header and verifies them against Nevermined.
* **Credit Verification and Settlement**: validates subscriber balance before processing and burns credits only after successful execution.
* **Multi-Channel Support**: one plugin instance handles payments across every channel your OpenClaw gateway connects to.
* **Agent Registration from Chat**: register agents and create payment plans directly from any messaging channel — no dashboard required.
* **Flexible Pricing**: supports fiat (Stripe/USD), ERC20 tokens (USDC), and native cryptocurrency payment plans.
* **Balance Awareness**: when configured, the plugin injects the current credit balance into the agent's context so your Claw can proactively warn users about low credits.
## Quickstart
To interact with the Nevermined API, you need an API key. Follow the [Get Your API Key](/docs/getting-started/get-your-api-key) guide to create one.
From your OpenClaw gateway server:
```bash theme={null}
openclaw plugin install @nevermined-io/openclaw-plugin
```
Restart the gateway after installation:
```bash theme={null}
openclaw gateway restart
```
You should see in the logs:
```
Registered 7 Nevermined payment tools
```
Send `/nvm_login` from any connected chat channel to authenticate with your Nevermined account.
```
/nvm_login
```
This opens a browser window for authentication. The API key is captured and stored automatically.
For headless servers, pass the key directly:
```
/nvm_login sandbox:eyJhbG...
```
Use `sandbox` for testing, `live` for production.
## Register an Agent and Payment Plan
Once authenticated, register your agent directly from chat. Send a message like:
> Register a Nevermined agent called "Legal Assistant" at URL `https://my-gateway.example.com/nevermined/agent` with a plan named "Legal Queries" priced at 1000000 to address `0xYourWalletAddress` with token `0x036CbD53842c5426634e7929541eC2318f3dCF7e` granting 10 credits.
The gateway calls `nevermined_registerAgent` and returns an `agentId` and `planId`. Save these for configuration.
### Enable the Paid Endpoint
Add the returned IDs to your gateway config (`~/.openclaw/openclaw.json`) and enable the paid endpoint:
```json theme={null}
{
"plugins": {
"entries": {
"nevermined": {
"enabled": true,
"config": {
"nvmApiKey": "sandbox:eyJhbG...",
"environment": "sandbox",
"planId": "",
"agentId": "",
"enablePaidEndpoint": true,
"agentEndpointPath": "/nevermined/agent",
"creditsPerRequest": 1
}
}
}
}
}
```
Restart the gateway. The paid endpoint handles the full x402 lifecycle automatically:
1. Extracts the `payment-signature` header from incoming requests
2. Calls `verifyPermissions` to check the subscriber has credits
3. Processes the request through your agent handler
4. Calls `settlePermissions` to burn credits
5. Returns the response with a `payment-response` header
## Query a Paid Agent
From the subscriber side (same or different gateway), the full flow works from chat:
**Order a plan:**
> Order the Legal Assistant plan ``
The gateway calls `nevermined_orderPlan` and credits are granted.
**Query the agent:**
> Ask the Legal Assistant at `https://my-gateway.example.com/nevermined/agent` to summarize the latest GDPR amendments
The gateway calls `nevermined_queryAgent`, which acquires an x402 token, sends the prompt with a `payment-signature` header, and returns the response — all in one step.
**Check your balance:**
> Check my Nevermined balance for plan ``
Credits are decremented after each successful query.
## Custom Agent Handlers
The plugin includes a default handler for demonstration. To use your own logic, pass a custom `agentHandler` when registering the plugin:
```typescript theme={null}
import neverminedPlugin from '@nevermined-io/openclaw-plugin'
neverminedPlugin.register(api, {
agentHandler: async (body) => {
const response = await myAIModel.generate(body.prompt)
return { result: response }
},
})
```
The handler receives `{ prompt: string }` and returns any JSON-serializable object.
## Learn More
Install and configure the plugin
Full configuration reference
All tools and slash commands
Step-by-step tutorial