@teith/openclaw-runware-provider 0.1.0

package/README.md

@@ -0,0 +1,102 @@
+# @runware/openclaw-provider
+
+OpenClaw provider plugin for [Runware](https://runware.ai) — a unified
+OpenAI-compatible endpoint that proxies Claude, GPT, Gemini, Qwen, GLM,
+MiniMax, Kimi, and Gemma models.
+
+## Install
+
+```bash
+openclaw plugins install git:github.com/runware/openclaw-provider@v0.1.0
+```
+
+Set your API key:
+
+```bash
+export RUNWARE_API_KEY=...your key...
+```
+
+Register the provider — this fetches the model catalog from Runware and
+writes it into your OpenClaw config:
+
+```bash
+openclaw models auth login --provider runware
+```
+
+Restart the Gateway if it's running. All Runware models appear in the
+Control UI picker.
+
+## Configuration
+
+| Variable | Required | Default | Purpose |
+|---|---|---|---|
+| `RUNWARE_API_KEY` | yes | — | API key, used for `/v1/models` discovery and inference |
+| `RUNWARE_BASE_URL` | no | `https://api.runware.ai/v1` | Override for dev / staging |
+
+Switching environments:
+
+```bash
+# dev
+export RUNWARE_BASE_URL=https://api.runware.dev/v1
+export RUNWARE_API_KEY=...dev key...
+openclaw models auth login --provider runware
+
+# prod (unset override)
+unset RUNWARE_BASE_URL
+export RUNWARE_API_KEY=...prod key...
+openclaw models auth login --provider runware
+```
+
+## What this plugin does
+
+- Registers `runware` as an OpenAI-compatible provider in OpenClaw.
+- Discovers the model catalog live from `GET /v1/models` on registration.
+  TTL-cached for 5 minutes; last-known-good on transient failures.
+- Injects `extra_body: { reasoning_effort: "high" }` into every chat
+  completions request, so reasoning-capable models stream thinking content.
+
+## Architecture
+
+Two-file core:
+
+- `src/index.ts` — plugin entry. Registers the provider, defines the
+  auth flow, and builds the model catalog.
+- `src/catalog.ts` — TTL-cached `GET /v1/models` fetcher with concurrent
+  request deduplication and last-known-good fallback.
+
+OpenClaw API surface is described locally in `src/openclaw-api.ts` —
+the plugin does not import from the `openclaw` package at runtime.
+
+## Development
+
+```bash
+pnpm install
+pnpm test
+pnpm typecheck
+pnpm build
+```
+
+Local install for testing:
+
+```bash
+openclaw plugins install -l /absolute/path/to/this/repo
+```
+
+Use `-l` to symlink — rebuilds become visible after `pnpm build` and a
+Gateway restart, without reinstalling.
+
+## Release
+
+```bash
+pnpm test && pnpm build
+git add . && git commit -m "Release v0.1.0"
+git tag v0.1.0
+git push origin main --tags
+```
+
+`dist/` is committed to the repository because OpenClaw installs plugins
+with `npm install --ignore-scripts` and cannot run a build step.
+
+## License
+
+MIT

package/dist/catalog.d.ts

@@ -0,0 +1,3 @@
+export declare function fetchModelIds(baseUrl: string, apiKey: string): Promise<string[]>;
+export declare function resetCache(): void;
+//# sourceMappingURL=catalog.d.ts.map

package/dist/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"AAeA,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAsBtF;AAwBD,wBAAgB,UAAU,IAAI,IAAI,CAGjC"}

package/dist/catalog.js

@@ -0,0 +1,54 @@
+const CACHE_TTL_MS = 5 * 60 * 1000;
+const FETCH_TIMEOUT_MS = 5000;
+let cache = null;
+let inflight = null;
+export async function fetchModelIds(baseUrl, apiKey) {
+    const now = Date.now();
+    if (cache && now - cache.fetchedAt < CACHE_TTL_MS) {
+        return cache.modelIds;
+    }
+    if (inflight)
+        return inflight;
+    inflight = (async () => {
+        try {
+            const ids = await fetchFromUpstream(baseUrl, apiKey);
+            cache = { modelIds: ids, fetchedAt: Date.now() };
+            return ids;
+        }
+        catch (err) {
+            if (cache)
+                return cache.modelIds;
+            throw err;
+        }
+        finally {
+            inflight = null;
+        }
+    })();
+    return inflight;
+}
+async function fetchFromUpstream(baseUrl, apiKey) {
+    const url = `${baseUrl.replace(/\/+$/, "")}/models`;
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
+    try {
+        const res = await fetch(url, {
+            headers: { Authorization: `Bearer ${apiKey}`, Accept: "application/json" },
+            signal: controller.signal,
+        });
+        if (!res.ok) {
+            throw new Error(`Runware /models returned ${res.status} ${res.statusText}`);
+        }
+        const body = (await res.json());
+        return (body.data ?? [])
+            .map((m) => (typeof m.id === "string" ? m.id : null))
+            .filter((id) => id !== null && id.length > 0);
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+export function resetCache() {
+    cache = null;
+    inflight = null;
+}
+//# sourceMappingURL=catalog.js.map

package/dist/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"AAAA,MAAM,YAAY,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;AACnC,MAAM,gBAAgB,GAAG,IAAI,CAAC;AAW9B,IAAI,KAAK,GAAsB,IAAI,CAAC;AACpC,IAAI,QAAQ,GAA6B,IAAI,CAAC;AAE9C,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAAe,EAAE,MAAc;IACjE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,IAAI,KAAK,IAAI,GAAG,GAAG,KAAK,CAAC,SAAS,GAAG,YAAY,EAAE,CAAC;QAClD,OAAO,KAAK,CAAC,QAAQ,CAAC;IACxB,CAAC;IAED,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAE9B,QAAQ,GAAG,CAAC,KAAK,IAAI,EAAE;QACrB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,iBAAiB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YACrD,KAAK,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;YACjD,OAAO,GAAG,CAAC;QACb,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,KAAK;gBAAE,OAAO,KAAK,CAAC,QAAQ,CAAC;YACjC,MAAM,GAAG,CAAC;QACZ,CAAC;gBAAS,CAAC;YACT,QAAQ,GAAG,IAAI,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,EAAE,CAAC;IAEL,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,KAAK,UAAU,iBAAiB,CAAC,OAAe,EAAE,MAAc;IAC9D,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,SAAS,CAAC;IACpD,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,gBAAgB,CAAC,CAAC;IAEvE,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAC3B,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,MAAM,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE;YAC1E,MAAM,EAAE,UAAU,CAAC,MAAM;SAC1B,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,4BAA4B,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC;QAC9E,CAAC;QACD,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAmB,CAAC;QAClD,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;aACrB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;aACpD,MAAM,CAAC,CAAC,EAAE,EAAgB,EAAE,CAAC,EAAE,KAAK,IAAI,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAChE,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,OAAO,CAAC,CAAC;IACxB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,KAAK,GAAG,IAAI,CAAC;IACb,QAAQ,GAAG,IAAI,CAAC;AAClB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+import type { PluginEntry } from "./openclaw-api.js";
+declare const entry: PluginEntry;
+export default entry;
+//# 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":"AACA,OAAO,KAAK,EAIV,WAAW,EAEZ,MAAM,mBAAmB,CAAC;AA6F3B,QAAA,MAAM,KAAK,EAAE,WA2DZ,CAAC;AAEF,eAAe,KAAK,CAAC"}

package/dist/index.js

@@ -0,0 +1,137 @@
+import { fetchModelIds } from "./catalog.js";
+const PLUGIN_ID = "runware-openclaw-provider";
+const PROVIDER_ID = "runware";
+const PROVIDER_LABEL = "Runware";
+const DEFAULT_BASE_URL = "https://api.runware.ai/v1";
+const DEFAULT_MODEL = "runware/anthropic-claude-sonnet-4-6";
+const API_KEY_ENV_VAR = "RUNWARE_API_KEY";
+const BASE_URL_ENV_VAR = "RUNWARE_BASE_URL";
+const REQUEST_TIMEOUT_SECONDS = 600;
+const MODEL_CONTEXT_WINDOW = 200_000;
+const MODEL_MAX_TOKENS = 32_768;
+const MODEL_INPUT_MODALITIES = ["text"];
+const MODEL_PARAMS = { extra_body: { reasoning_effort: "high" } };
+const ZERO_COST = { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 };
+function getBaseUrl(env) {
+    const override = (env?.[BASE_URL_ENV_VAR] ?? process.env[BASE_URL_ENV_VAR])?.trim();
+    return override && override.length > 0 ? override : DEFAULT_BASE_URL;
+}
+function resolveApiKey(ctx) {
+    return ctx?.env?.[API_KEY_ENV_VAR] ?? process.env[API_KEY_ENV_VAR];
+}
+function humanizeModelId(id) {
+    return id
+        .replace(/[-_:@]/g, " ")
+        .replace(/\bfp8\b/gi, "FP8")
+        .trim()
+        .split(/\s+/)
+        .map((word) => (word.length > 0 ? word[0].toUpperCase() + word.slice(1) : word))
+        .join(" ");
+}
+function buildModelEntry(id) {
+    return {
+        id,
+        name: humanizeModelId(id),
+        reasoning: true,
+        input: MODEL_INPUT_MODALITIES,
+        contextWindow: MODEL_CONTEXT_WINDOW,
+        maxTokens: MODEL_MAX_TOKENS,
+        cost: ZERO_COST,
+        params: MODEL_PARAMS,
+    };
+}
+async function buildProvider(apiKey, baseUrl) {
+    const ids = await fetchModelIds(baseUrl, apiKey);
+    return {
+        baseUrl,
+        apiKey,
+        api: "openai-completions",
+        timeoutSeconds: REQUEST_TIMEOUT_SECONDS,
+        models: ids.map(buildModelEntry),
+    };
+}
+function buildAgentModelsPatch(provider) {
+    const patch = {};
+    for (const model of provider.models) {
+        const key = `${PROVIDER_ID}/${model.id}`;
+        patch[key] = model.params ? { params: model.params } : {};
+    }
+    return patch;
+}
+async function authFlow(ctx) {
+    const apiKey = resolveApiKey(ctx);
+    if (!apiKey) {
+        throw new Error(`${API_KEY_ENV_VAR} is not set. Export it before running auth.`);
+    }
+    const provider = await buildProvider(apiKey, getBaseUrl(ctx.env));
+    return {
+        profiles: [
+            {
+                profileId: `${PROVIDER_ID}:default`,
+                provider: PROVIDER_ID,
+                credential: { type: "api-key", provider: PROVIDER_ID, apiKey },
+            },
+        ],
+        defaultModel: DEFAULT_MODEL,
+        configPatch: {
+            models: { providers: { [PROVIDER_ID]: provider } },
+            agents: { defaults: { models: buildAgentModelsPatch(provider) } },
+        },
+    };
+}
+const entry = {
+    id: PLUGIN_ID,
+    name: "Runware",
+    description: "Runware — unified OpenAI-compatible access to Claude, GPT, Gemini, Qwen, GLM, MiniMax, Kimi, and Gemma.",
+    register(api) {
+        api.registerProvider({
+            id: PROVIDER_ID,
+            label: PROVIDER_LABEL,
+            docsPath: "https://docs.runware.ai",
+            envVars: [API_KEY_ENV_VAR, BASE_URL_ENV_VAR],
+            auth: [
+                {
+                    id: "api-key",
+                    kind: "api-key",
+                    label: PROVIDER_LABEL,
+                    hint: `Runware API key — set ${API_KEY_ENV_VAR} or get one at https://runware.ai`,
+                    envVar: API_KEY_ENV_VAR,
+                    flagName: "--runware-api-key",
+                    optionKey: "runwareApiKey",
+                    promptMessage: "Enter your Runware API key",
+                    defaultModel: DEFAULT_MODEL,
+                    run: authFlow,
+                    runNonInteractive: authFlow,
+                },
+            ],
+            discovery: {
+                order: "late",
+                run: async (ctx) => {
+                    const apiKey = resolveApiKey(ctx);
+                    if (!apiKey)
+                        return null;
+                    return { provider: await buildProvider(apiKey, getBaseUrl(ctx.env)) };
+                },
+            },
+            wizard: {
+                setup: {
+                    choiceId: "runware",
+                    choiceLabel: "Runware",
+                    choiceHint: "Runware multi-model gateway",
+                    groupId: "runware",
+                    groupLabel: "Runware",
+                    groupHint: "Runware multi-model gateway",
+                    methodId: "api-key",
+                },
+                modelPicker: {
+                    label: "Runware",
+                    hint: "Enter your Runware API key",
+                    methodId: "api-key",
+                },
+            },
+            buildUnknownModelHint: () => `Runware requires authentication. Set ${API_KEY_ENV_VAR} or run "openclaw models auth login --provider runware".`,
+        });
+    },
+};
+export default entry;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/openclaw-api.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Local description of the OpenClaw plugin API surface we use.
+ *
+ * Derived from inspecting bundled provider plugins in OpenClaw 2026.4.29.
+ * We do not import these types from `openclaw` — a plugin is a contract,
+ * not a dependency. If/when an official @openclaw/plugin-sdk ships, swap
+ * the interfaces below for imports in one place.
+ */
+import type { ModelCost } from "./types.js";
+export type DiscoveryOrder = "simple" | "profile" | "paired" | "late";
+export type ProviderApi = "openai-completions" | "openai-responses" | "anthropic-by-model" | "google-gemini" | "passthrough-gemini" | "hybrid-anthropic-openai" | "amazon-bedrock";
+export interface ModelEntry {
+    id: string;
+    name: string;
+    reasoning: boolean;
+    input: string[];
+    contextWindow: number;
+    maxTokens: number;
+    cost: ModelCost;
+    params?: Record<string, unknown>;
+}
+export interface ProviderShape {
+    baseUrl: string;
+    apiKey: string;
+    api: ProviderApi;
+    timeoutSeconds?: number;
+    models: ModelEntry[];
+}
+export interface DiscoveryResult {
+    provider?: ProviderShape;
+    providers?: Record<string, ProviderShape>;
+}
+export interface DiscoveryContext {
+    config?: unknown;
+    env?: Record<string, string | undefined>;
+    resolveProviderApiKey?: (providerId: string) => {
+        apiKey?: string;
+    };
+}
+export interface AuthRunContext {
+    prompter?: unknown;
+    config?: unknown;
+    env?: Record<string, string | undefined>;
+}
+export interface AuthMethod {
+    id: string;
+    kind: string;
+    label: string;
+    hint?: string;
+    envVar?: string;
+    flagName?: string;
+    optionKey?: string;
+    promptMessage?: string;
+    defaultModel?: string;
+    run?: (ctx: AuthRunContext) => Promise<unknown>;
+    runNonInteractive?: (ctx: AuthRunContext) => Promise<unknown>;
+}
+export interface WizardSetup {
+    choiceId: string;
+    choiceLabel: string;
+    choiceHint?: string;
+    groupId?: string;
+    groupLabel?: string;
+    groupHint?: string;
+    methodId: string;
+}
+export interface WizardModelPicker {
+    label: string;
+    hint?: string;
+    methodId: string;
+}
+export interface ProviderSpec {
+    id: string;
+    label: string;
+    docsPath?: string;
+    envVars?: string[];
+    auth: AuthMethod[];
+    discovery?: {
+        order: DiscoveryOrder;
+        run: (ctx: DiscoveryContext) => Promise<DiscoveryResult | null>;
+    };
+    wizard?: {
+        setup?: WizardSetup;
+        modelPicker?: WizardModelPicker;
+    };
+    buildUnknownModelHint?: () => string;
+}
+export interface PluginApi {
+    registerProvider: (spec: ProviderSpec) => void;
+}
+export interface PluginEntry {
+    id: string;
+    name: string;
+    description?: string;
+    register: (api: PluginApi) => void;
+}
+//# sourceMappingURL=openclaw-api.d.ts.map

package/dist/openclaw-api.d.ts.map

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

package/dist/openclaw-api.js

@@ -0,0 +1,10 @@
+/**
+ * Local description of the OpenClaw plugin API surface we use.
+ *
+ * Derived from inspecting bundled provider plugins in OpenClaw 2026.4.29.
+ * We do not import these types from `openclaw` — a plugin is a contract,
+ * not a dependency. If/when an official @openclaw/plugin-sdk ships, swap
+ * the interfaces below for imports in one place.
+ */
+export {};
+//# sourceMappingURL=openclaw-api.js.map

package/dist/openclaw-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openclaw-api.js","sourceRoot":"","sources":["../src/openclaw-api.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/types.d.ts

@@ -0,0 +1,7 @@
+export interface ModelCost {
+    input: number;
+    output: number;
+    cacheRead: number;
+    cacheWrite: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/openclaw.plugin.json

@@ -0,0 +1,45 @@
+{
+  "id": "runware-openclaw-provider",
+  "name": "@runware/openclaw-provider",
+  "version": "0.1.0",
+  "type": "module",
+  "configSchema": {
+    "$schema": "http://json-schema.org/draft-07/schema#",
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {}
+  },
+  "activation": { "onStartup": true },
+  "providers": ["runware"],
+  "providerRequest": {
+    "providers": {
+      "runware": {
+        "family": "runware",
+        "openAICompletions": { "supportsStreamingUsage": true }
+      }
+    }
+  },
+  "setup": {
+    "providers": [{ "id": "runware", "envVars": ["RUNWARE_API_KEY"] }]
+  },
+  "providerAuthChoices": [
+    {
+      "provider": "runware",
+      "method": "api-key",
+      "choiceId": "runware",
+      "choiceLabel": "Runware",
+      "choiceHint": "Runware multi-model gateway",
+      "groupId": "runware",
+      "groupLabel": "Runware",
+      "groupHint": "Runware multi-model gateway"
+    }
+  ],
+  "modelPricing": {
+    "providers": { "runware": { "external": false } }
+  },
+  "openclaw": {
+    "id": "runware-openclaw-provider",
+    "extensions": ["./dist/index.js"],
+    "providers": ["runware"]
+  }
+}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@teith/openclaw-runware-provider",
+  "version": "0.1.0",
+  "description": "OpenClaw provider plugin for Runware — unified OpenAI-compatible access to Claude, GPT, Gemini, Qwen, GLM, MiniMax, Kimi, and Gemma.",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./openclaw.plugin.json": "./openclaw.plugin.json"
+  },
+  "files": ["dist", "openclaw.plugin.json", "README.md", "LICENSE"],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "dev": "tsc -p tsconfig.build.json --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "pnpm run clean && pnpm run build && pnpm run test"
+  },
+  "openclaw": {
+    "id": "runware-openclaw-provider",
+    "extensions": ["./dist/index.js"],
+    "providers": ["runware"]
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/runware/openclaw-provider.git"
+  },
+  "keywords": ["openclaw", "openclaw-plugin", "runware", "llm", "ai-provider"],
+  "engines": { "node": ">=20" },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.6.0",
+    "vitest": "^2.0.0"
+  }
+}