@byoky/openclaw-plugin 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 byoky contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,43 @@
+import { OpenClawPluginApi } from 'openclaw/plugin-sdk/core';
+
+type PluginConfigUiHint = {
+    label?: string;
+    help?: string;
+    tags?: string[];
+    advanced?: boolean;
+    sensitive?: boolean;
+    placeholder?: string;
+};
+type PluginConfigValidation = {
+    ok: true;
+    value?: unknown;
+} | {
+    ok: false;
+    errors: string[];
+};
+type OpenClawPluginConfigSchema = {
+    safeParse?: (value: unknown) => {
+        success: boolean;
+        data?: unknown;
+        error?: {
+            issues?: Array<{
+                path: Array<string | number>;
+                message: string;
+            }>;
+        };
+    };
+    parse?: (value: unknown) => unknown;
+    validate?: (value: unknown) => PluginConfigValidation;
+    uiHints?: Record<string, PluginConfigUiHint>;
+    jsonSchema?: Record<string, unknown>;
+};
+
+declare const byokyPlugin: {
+    id: string;
+    name: string;
+    description: string;
+    configSchema: OpenClawPluginConfigSchema;
+    register(api: OpenClawPluginApi): void;
+};
+
+export { byokyPlugin as default };

package/dist/index.js

@@ -0,0 +1,501 @@
+// src/index.ts
+import {
+  emptyPluginConfigSchema
+} from "openclaw/plugin-sdk/core";
+import { createServer } from "http";
+var DEFAULT_BRIDGE_PORT = 19280;
+var ANTHROPIC_MODELS = [
+  {
+    id: "claude-opus-4-20250514",
+    name: "Claude Opus 4",
+    reasoning: true,
+    input: ["text", "image"],
+    cost: { input: 15, output: 75, cacheRead: 1.5, cacheWrite: 18.75 },
+    contextWindow: 2e5,
+    maxTokens: 32e3
+  },
+  {
+    id: "claude-sonnet-4-20250514",
+    name: "Claude Sonnet 4",
+    reasoning: true,
+    input: ["text", "image"],
+    cost: { input: 3, output: 15, cacheRead: 0.3, cacheWrite: 3.75 },
+    contextWindow: 2e5,
+    maxTokens: 16e3
+  },
+  {
+    id: "claude-haiku-4-5-20251001",
+    name: "Claude Haiku 4.5",
+    reasoning: false,
+    input: ["text", "image"],
+    cost: { input: 0.8, output: 4, cacheRead: 0.08, cacheWrite: 1 },
+    contextWindow: 2e5,
+    maxTokens: 8192
+  }
+];
+var OPENAI_MODELS = [
+  {
+    id: "gpt-4.1",
+    name: "GPT-4.1",
+    reasoning: false,
+    input: ["text", "image"],
+    cost: { input: 2, output: 8, cacheRead: 0.5, cacheWrite: 0 },
+    contextWindow: 1047576,
+    maxTokens: 32768
+  },
+  {
+    id: "o3",
+    name: "o3",
+    reasoning: true,
+    input: ["text", "image"],
+    cost: { input: 10, output: 40, cacheRead: 2.5, cacheWrite: 0 },
+    contextWindow: 2e5,
+    maxTokens: 1e5
+  },
+  {
+    id: "o4-mini",
+    name: "o4-mini",
+    reasoning: true,
+    input: ["text", "image"],
+    cost: { input: 1.1, output: 4.4, cacheRead: 0.275, cacheWrite: 0 },
+    contextWindow: 2e5,
+    maxTokens: 1e5
+  },
+  {
+    id: "gpt-4.1-mini",
+    name: "GPT-4.1 Mini",
+    reasoning: false,
+    input: ["text", "image"],
+    cost: { input: 0.4, output: 1.6, cacheRead: 0.1, cacheWrite: 0 },
+    contextWindow: 1047576,
+    maxTokens: 32768
+  }
+];
+var GEMINI_MODELS = [
+  {
+    id: "gemini-2.5-pro",
+    name: "Gemini 2.5 Pro",
+    reasoning: true,
+    input: ["text", "image"],
+    cost: { input: 1.25, output: 10, cacheRead: 0.315, cacheWrite: 0 },
+    contextWindow: 1048576,
+    maxTokens: 65536
+  },
+  {
+    id: "gemini-2.5-flash",
+    name: "Gemini 2.5 Flash",
+    reasoning: true,
+    input: ["text", "image"],
+    cost: { input: 0.15, output: 0.6, cacheRead: 0.0375, cacheWrite: 0 },
+    contextWindow: 1048576,
+    maxTokens: 65536
+  }
+];
+var DEEPSEEK_MODELS = [
+  {
+    id: "deepseek-chat",
+    name: "DeepSeek V3",
+    reasoning: false,
+    input: ["text"],
+    cost: { input: 0.27, output: 1.1, cacheRead: 0.07, cacheWrite: 0 },
+    contextWindow: 65536,
+    maxTokens: 8192
+  },
+  {
+    id: "deepseek-reasoner",
+    name: "DeepSeek R1",
+    reasoning: true,
+    input: ["text"],
+    cost: { input: 0.55, output: 2.19, cacheRead: 0.14, cacheWrite: 0 },
+    contextWindow: 65536,
+    maxTokens: 8192
+  }
+];
+var XAI_MODELS = [
+  {
+    id: "grok-3",
+    name: "Grok 3",
+    reasoning: false,
+    input: ["text"],
+    cost: { input: 3, output: 15, cacheRead: 0, cacheWrite: 0 },
+    contextWindow: 131072,
+    maxTokens: 16384
+  },
+  {
+    id: "grok-3-mini",
+    name: "Grok 3 Mini",
+    reasoning: true,
+    input: ["text"],
+    cost: { input: 0.3, output: 0.5, cacheRead: 0, cacheWrite: 0 },
+    contextWindow: 131072,
+    maxTokens: 16384
+  }
+];
+var MISTRAL_MODELS = [
+  {
+    id: "mistral-large-latest",
+    name: "Mistral Large",
+    reasoning: false,
+    input: ["text", "image"],
+    cost: { input: 2, output: 6, cacheRead: 0, cacheWrite: 0 },
+    contextWindow: 128e3,
+    maxTokens: 8192
+  }
+];
+var GROQ_MODELS = [
+  {
+    id: "llama-3.3-70b-versatile",
+    name: "Llama 3.3 70B",
+    reasoning: false,
+    input: ["text"],
+    cost: { input: 0.59, output: 0.79, cacheRead: 0, cacheWrite: 0 },
+    contextWindow: 128e3,
+    maxTokens: 32768
+  }
+];
+var EMPTY_MODELS = [];
+var PROVIDERS = [
+  { id: "anthropic", name: "Anthropic", api: "anthropic-messages", models: ANTHROPIC_MODELS },
+  { id: "openai", name: "OpenAI", api: "openai-completions", models: OPENAI_MODELS },
+  { id: "gemini", name: "Google Gemini", api: "openai-completions", models: GEMINI_MODELS },
+  { id: "mistral", name: "Mistral", api: "openai-completions", models: MISTRAL_MODELS },
+  { id: "cohere", name: "Cohere", api: "openai-completions", models: EMPTY_MODELS },
+  { id: "xai", name: "xAI (Grok)", api: "openai-completions", models: XAI_MODELS },
+  { id: "deepseek", name: "DeepSeek", api: "openai-completions", models: DEEPSEEK_MODELS },
+  { id: "perplexity", name: "Perplexity", api: "openai-completions", models: EMPTY_MODELS },
+  { id: "groq", name: "Groq", api: "openai-completions", models: GROQ_MODELS },
+  { id: "together", name: "Together AI", api: "openai-completions", models: EMPTY_MODELS },
+  { id: "fireworks", name: "Fireworks AI", api: "openai-completions", models: EMPTY_MODELS },
+  { id: "openrouter", name: "OpenRouter", api: "openai-completions", models: EMPTY_MODELS },
+  { id: "replicate", name: "Replicate", api: "openai-completions", models: EMPTY_MODELS },
+  { id: "huggingface", name: "Hugging Face", api: "openai-completions", models: EMPTY_MODELS },
+  { id: "azure_openai", name: "Azure OpenAI", api: "openai-completions", models: EMPTY_MODELS }
+];
+var byokyPlugin = {
+  id: "byoky",
+  name: "Byoky Wallet",
+  description: "Route LLM API calls through your Byoky browser wallet \u2014 keys never leave the extension",
+  configSchema: emptyPluginConfigSchema(),
+  register(api) {
+    for (const provider of PROVIDERS) {
+      const openclawId = `byoky-${provider.id}`;
+      api.registerProvider({
+        id: openclawId,
+        label: `${provider.name} (via Byoky)`,
+        docsPath: "/providers/byoky",
+        auth: [
+          {
+            id: "browser",
+            label: `${provider.name} (via Byoky)`,
+            hint: "Route through Byoky wallet \u2014 key stays in extension",
+            kind: "custom",
+            run: (ctx) => runProviderAuth(ctx, provider)
+          }
+        ],
+        wizard: {
+          onboarding: {
+            choiceId: openclawId,
+            choiceLabel: `${provider.name} (via Byoky)`,
+            choiceHint: "Route through Byoky wallet",
+            groupId: "byoky",
+            groupLabel: "Byoky Wallet",
+            groupHint: "Keys never leave the extension",
+            methodId: "browser"
+          }
+        }
+      });
+    }
+    api.registerCommand({
+      name: "byoky",
+      description: "Show Byoky bridge status and connected providers",
+      acceptsArgs: false,
+      handler: async () => {
+        const health = await checkBridgeHealth();
+        if (!health) {
+          return {
+            text: "Byoky Bridge: **offline**\n\nStart the bridge with `openclaw models auth login --provider byoky-anthropic` or ensure it is running on port " + DEFAULT_BRIDGE_PORT + "."
+          };
+        }
+        const providerList = health.providers.length > 0 ? health.providers.join(", ") : "none";
+        return {
+          text: `Byoky Bridge: **online** (port ${DEFAULT_BRIDGE_PORT})
+Providers: ${providerList}`
+        };
+      }
+    });
+  }
+};
+var index_default = byokyPlugin;
+async function checkBridgeHealth() {
+  try {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), 3e3);
+    const res = await fetch(`http://127.0.0.1:${DEFAULT_BRIDGE_PORT}/health`, {
+      signal: controller.signal
+    });
+    clearTimeout(timeout);
+    if (!res.ok) return null;
+    const data = await res.json();
+    if (data.status !== "ok") return null;
+    return { providers: data.providers ?? [] };
+  } catch {
+    return null;
+  }
+}
+async function runProviderAuth(ctx, provider) {
+  ctx.prompter.note(
+    `Opening your browser to connect ${provider.name} via Byoky wallet.
+Unlock your wallet and approve the connection.
+The Byoky Bridge must be installed: npm i -g @byoky/bridge && byoky-bridge install`
+  );
+  const result = await startCallbackServer(ctx, provider.id);
+  try {
+    if (!result.providers || !result.providers.includes(provider.id)) {
+      throw new Error(`${provider.name} not available in your Byoky wallet`);
+    }
+    const openclawId = `byoky-${provider.id}`;
+    return {
+      profiles: [
+        {
+          profileId: `${openclawId}:byoky`,
+          credential: {
+            type: "api_key",
+            provider: openclawId,
+            key: "byoky-proxy"
+          }
+        }
+      ],
+      configPatch: {
+        models: {
+          providers: {
+            [openclawId]: {
+              baseUrl: `http://127.0.0.1:${result.port}/${provider.id}`,
+              api: provider.api,
+              apiKey: "byoky-proxy",
+              models: provider.models
+            }
+          }
+        }
+      },
+      defaultModel: provider.models.length > 0 ? `${openclawId}/${provider.models[0].id}` : void 0,
+      notes: [
+        `Connected ${provider.name} via Byoky Bridge on port ${result.port}.`,
+        "Key stays in your browser extension \u2014 the bridge relays requests.",
+        "The bridge must be running for API calls to work.",
+        ...provider.models.length > 0 ? [`Available models: ${provider.models.map((m) => m.id).join(", ")}`] : ["No pre-defined models \u2014 set agents.defaults.model manually."]
+      ]
+    };
+  } finally {
+    result.server.close();
+  }
+}
+async function startCallbackServer(ctx, requestProviderId) {
+  return new Promise((resolve) => {
+    let resolved = false;
+    const server = createServer((req, res) => {
+      const reqOrigin = req.headers.origin || "";
+      let isLocalhost = false;
+      try {
+        const parsed = new URL(reqOrigin);
+        isLocalhost = parsed.hostname === "127.0.0.1" || parsed.hostname === "localhost";
+      } catch {
+      }
+      res.setHeader(
+        "Access-Control-Allow-Origin",
+        isLocalhost ? reqOrigin : "http://127.0.0.1"
+      );
+      res.setHeader("Access-Control-Allow-Methods", "POST, OPTIONS");
+      res.setHeader("Access-Control-Allow-Headers", "Content-Type");
+      if (req.method === "OPTIONS") {
+        res.writeHead(204);
+        res.end();
+        return;
+      }
+      if (req.method === "POST" && req.url === "/callback") {
+        let body = "";
+        req.on("data", (chunk) => {
+          body += chunk.toString();
+        });
+        req.on("end", () => {
+          try {
+            const data = JSON.parse(body);
+            res.writeHead(200, { "Content-Type": "application/json" });
+            res.end(JSON.stringify({ ok: true }));
+            if (!resolved) {
+              resolved = true;
+              resolve({
+                providers: data.providers || [],
+                port: data.bridgePort || DEFAULT_BRIDGE_PORT,
+                server
+              });
+            }
+          } catch {
+            res.writeHead(400);
+            res.end("Invalid JSON");
+          }
+        });
+        return;
+      }
+      if (req.method === "GET") {
+        res.writeHead(200, { "Content-Type": "text/html" });
+        res.end(buildAuthPage(requestProviderId));
+        return;
+      }
+      res.writeHead(404);
+      res.end();
+    });
+    server.listen(0, "127.0.0.1", () => {
+      const addr = server.address();
+      if (typeof addr === "object" && addr) {
+        ctx.openUrl(`http://127.0.0.1:${addr.port}`);
+      }
+    });
+    setTimeout(() => {
+      if (!resolved) {
+        resolved = true;
+        resolve({ providers: [], port: DEFAULT_BRIDGE_PORT, server });
+      }
+    }, 12e4);
+  });
+}
+var VALID_PROVIDER_IDS = new Set(PROVIDERS.map((p) => p.id));
+function buildAuthPage(requestProviderId) {
+  let providerFilter;
+  if (VALID_PROVIDER_IDS.has(requestProviderId)) {
+    providerFilter = `[{ id: ${JSON.stringify(requestProviderId)}, required: true }]`;
+  } else {
+    providerFilter = "[]";
+  }
+  return `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>Byoky \u2014 Connect to OpenClaw</title>
+  <style>
+    * { margin: 0; padding: 0; box-sizing: border-box; }
+    body {
+      font-family: -apple-system, system-ui, sans-serif;
+      background: #0a0a18; color: #f5f5f7;
+      min-height: 100vh; display: flex;
+      align-items: center; justify-content: center;
+    }
+    .card {
+      background: #1c1c22; border-radius: 16px;
+      padding: 40px; max-width: 440px; width: 100%; text-align: center;
+    }
+    h1 {
+      font-size: 24px; font-weight: 700;
+      background: linear-gradient(135deg, #e0f2fe, #0ea5e9);
+      -webkit-background-clip: text; -webkit-text-fill-color: transparent;
+      margin-bottom: 8px;
+    }
+    .subtitle { color: #8e8e9a; font-size: 14px; margin-bottom: 24px; }
+    .status {
+      padding: 16px; border-radius: 8px;
+      margin-bottom: 16px; font-size: 14px; line-height: 1.6;
+    }
+    .waiting { background: rgba(14,165,233,0.1); color: #7dd3fc; }
+    .success { background: rgba(52,211,153,0.1); color: #34d399; }
+    .error { background: rgba(244,63,94,0.1); color: #f43f5e; }
+    .info { color: #55555f; font-size: 12px; line-height: 1.6; }
+    .security { color: #34d399; font-size: 12px; margin-top: 16px; line-height: 1.6; }
+  </style>
+</head>
+<body>
+  <div class="card">
+    <h1>Byoky</h1>
+    <p class="subtitle">Connect wallet to OpenClaw</p>
+    <div id="status" class="status waiting">
+      Connecting to Byoky wallet...
+    </div>
+    <p class="info">
+      Your Byoky extension must be installed and unlocked.<br />
+      The Byoky Bridge must be installed for the proxy to work.
+    </p>
+    <p class="security">
+      Keys never leave your browser extension.<br />
+      API calls are proxied through the local Byoky Bridge.
+    </p>
+  </div>
+  <script>
+    (async () => {
+      const status = document.getElementById('status');
+      try {
+        // Step 1: Connect to Byoky wallet
+        const requestId = crypto.randomUUID();
+        window.postMessage({
+          type: 'BYOKY_CONNECT_REQUEST',
+          id: requestId,
+          requestId,
+          payload: { providers: ${providerFilter} },
+        }, '*');
+
+        const response = await new Promise((resolve, reject) => {
+          function handler(event) {
+            const msg = event.detail;
+            if (!msg || msg.requestId !== requestId) return;
+            document.removeEventListener('byoky-message', handler);
+            if (msg.type === 'BYOKY_CONNECT_RESPONSE') resolve(msg.payload);
+            else reject(new Error(msg.payload?.message || 'Connection failed'));
+          }
+          document.addEventListener('byoky-message', handler);
+          setTimeout(() => reject(new Error('Timeout \u2014 is Byoky installed and unlocked?')), 30000);
+        });
+
+        const providers = response.providers || {};
+        const available = Object.entries(providers)
+          .filter(([, v]) => v.available)
+          .map(([id]) => id);
+
+        if (available.length === 0) {
+          throw new Error('No matching providers found in your Byoky wallet');
+        }
+
+        status.textContent = 'Wallet connected! Starting bridge proxy...';
+
+        // Step 2: Tell the extension to start the bridge proxy
+        const bridgeRequestId = crypto.randomUUID();
+        window.postMessage({
+          type: 'BYOKY_INTERNAL_FROM_PAGE',
+          requestId: bridgeRequestId,
+          action: 'startBridgeProxy',
+          payload: { sessionKey: response.sessionKey, port: ${DEFAULT_BRIDGE_PORT} },
+        }, '*');
+
+        const bridgeResult = await new Promise((resolve, reject) => {
+          function handler(event) {
+            const msg = event.detail;
+            if (!msg || msg.requestId !== bridgeRequestId) return;
+            document.removeEventListener('byoky-message', handler);
+            resolve(msg.payload);
+          }
+          document.addEventListener('byoky-message', handler);
+          setTimeout(() => reject(new Error('Bridge proxy start timed out')), 15000);
+        });
+
+        const bridgePort = bridgeResult?.port || ${DEFAULT_BRIDGE_PORT};
+
+        status.textContent = 'Bridge proxy active on port ' + bridgePort + '. Connected ' + available.length + ' provider(s): ' + available.join(', ');
+        status.className = 'status success';
+
+        // Step 3: Send result back to OpenClaw callback server
+        await fetch('/callback', {
+          method: 'POST',
+          headers: { 'Content-Type': 'application/json' },
+          body: JSON.stringify({ providers: available, bridgePort: bridgePort }),
+        });
+
+        setTimeout(() => { status.textContent = 'Done \u2014 you can close this tab.'; }, 2000);
+      } catch (err) {
+        status.textContent = 'Error: ' + err.message;
+        status.className = 'status error';
+      }
+    })();
+  </script>
+</body>
+</html>`;
+}
+export {
+  index_default as default
+};

package/openclaw.plugin.json

@@ -0,0 +1,26 @@
+{
+  "id": "byoky",
+  "enabledByDefault": false,
+  "providers": [
+    "byoky-anthropic",
+    "byoky-openai",
+    "byoky-gemini",
+    "byoky-mistral",
+    "byoky-cohere",
+    "byoky-xai",
+    "byoky-deepseek",
+    "byoky-perplexity",
+    "byoky-groq",
+    "byoky-together",
+    "byoky-fireworks",
+    "byoky-openrouter",
+    "byoky-replicate",
+    "byoky-huggingface",
+    "byoky-azure_openai"
+  ],
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {}
+  }
+}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@byoky/openclaw-plugin",
+  "version": "0.3.0",
+  "description": "Byoky wallet provider plugin for OpenClaw — manage AI API keys from your browser wallet",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "openclaw.plugin.json",
+    "auth-page"
+  ],
+  "openclaw": {
+    "extensions": [
+      "./dist/index.js"
+    ]
+  },
+  "keywords": [
+    "byoky",
+    "openclaw",
+    "ai",
+    "api-key",
+    "wallet",
+    "plugin"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/MichaelLod/byoky.git",
+    "directory": "packages/openclaw-plugin"
+  },
+  "devDependencies": {
+    "@types/node": "25.5.0",
+    "openclaw": "^2026.3.13",
+    "tsup": "^8.0.0",
+    "typescript": "^5.5.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch"
+  }
+}