@nevermined-io/openclaw-plugin 1.0.11-rc.1

package/README.md

@@ -0,0 +1,63 @@
+# @nevermined-io/openclaw-plugin
+
+OpenClaw plugin for [Nevermined](https://nevermined.io) — exposes AI agent payment operations as gateway tools callable from any OpenClaw channel (Telegram, Discord, WhatsApp, etc.).
+
+## Installation
+
+```bash
+openclaw plugin install @nevermined-io/openclaw-plugin
+```
+
+## Configuration
+
+Add the Nevermined plugin config to your `openclaw.json`:
+
+```json
+{
+  "plugins": {
+    "nevermined": {
+      "nvmApiKey": "sandbox:eyJhbG...",
+      "environment": "sandbox",
+      "planId": "did:nv:abc123",
+      "agentId": "did:nv:def456",
+      "creditsPerRequest": 1
+    }
+  }
+}
+```
+
+| Field | Required | Default | Description |
+|-------|----------|---------|-------------|
+| `nvmApiKey` | Yes | — | Your Nevermined API key |
+| `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 |
+
+## Available Tools
+
+### 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 payment plan | `planId` |
+| `nevermined.queryAgent` | Query an agent end-to-end | `agentUrl`, `prompt`, `planId`, `agentId` |
+
+### Builder Tools
+
+| Tool | Description | Key Params |
+|------|-------------|------------|
+| `nevermined.registerAgent` | Register an agent with a plan | `name`, `agentUrl`, `planName`, `priceAmounts`, `priceReceivers`, `creditsAmount` |
+| `nevermined.createPlan` | Create a payment plan | `name`, `priceAmounts`, `priceReceivers`, `creditsAmount` |
+| `nevermined.listPlans` | List your plans | — |
+
+## Documentation
+
+- [Nevermined Docs](https://docs.nevermined.app)
+- [Payments SDK](https://github.com/nevermined-io/payments)
+
+## License
+
+Apache-2.0

package/dist/config.d.ts

@@ -0,0 +1,25 @@
+import { z } from 'zod';
+import { Payments } from '@nevermined-io/payments';
+export declare const NeverminedPluginConfigSchema: z.ZodObject<{
+    nvmApiKey: z.ZodString;
+    environment: z.ZodDefault<z.ZodEnum<["sandbox", "live"]>>;
+    planId: z.ZodOptional<z.ZodString>;
+    agentId: z.ZodOptional<z.ZodString>;
+    creditsPerRequest: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    nvmApiKey: string;
+    environment: "sandbox" | "live";
+    creditsPerRequest: number;
+    planId?: string | undefined;
+    agentId?: string | undefined;
+}, {
+    nvmApiKey: string;
+    environment?: "sandbox" | "live" | undefined;
+    planId?: string | undefined;
+    agentId?: string | undefined;
+    creditsPerRequest?: number | undefined;
+}>;
+export type NeverminedPluginConfig = z.infer<typeof NeverminedPluginConfigSchema>;
+export declare function validateConfig(raw: unknown): NeverminedPluginConfig;
+export declare function createPaymentsFromConfig(config: NeverminedPluginConfig): Payments;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AAGlD,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;EAMvC,CAAA;AAEF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAA;AAEjF,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,sBAAsB,CAEnE;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,sBAAsB,GAAG,QAAQ,CAKjF"}

package/dist/config.js

@@ -0,0 +1,19 @@
+import { z } from 'zod';
+import { Payments } from '@nevermined-io/payments';
+export const NeverminedPluginConfigSchema = z.object({
+    nvmApiKey: z.string().min(1, 'nvmApiKey is required'),
+    environment: z.enum(['sandbox', 'live']).default('sandbox'),
+    planId: z.string().optional(),
+    agentId: z.string().optional(),
+    creditsPerRequest: z.number().int().positive().default(1),
+});
+export function validateConfig(raw) {
+    return NeverminedPluginConfigSchema.parse(raw);
+}
+export function createPaymentsFromConfig(config) {
+    return Payments.getInstance({
+        nvmApiKey: config.nvmApiKey,
+        environment: config.environment,
+    });
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AAGlD,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IACnD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,uBAAuB,CAAC;IACrD,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;IAC3D,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;CAC1D,CAAC,CAAA;AAIF,MAAM,UAAU,cAAc,CAAC,GAAY;IACzC,OAAO,4BAA4B,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;AAChD,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,MAA8B;IACrE,OAAO,QAAQ,CAAC,WAAW,CAAC;QAC1B,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,WAAW,EAAE,MAAM,CAAC,WAA8B;KACnD,CAAC,CAAA;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,25 @@
+import { validateConfig, createPaymentsFromConfig } from './config.js';
+import { allTools } from './tools.js';
+import type { Payments } from '@nevermined-io/payments';
+import type { NeverminedPluginConfig } from './config.js';
+import type { ToolDefinition } from './tools.js';
+export type { NeverminedPluginConfig, ToolDefinition };
+export { validateConfig, createPaymentsFromConfig, allTools };
+export interface OpenClawPluginAPI {
+    getConfig(namespace: string): unknown;
+    registerGatewayMethod(name: string, options: {
+        description: string;
+        params: Array<{
+            name: string;
+            type: string;
+            description: string;
+            required: boolean;
+        }>;
+        handler: (params: Record<string, unknown>) => Promise<unknown>;
+    }): void;
+}
+export interface RegisterOptions {
+    paymentsFactory?: (config: NeverminedPluginConfig) => Payments;
+}
+export declare function register(api: OpenClawPluginAPI, options?: RegisterOptions): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAA;AACtE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AACrC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AACvD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAEhD,YAAY,EAAE,sBAAsB,EAAE,cAAc,EAAE,CAAA;AACtD,OAAO,EAAE,cAAc,EAAE,wBAAwB,EAAE,QAAQ,EAAE,CAAA;AAE7D,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAA;IACrC,qBAAqB,CACnB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;QACP,WAAW,EAAE,MAAM,CAAA;QACnB,MAAM,EAAE,KAAK,CAAC;YACZ,IAAI,EAAE,MAAM,CAAA;YACZ,IAAI,EAAE,MAAM,CAAA;YACZ,WAAW,EAAE,MAAM,CAAA;YACnB,QAAQ,EAAE,OAAO,CAAA;SAClB,CAAC,CAAA;QACF,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;KAC/D,GACA,IAAI,CAAA;CACR;AAED,MAAM,WAAW,eAAe;IAC9B,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,sBAAsB,KAAK,QAAQ,CAAA;CAC/D;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,iBAAiB,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,IAAI,CAoBhF"}

package/dist/index.js

@@ -0,0 +1,25 @@
+import { validateConfig, createPaymentsFromConfig } from './config.js';
+import { allTools } from './tools.js';
+export { validateConfig, createPaymentsFromConfig, allTools };
+export function register(api, options) {
+    const rawConfig = api.getConfig('nevermined');
+    const config = validateConfig(rawConfig);
+    const factory = options?.paymentsFactory ?? createPaymentsFromConfig;
+    const payments = factory(config);
+    for (const tool of allTools) {
+        api.registerGatewayMethod(tool.name, {
+            description: tool.description,
+            params: tool.params,
+            handler: async (params) => {
+                try {
+                    return await tool.handler(payments, config, params);
+                }
+                catch (err) {
+                    const message = err instanceof Error ? err.message : String(err);
+                    throw new Error(`[nevermined] ${tool.name} failed: ${message}`);
+                }
+            },
+        });
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAA;AACtE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAMrC,OAAO,EAAE,cAAc,EAAE,wBAAwB,EAAE,QAAQ,EAAE,CAAA;AAuB7D,MAAM,UAAU,QAAQ,CAAC,GAAsB,EAAE,OAAyB;IACxE,MAAM,SAAS,GAAG,GAAG,CAAC,SAAS,CAAC,YAAY,CAAC,CAAA;IAC7C,MAAM,MAAM,GAAG,cAAc,CAAC,SAAS,CAAC,CAAA;IACxC,MAAM,OAAO,GAAG,OAAO,EAAE,eAAe,IAAI,wBAAwB,CAAA;IACpE,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAEhC,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,GAAG,CAAC,qBAAqB,CAAC,IAAI,CAAC,IAAI,EAAE;YACnC,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;gBACxB,IAAI,CAAC;oBACH,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;gBACrD,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;oBAChE,MAAM,IAAI,KAAK,CAAC,gBAAgB,IAAI,CAAC,IAAI,YAAY,OAAO,EAAE,CAAC,CAAA;gBACjE,CAAC;YACH,CAAC;SACF,CAAC,CAAA;IACJ,CAAC;AACH,CAAC"}

package/dist/tools.d.ts

@@ -0,0 +1,16 @@
+import type { Payments } from '@nevermined-io/payments';
+import type { NeverminedPluginConfig } from './config.js';
+export interface ToolParam {
+    name: string;
+    type: string;
+    description: string;
+    required: boolean;
+}
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    params: ToolParam[];
+    handler: (payments: Payments, config: NeverminedPluginConfig, params: Record<string, unknown>) => Promise<unknown>;
+}
+export declare const allTools: ToolDefinition[];
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AACvD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AAEzD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,OAAO,CAAA;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,SAAS,EAAE,CAAA;IACnB,OAAO,EAAE,CACP,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,sBAAsB,EAC9B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC5B,OAAO,CAAC,OAAO,CAAC,CAAA;CACtB;AAqPD,eAAO,MAAM,QAAQ,EAAE,cAAc,EAUpC,CAAA"}

package/dist/tools.js

@@ -0,0 +1,218 @@
+function requireParam(params, name) {
+    const value = params[name];
+    if (value === undefined || value === null || value === '') {
+        throw new Error(`Missing required parameter: ${name}`);
+    }
+    return String(value);
+}
+function optionalParam(params, name, fallback) {
+    const value = params[name];
+    if (value === undefined || value === null || value === '') {
+        return fallback;
+    }
+    return String(value);
+}
+// --- Subscriber tools ---
+const checkBalance = {
+    name: 'nevermined.checkBalance',
+    description: 'Check the credit balance for a Nevermined payment plan',
+    params: [
+        { name: 'planId', type: 'string', description: 'The payment plan ID', required: false },
+    ],
+    handler: async (payments, config, params) => {
+        const planId = optionalParam(params, 'planId', config.planId);
+        if (!planId) {
+            throw new Error('planId is required — provide it as a parameter or in the plugin config');
+        }
+        const balance = await payments.plans.getPlanBalance(planId);
+        return {
+            planId: balance.planId,
+            planName: balance.planName,
+            balance: balance.balance.toString(),
+            isSubscriber: balance.isSubscriber,
+        };
+    },
+};
+const getAccessToken = {
+    name: 'nevermined.getAccessToken',
+    description: 'Get an x402 access token for authenticating requests to a Nevermined agent',
+    params: [
+        { name: 'planId', type: 'string', description: 'The payment plan ID', required: false },
+        { name: 'agentId', type: 'string', description: 'The agent ID', required: false },
+    ],
+    handler: async (payments, config, params) => {
+        const planId = optionalParam(params, 'planId', config.planId);
+        if (!planId) {
+            throw new Error('planId is required — provide it as a parameter or in the plugin config');
+        }
+        const agentId = optionalParam(params, 'agentId', config.agentId);
+        const result = await payments.x402.getX402AccessToken(planId, agentId);
+        return { accessToken: result.accessToken };
+    },
+};
+const orderPlan = {
+    name: 'nevermined.orderPlan',
+    description: 'Order (purchase) a Nevermined payment plan',
+    params: [
+        { name: 'planId', type: 'string', description: 'The payment plan ID to order', required: false },
+    ],
+    handler: async (payments, config, params) => {
+        const planId = optionalParam(params, 'planId', config.planId);
+        if (!planId) {
+            throw new Error('planId is required — provide it as a parameter or in the plugin config');
+        }
+        const result = await payments.plans.orderPlan(planId);
+        return result;
+    },
+};
+const queryAgent = {
+    name: 'nevermined.queryAgent',
+    description: 'Query a Nevermined AI agent end-to-end: acquires an x402 access token, sends the prompt to the agent, and returns the response',
+    params: [
+        { name: 'agentUrl', type: 'string', description: 'The URL of the agent to query', required: true },
+        { name: 'prompt', type: 'string', description: 'The prompt to send to the agent', required: true },
+        { name: 'planId', type: 'string', description: 'The payment plan ID', required: false },
+        { name: 'agentId', type: 'string', description: 'The agent ID', required: false },
+        { name: 'method', type: 'string', description: 'HTTP method (default: POST)', required: false },
+    ],
+    handler: async (payments, config, params) => {
+        const agentUrl = requireParam(params, 'agentUrl');
+        const prompt = requireParam(params, 'prompt');
+        const planId = optionalParam(params, 'planId', config.planId);
+        if (!planId) {
+            throw new Error('planId is required — provide it as a parameter or in the plugin config');
+        }
+        const agentId = optionalParam(params, 'agentId', config.agentId);
+        const method = optionalParam(params, 'method', 'POST') ?? 'POST';
+        const { accessToken } = await payments.x402.getX402AccessToken(planId, agentId);
+        const response = await fetch(agentUrl, {
+            method,
+            headers: {
+                'Content-Type': 'application/json',
+                'PAYMENT-SIGNATURE': accessToken,
+            },
+            body: method !== 'GET' ? JSON.stringify({ prompt }) : undefined,
+        });
+        if (response.status === 402) {
+            return {
+                error: 'Payment required — insufficient credits. Order the plan first using nevermined.orderPlan.',
+                status: 402,
+            };
+        }
+        if (!response.ok) {
+            return {
+                error: `Agent returned HTTP ${response.status}: ${response.statusText}`,
+                status: response.status,
+            };
+        }
+        const body = await response.json();
+        return body;
+    },
+};
+// --- Builder tools ---
+const registerAgent = {
+    name: 'nevermined.registerAgent',
+    description: 'Register a new AI agent with an associated payment plan on Nevermined',
+    params: [
+        { name: 'name', type: 'string', description: 'Agent name', required: true },
+        { name: 'description', type: 'string', description: 'Agent description', required: false },
+        { name: 'agentUrl', type: 'string', description: 'The endpoint URL for the agent', required: true },
+        { name: 'planName', type: 'string', description: 'Name for the payment plan', required: true },
+        { name: 'priceAmounts', type: 'string', description: 'Comma-separated price amounts in wei', required: true },
+        { name: 'priceReceivers', type: 'string', description: 'Comma-separated receiver addresses', required: true },
+        { name: 'creditsAmount', type: 'number', description: 'Number of credits in the plan', required: true },
+    ],
+    handler: async (payments, _config, params) => {
+        const name = requireParam(params, 'name');
+        const description = optionalParam(params, 'description', '');
+        const agentUrl = requireParam(params, 'agentUrl');
+        const planName = requireParam(params, 'planName');
+        const priceAmounts = requireParam(params, 'priceAmounts')
+            .split(',')
+            .map((s) => BigInt(s.trim()));
+        const priceReceivers = requireParam(params, 'priceReceivers')
+            .split(',')
+            .map((s) => s.trim());
+        const creditsAmount = Number(requireParam(params, 'creditsAmount'));
+        const result = await payments.agents.registerAgentAndPlan({ name, description }, {
+            endpoints: [{ POST: agentUrl }],
+            agentDefinitionUrl: agentUrl,
+        }, { name: planName }, {
+            amounts: priceAmounts,
+            receivers: priceReceivers,
+            isCrypto: true,
+        }, {
+            isRedemptionAmountFixed: true,
+            redemptionType: 4, // ONLY_SUBSCRIBER
+            proofRequired: false,
+            durationSecs: 0n,
+            amount: BigInt(creditsAmount),
+            minAmount: 1n,
+            maxAmount: BigInt(creditsAmount),
+        });
+        return {
+            agentId: result.agentId,
+            planId: result.planId,
+            txHash: result.txHash,
+        };
+    },
+};
+const createPlan = {
+    name: 'nevermined.createPlan',
+    description: 'Create a new payment plan on Nevermined',
+    params: [
+        { name: 'name', type: 'string', description: 'Plan name', required: true },
+        { name: 'description', type: 'string', description: 'Plan description', required: false },
+        { name: 'priceAmounts', type: 'string', description: 'Comma-separated price amounts in wei', required: true },
+        { name: 'priceReceivers', type: 'string', description: 'Comma-separated receiver addresses', required: true },
+        { name: 'creditsAmount', type: 'number', description: 'Number of credits in the plan', required: true },
+        { name: 'accessLimit', type: 'string', description: '"credits" or "time" (default: credits)', required: false },
+    ],
+    handler: async (payments, _config, params) => {
+        const name = requireParam(params, 'name');
+        const description = optionalParam(params, 'description', '');
+        const priceAmounts = requireParam(params, 'priceAmounts')
+            .split(',')
+            .map((s) => BigInt(s.trim()));
+        const priceReceivers = requireParam(params, 'priceReceivers')
+            .split(',')
+            .map((s) => s.trim());
+        const creditsAmount = Number(requireParam(params, 'creditsAmount'));
+        const accessLimit = optionalParam(params, 'accessLimit', 'credits');
+        const result = await payments.plans.registerPlan({ name, description, accessLimit }, {
+            amounts: priceAmounts,
+            receivers: priceReceivers,
+            isCrypto: true,
+        }, {
+            isRedemptionAmountFixed: true,
+            redemptionType: 4,
+            proofRequired: false,
+            durationSecs: 0n,
+            amount: BigInt(creditsAmount),
+            minAmount: 1n,
+            maxAmount: BigInt(creditsAmount),
+        }, undefined, accessLimit);
+        return { planId: result.planId };
+    },
+};
+const listPlans = {
+    name: 'nevermined.listPlans',
+    description: "List the builder's payment plans on Nevermined",
+    params: [],
+    handler: async (payments) => {
+        const result = await payments.plans.getPlans();
+        return result;
+    },
+};
+export const allTools = [
+    // Subscriber
+    checkBalance,
+    getAccessToken,
+    orderPlan,
+    queryAgent,
+    // Builder
+    registerAgent,
+    createPlan,
+    listPlans,
+];
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"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"}

package/openclaw.plugin.json

@@ -0,0 +1,63 @@
+{
+  "name": "@nevermined-io/openclaw-plugin",
+  "version": "0.1.0",
+  "description": "Nevermined plugin for OpenClaw — AI agent payments and access control",
+  "configSchema": {
+    "nvmApiKey": {
+      "type": "string",
+      "required": true,
+      "description": "Your Nevermined API key"
+    },
+    "environment": {
+      "type": "string",
+      "enum": ["sandbox", "live"],
+      "default": "sandbox",
+      "description": "Nevermined environment to connect to"
+    },
+    "planId": {
+      "type": "string",
+      "required": false,
+      "description": "Default payment plan ID (required for subscriber tools)"
+    },
+    "agentId": {
+      "type": "string",
+      "required": false,
+      "description": "Default agent ID (required for multi-agent plans)"
+    },
+    "creditsPerRequest": {
+      "type": "number",
+      "default": 1,
+      "description": "Number of credits consumed per request"
+    }
+  },
+  "uiHints": {
+    "nvmApiKey": {
+      "sensitive": true,
+      "label": "Nevermined API Key",
+      "placeholder": "sandbox:eyJhbG..."
+    },
+    "environment": {
+      "label": "Environment"
+    },
+    "planId": {
+      "label": "Plan ID",
+      "placeholder": "did:nv:..."
+    },
+    "agentId": {
+      "label": "Agent ID",
+      "placeholder": "did:nv:..."
+    }
+  },
+  "skills": ["skills/nevermined/SKILL.md"],
+  "gateway": {
+    "methods": [
+      "nevermined.checkBalance",
+      "nevermined.getAccessToken",
+      "nevermined.orderPlan",
+      "nevermined.queryAgent",
+      "nevermined.registerAgent",
+      "nevermined.createPlan",
+      "nevermined.listPlans"
+    ]
+  }
+}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@nevermined-io/openclaw-plugin",
+  "version": "1.0.11-rc.1",
+  "description": "OpenClaw plugin for Nevermined — exposes subscriber and builder tools as gateway methods",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist/",
+    "openclaw.plugin.json",
+    "skills/",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "NODE_OPTIONS='--experimental-vm-modules' jest --config jest.config.js",
+    "lint": "eslint src/ tests/ --ext .ts"
+  },
+  "peerDependencies": {
+    "@nevermined-io/payments": ">= 1.0.0"
+  },
+  "devDependencies": {
+    "@nevermined-io/payments": "^1.0.10",
+    "@types/jest": "^29.5.0",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.1.0",
+    "typescript": "^5.4.0",
+    "eslint": "^8.57.0",
+    "@typescript-eslint/eslint-plugin": "^7.0.0",
+    "@typescript-eslint/parser": "^7.0.0",
+    "zod": "^3.23.0"
+  },
+  "dependencies": {
+    "zod": "^3.23.0"
+  },
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nevermined-io/payments.git",
+    "directory": "openclaw"
+  },
+  "keywords": [
+    "nevermined",
+    "openclaw",
+    "ai-agents",
+    "payments",
+    "plugin"
+  ]
+}

package/skills/nevermined/SKILL.md

@@ -0,0 +1,55 @@
+---
+metadata:
+  openclaw:
+    requires:
+      config: ["plugins.nevermined.nvmApiKey"]
+---
+
+# Nevermined Tools
+
+This plugin provides gateway tools for interacting with Nevermined AI agent payments.
+
+## Subscriber Tools
+
+### `nevermined.checkBalance`
+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.
+- `planId` (optional if set in config)
+- `agentId` (optional if set in config)
+
+### `nevermined.orderPlan`
+Purchase a payment plan.
+- `planId` (optional if set in config)
+
+### `nevermined.queryAgent`
+End-to-end agent query — acquires a token, calls the agent, returns the response.
+- `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`)
+
+## Builder Tools
+
+### `nevermined.registerAgent`
+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
+- `priceReceivers` (required) — comma-separated receiver addresses
+- `creditsAmount` (required) — number of credits
+
+### `nevermined.createPlan`
+Create a standalone payment plan.
+- `name` (required) — plan name
+- `priceAmounts` (required) — comma-separated prices in wei
+- `priceReceivers` (required) — comma-separated receiver addresses
+- `creditsAmount` (required) — number of credits
+- `accessLimit` (optional) — `"credits"` or `"time"`
+
+### `nevermined.listPlans`
+List your payment plans. No parameters.