openclaw-nexos-provider 0.1.0 → 0.4.0

package/README.md

@@ -1,6 +1,6 @@
 # openclaw-nexos-provider
 
-An [OpenClaw](https://openclaw.ai) provider plugin for [Nexos AI](https://nexos.ai) —
+An [OpenClaw](https://openclaw.ai) provider plugin for [nexos.ai](https://nexos.ai) —
 a unified AI gateway that exposes Claude, GPT, Gemini, Grok, and 60+ other models
 through a single API endpoint and one API key.
 
@@ -25,12 +25,13 @@ openclaw plugins install openclaw-nexos-provider
 
 ## Configure
 
-Set your Nexos API key (either works):
+Provide your nexos.ai API key via the environment (this is all the provider
+needs — OpenClaw detects it from `NEXOS_API_KEY`):
 
 ```bash
 export NEXOS_API_KEY="your-nexos-key"
-# or, interactively:
-openclaw onboard --nexos-api-key "your-nexos-key"
+# optional, to run onboarding for the provider explicitly:
+openclaw onboard --auth-choice nexos-api-key
 ```
 
 Then pick a model:

package/dist/index.js

@@ -18,8 +18,9 @@ var MODEL_PREFIX_PRIORITIES = {
   "anthropic.claude": 400,
   grok: 600
 };
-function beautifyName(name) {
-  return name.replace(/-/g, " ").replace(/\./g, " ").replace(/@/g, " @ ").replace(/\b\w/g, (l) => l.toUpperCase());
+function costPerMillion(perToken) {
+  const value = typeof perToken === "string" ? Number.parseFloat(perToken) : perToken;
+  return Number.isFinite(value) && value > 0 ? value * 1e6 : 0;
 }
 function prioritizeModel(name) {
   for (const [pattern, priority] of Object.entries(MODEL_REGEX_PRIORITIES)) {
@@ -38,25 +39,29 @@ function buildNexosCatalog(apiData) {
   const models = [];
   for (const model of data) {
     const nexosModelId = model.nexos_model_id;
-    const rawName = model.name;
-    if (!nexosModelId || !rawName) {
+    const alias = model.name || model.id;
+    if (!nexosModelId || !alias) {
       continue;
     }
-    const alias = `Nexos ${beautifyName(rawName)}`;
     const endpoints = Array.isArray(model.endpoints) ? model.endpoints : ["chat_completions"];
     models.push({
       alias,
       nexosModelId,
-      priority: prioritizeModel(rawName),
+      priority: prioritizeModel(alias),
       endpoints,
       definition: {
         id: nexosModelId,
         name: alias,
         reasoning: true,
         input: ["text", "image"],
-        cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
-        maxTokens: DEFAULT_MAX_TOKENS,
-        contextWindow: DEFAULT_CONTEXT_WINDOW,
+        cost: {
+          input: costPerMillion(model.pricing?.input_cost_per_token),
+          output: costPerMillion(model.pricing?.output_cost_per_token),
+          cacheRead: 0,
+          cacheWrite: 0
+        },
+        maxTokens: typeof model.max_tokens === "number" && model.max_tokens > 0 ? model.max_tokens : DEFAULT_MAX_TOKENS,
+        contextWindow: typeof model.context_length === "number" && model.context_length > 0 ? model.context_length : DEFAULT_CONTEXT_WINDOW,
         compat: {
           supportsStore: true,
           supportsDeveloperRole: true,
@@ -138,8 +143,25 @@ function selectModels(models, providerId) {
   const { completions, anthropic } = splitByEndpoint(models);
   return providerId === NEXOS_PROVIDER_ANTHROPIC ? anthropic : completions;
 }
-function registerNexosProvider(api, providerId, label) {
+async function buildNexosProviderResult(providerId, apiKey) {
+  if (!apiKey) {
+    return null;
+  }
+  let models;
+  try {
+    models = await getNexosCatalog(apiKey);
+  } catch {
+    return null;
+  }
+  const selected = selectModels(models, providerId);
+  if (selected.length === 0) {
+    return null;
+  }
   const kind = providerId === NEXOS_PROVIDER_ANTHROPIC ? "anthropic" : "completions";
+  return { provider: buildProviderConfig({ models: selected, apiKey, kind }) };
+}
+function registerNexosProvider(api, providerId, label) {
+  const isPrimary = providerId === NEXOS_PROVIDER_COMPLETIONS;
   api.registerProvider({
     id: providerId,
     label,
@@ -149,34 +171,37 @@ function registerNexosProvider(api, providerId, label) {
       createProviderApiKeyAuthMethod({
         providerId,
         methodId: "api-key",
-        label: "Nexos AI API key",
-        hint: "API key from your Nexos AI dashboard",
+        label: "nexos.ai API key",
+        hint: "API key from your nexos.ai dashboard",
         optionKey: "nexosApiKey",
         flagName: "--nexos-api-key",
         envVar: "NEXOS_API_KEY",
-        promptMessage: "Enter your Nexos AI API key"
+        promptMessage: "Enter your nexos.ai API key",
+        // Expose the provider in `openclaw onboard` / auth-choice so the
+        // host runs its models.json materialization for nexos.
+        wizard: isPrimary ? {
+          choiceId: "nexos-api-key",
+          choiceLabel: "nexos.ai API key",
+          groupId: "nexos",
+          groupLabel: "nexos.ai",
+          onboardingScopes: ["text-inference"]
+        } : void 0
       })
     ],
+    // Live catalog: consulted at runtime (picker/refresh).
     catalog: {
       order: "simple",
       // eslint-disable-next-line @typescript-eslint/no-explicit-any
-      run: async (ctx) => {
-        const apiKey = resolveNexosApiKey(ctx, providerId);
-        if (!apiKey) {
-          return null;
-        }
-        let models;
-        try {
-          models = await getNexosCatalog(apiKey);
-        } catch {
-          return null;
-        }
-        const selected = selectModels(models, providerId);
-        if (selected.length === 0) {
-          return null;
-        }
-        return { provider: buildProviderConfig({ models: selected, apiKey, kind }) };
-      }
+      run: async (ctx) => buildNexosProviderResult(providerId, resolveNexosApiKey(ctx, providerId))
+    },
+    // Static catalog: consulted by the host's models.json generator to
+    // materialize selectable models (this build only lets you select models
+    // present in the agent's static catalog). Declared as `runtime` discovery
+    // in the manifest. Resolves the key from the environment since no ctx is
+    // provided here.
+    staticCatalog: {
+      order: "simple",
+      run: async () => buildNexosProviderResult(providerId, process.env.NEXOS_API_KEY)
     }
   });
   api.registerModelCatalogProvider({
@@ -206,11 +231,11 @@ function registerNexosProvider(api, providerId, label) {
 }
 var index_default = definePluginEntry({
   id: "nexos",
-  name: "Nexos AI",
-  description: "Nexos AI unified gateway \u2014 access Claude, GPT, Gemini, Grok and 60+ models through one API key.",
+  name: "nexos.ai",
+  description: "nexos.ai unified gateway \u2014 access Claude, GPT, Gemini, Grok and 60+ models through one API key.",
   register(api) {
-    registerNexosProvider(api, NEXOS_PROVIDER_COMPLETIONS, "Nexos AI");
-    registerNexosProvider(api, NEXOS_PROVIDER_ANTHROPIC, "Nexos AI (Claude)");
+    registerNexosProvider(api, NEXOS_PROVIDER_COMPLETIONS, "nexos.ai");
+    registerNexosProvider(api, NEXOS_PROVIDER_ANTHROPIC, "nexos.ai (Claude)");
   }
 });
 export {

package/docs/providers/nexos.md

@@ -1,9 +1,9 @@
 ---
-title: "Nexos AI"
-summary: "Use Nexos AI's unified gateway (Claude, GPT, Gemini, Grok, and more) in OpenClaw via one API key"
+title: "nexos.ai"
+summary: "Use nexos.ai's unified gateway (Claude, GPT, Gemini, Grok, and more) in OpenClaw via one API key"
 ---
 
-Nexos AI is a unified AI gateway that provides OpenAI-compatible access to models
+nexos.ai is a unified AI gateway that provides OpenAI-compatible access to models
 from many providers — Anthropic, OpenAI, Google, xAI, Mistral, and more — through
 a single API endpoint and API key.
 
@@ -17,12 +17,13 @@ This plugin registers two OpenClaw providers, both authenticated with
 
 ## Getting started
 
-1. Get an API key from your Nexos AI dashboard.
-2. Provide it to OpenClaw:
+1. Get an API key from your nexos.ai dashboard.
+2. Provide it to OpenClaw via the environment (auto-detected):
 
    ```bash
-   openclaw onboard --nexos-api-key "$NEXOS_API_KEY"
-   # or set NEXOS_API_KEY in the environment
+   export NEXOS_API_KEY="your-nexos-key"
+   # optional: run onboarding for the provider explicitly
+   openclaw onboard --auth-choice nexos-api-key
    ```
 
 3. Verify the models are available:

package/openclaw.plugin.json

@@ -1,11 +1,17 @@
 {
   "id": "nexos",
-  "name": "Nexos AI",
-  "description": "Nexos AI unified gateway — access Claude, GPT, Gemini, Grok and 60+ models through one API key.",
+  "name": "nexos.ai",
+  "description": "nexos.ai unified gateway — access Claude, GPT, Gemini, Grok and 60+ models through one API key.",
   "providers": ["nexos", "nexos-anthropic"],
   "modelSupport": {
     "modelPrefixes": ["nexos/", "nexos-anthropic/"]
   },
+  "modelCatalog": {
+    "discovery": {
+      "nexos": "runtime",
+      "nexos-anthropic": "runtime"
+    }
+  },
   "setup": {
     "providers": [
       { "id": "nexos", "envVars": ["NEXOS_API_KEY"] },
@@ -20,12 +26,12 @@
       "provider": "nexos",
       "method": "api-key",
       "choiceId": "nexos-api-key",
-      "choiceLabel": "Nexos AI API key",
+      "choiceLabel": "nexos.ai API key",
       "groupId": "nexos",
-      "groupLabel": "Nexos AI",
+      "groupLabel": "nexos.ai",
       "cliFlag": "--nexos-api-key",
       "cliOption": "--nexos-api-key <key>",
-      "cliDescription": "Nexos AI API key"
+      "cliDescription": "nexos.ai API key"
     }
   ],
   "activation": {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "openclaw-nexos-provider",
-  "version": "0.1.0",
-  "description": "Nexos AI model provider plugin for OpenClaw — access Claude, GPT, Gemini, Grok and 60+ models through one API key.",
+  "version": "0.4.0",
+  "description": "nexos.ai model provider plugin for OpenClaw — access Claude, GPT, Gemini, Grok and 60+ models through one API key.",
   "type": "module",
   "license": "MIT",
   "author": "fizikiukas",