@blockrun/clawrouter 0.4.5 → 0.4.7

package/README.md

@@ -125,6 +125,7 @@ ClawRouter's keyword-based routing works with prompts in:
 | **Chinese (中文)**    | Han/CJK      | 证明, 定理, 你好, 什么是       |
 | **Japanese (日本語)** | Kanji + Kana | 証明, こんにちは, アルゴリズム |
 | **Russian (Русский)** | Cyrillic     | доказать, привет, алгоритм     |
+| **German (Deutsch)**  | Latin        | beweisen, hallo, algorithmus   |
 
 Mixed-language prompts are supported — keywords from all languages are checked simultaneously.
 
@@ -256,6 +257,60 @@ If you explicitly want to use a different wallet:
 2. Set `BLOCKRUN_WALLET_KEY=0x...`
 3. Restart OpenClaw
 
+### Wallet Backup & Recovery
+
+Your wallet private key is stored at `~/.openclaw/blockrun/wallet.key`. **Back up this file before terminating any VPS or machine!**
+
+#### Using the `/wallet` Command
+
+ClawRouter provides a built-in command for wallet management:
+
+```bash
+# Check wallet status (address, balance, file location)
+/wallet
+
+# Export private key for backup (shows the actual key)
+/wallet export
+```
+
+The `/wallet export` command displays your private key so you can copy it before terminating a machine.
+
+#### Manual Backup
+
+```bash
+# Option 1: Copy the key file
+cp ~/.openclaw/blockrun/wallet.key ~/backup-wallet.key
+
+# Option 2: View and copy the key
+cat ~/.openclaw/blockrun/wallet.key
+```
+
+#### Restore on a New Machine
+
+```bash
+# Option 1: Set environment variable (before installing ClawRouter)
+export BLOCKRUN_WALLET_KEY=0x...your_key_here...
+openclaw plugins install @blockrun/clawrouter
+
+# Option 2: Create the key file directly
+mkdir -p ~/.openclaw/blockrun
+echo "0x...your_key_here..." > ~/.openclaw/blockrun/wallet.key
+chmod 600 ~/.openclaw/blockrun/wallet.key
+openclaw plugins install @blockrun/clawrouter
+```
+
+**Important:** If a saved wallet file exists, it takes priority over the environment variable. To use a different wallet, delete the existing file first.
+
+#### Lost Key Recovery
+
+If you lose your wallet key, **there is no way to recover it**. The wallet is self-custodial, meaning only you have the private key. We do not store keys or have any way to restore access.
+
+**Prevention tips:**
+
+- Run `/wallet export` before terminating any VPS
+- Keep a secure backup of `~/.openclaw/blockrun/wallet.key`
+- For production use, consider using a hardware wallet or key management system
+
 ---
 
 ## Architecture

package/dist/index.js

@@ -730,7 +730,7 @@ var DEFAULT_ROUTING_CONFIG = {
   },
   scoring: {
     tokenCountThresholds: { simple: 50, complex: 500 },
-    // Multilingual keywords: English + Chinese (中文) + Japanese (日本語) + Russian (Русский)
+    // Multilingual keywords: English + Chinese (中文) + Japanese (日本語) + Russian (Русский) + German (Deutsch)
     codeKeywords: [
       // English
       "function",
@@ -773,7 +773,18 @@ var DEFAULT_ROUTING_CONFIG = {
       "\u043E\u0436\u0438\u0434\u0430\u0442\u044C",
       "\u043A\u043E\u043D\u0441\u0442\u0430\u043D\u0442\u0430",
       "\u043F\u0435\u0440\u0435\u043C\u0435\u043D\u043D\u0430\u044F",
-      "\u0432\u0435\u0440\u043D\u0443\u0442\u044C"
+      "\u0432\u0435\u0440\u043D\u0443\u0442\u044C",
+      // German
+      "funktion",
+      "klasse",
+      "importieren",
+      "definieren",
+      "abfrage",
+      "asynchron",
+      "erwarten",
+      "konstante",
+      "variable",
+      "zur\xFCckgeben"
     ],
     reasoningKeywords: [
       // English
@@ -814,7 +825,17 @@ var DEFAULT_ROUTING_CONFIG = {
       "\u0440\u0430\u0441\u0441\u0443\u0436\u0434\u0435\u043D\u0438",
       "\u0444\u043E\u0440\u043C\u0430\u043B\u044C\u043D\u043E",
       "\u043C\u0430\u0442\u0435\u043C\u0430\u0442\u0438\u0447\u0435\u0441\u043A\u0438",
-      "\u043B\u043E\u0433\u0438\u0447\u0435\u0441\u043A\u0438"
+      "\u043B\u043E\u0433\u0438\u0447\u0435\u0441\u043A\u0438",
+      // German
+      "beweisen",
+      "beweis",
+      "theorem",
+      "ableiten",
+      "schritt f\xFCr schritt",
+      "gedankenkette",
+      "formal",
+      "mathematisch",
+      "logisch"
     ],
     simpleKeywords: [
       // English
@@ -856,7 +877,18 @@ var DEFAULT_ROUTING_CONFIG = {
       "\u0441\u043A\u043E\u043B\u044C\u043A\u043E \u043B\u0435\u0442",
       "\u043A\u0442\u043E \u0442\u0430\u043A\u043E\u0439",
       "\u043A\u043E\u0433\u0434\u0430",
-      "\u043E\u0431\u044A\u044F\u0441\u043D\u0438"
+      "\u043E\u0431\u044A\u044F\u0441\u043D\u0438",
+      // German
+      "was ist",
+      "definiere",
+      "\xFCbersetze",
+      "hallo",
+      "ja oder nein",
+      "hauptstadt",
+      "wie alt",
+      "wer ist",
+      "wann",
+      "erkl\xE4re"
     ],
     technicalKeywords: [
       // English
@@ -892,7 +924,16 @@ var DEFAULT_ROUTING_CONFIG = {
       "\u0440\u0430\u0441\u043F\u0440\u0435\u0434\u0435\u043B\u0451\u043D\u043D\u044B\u0439",
       "\u043C\u0438\u043A\u0440\u043E\u0441\u0435\u0440\u0432\u0438\u0441",
       "\u0431\u0430\u0437\u0430 \u0434\u0430\u043D\u043D\u044B\u0445",
-      "\u0438\u043D\u0444\u0440\u0430\u0441\u0442\u0440\u0443\u043A\u0442\u0443\u0440\u0430"
+      "\u0438\u043D\u0444\u0440\u0430\u0441\u0442\u0440\u0443\u043A\u0442\u0443\u0440\u0430",
+      // German
+      "algorithmus",
+      "optimieren",
+      "architektur",
+      "verteilt",
+      "kubernetes",
+      "mikroservice",
+      "datenbank",
+      "infrastruktur"
     ],
     creativeKeywords: [
       // English
@@ -928,7 +969,16 @@ var DEFAULT_ROUTING_CONFIG = {
       "\u0442\u0432\u043E\u0440\u0447\u0435\u0441\u043A\u0438\u0439",
       "\u043F\u0440\u0435\u0434\u0441\u0442\u0430\u0432\u0438\u0442\u044C",
       "\u043F\u0440\u0438\u0434\u0443\u043C\u0430\u0439",
-      "\u043D\u0430\u043F\u0438\u0448\u0438"
+      "\u043D\u0430\u043F\u0438\u0448\u0438",
+      // German
+      "geschichte",
+      "gedicht",
+      "komponieren",
+      "brainstorming",
+      "kreativ",
+      "vorstellen",
+      "schreibe",
+      "erz\xE4hlung"
     ],
     // New dimension keyword lists (multilingual)
     imperativeVerbs: [
@@ -978,7 +1028,18 @@ var DEFAULT_ROUTING_CONFIG = {
       "\u0440\u0430\u0437\u0432\u0435\u0440\u043D\u0443\u0442\u044C",
       "\u0440\u0430\u0437\u0432\u0435\u0440\u043D\u0438",
       "\u043D\u0430\u0441\u0442\u0440\u043E\u0438\u0442\u044C",
-      "\u043D\u0430\u0441\u0442\u0440\u043E\u0439"
+      "\u043D\u0430\u0441\u0442\u0440\u043E\u0439",
+      // German
+      "erstellen",
+      "bauen",
+      "implementieren",
+      "entwerfen",
+      "entwickeln",
+      "konstruieren",
+      "generieren",
+      "bereitstellen",
+      "konfigurieren",
+      "einrichten"
     ],
     constraintIndicators: [
       // English
@@ -1015,7 +1076,16 @@ var DEFAULT_ROUTING_CONFIG = {
       "\u043C\u0430\u043A\u0441\u0438\u043C\u0443\u043C",
       "\u043C\u0438\u043D\u0438\u043C\u0443\u043C",
       "\u043E\u0433\u0440\u0430\u043D\u0438\u0447\u0435\u043D\u0438\u0435",
-      "\u0431\u044E\u0434\u0436\u0435\u0442"
+      "\u0431\u044E\u0434\u0436\u0435\u0442",
+      // German
+      "h\xF6chstens",
+      "mindestens",
+      "innerhalb",
+      "nicht mehr als",
+      "maximal",
+      "minimal",
+      "grenze",
+      "budget"
     ],
     outputFormatKeywords: [
       // English
@@ -1039,7 +1109,11 @@ var DEFAULT_ROUTING_CONFIG = {
       // Russian
       "\u0442\u0430\u0431\u043B\u0438\u0446\u0430",
       "\u0444\u043E\u0440\u043C\u0430\u0442\u0438\u0440\u043E\u0432\u0430\u0442\u044C \u043A\u0430\u043A",
-      "\u0441\u0442\u0440\u0443\u043A\u0442\u0443\u0440\u0438\u0440\u043E\u0432\u0430\u043D\u043D\u044B\u0439"
+      "\u0441\u0442\u0440\u0443\u043A\u0442\u0443\u0440\u0438\u0440\u043E\u0432\u0430\u043D\u043D\u044B\u0439",
+      // German
+      "tabelle",
+      "formatieren als",
+      "strukturiert"
     ],
     referenceKeywords: [
       // English
@@ -1075,7 +1149,16 @@ var DEFAULT_ROUTING_CONFIG = {
       "\u0434\u043E\u043A\u0443\u043C\u0435\u043D\u0442\u0430\u0446\u0438\u044F",
       "\u043A\u043E\u0434",
       "\u0440\u0430\u043D\u0435\u0435",
-      "\u0432\u043B\u043E\u0436\u0435\u043D\u0438\u0435"
+      "\u0432\u043B\u043E\u0436\u0435\u043D\u0438\u0435",
+      // German
+      "oben",
+      "unten",
+      "vorherige",
+      "folgende",
+      "dokumentation",
+      "der code",
+      "fr\xFCher",
+      "anhang"
     ],
     negationKeywords: [
       // English
@@ -1109,7 +1192,15 @@ var DEFAULT_ROUTING_CONFIG = {
       "\u0431\u0435\u0437",
       "\u043A\u0440\u043E\u043C\u0435",
       "\u0438\u0441\u043A\u043B\u044E\u0447\u0438\u0442\u044C",
-      "\u0431\u043E\u043B\u044C\u0448\u0435 \u043D\u0435"
+      "\u0431\u043E\u043B\u044C\u0448\u0435 \u043D\u0435",
+      // German
+      "nicht",
+      "vermeide",
+      "niemals",
+      "ohne",
+      "au\xDFer",
+      "ausschlie\xDFen",
+      "nicht mehr"
     ],
     domainSpecificKeywords: [
       // English
@@ -1147,7 +1238,16 @@ var DEFAULT_ROUTING_CONFIG = {
       "\u0442\u043E\u043F\u043E\u043B\u043E\u0433\u0438\u0447\u0435\u0441\u043A\u0438\u0439",
       "\u0433\u043E\u043C\u043E\u043C\u043E\u0440\u0444\u043D\u044B\u0439",
       "\u0441 \u043D\u0443\u043B\u0435\u0432\u044B\u043C \u0440\u0430\u0437\u0433\u043B\u0430\u0448\u0435\u043D\u0438\u0435\u043C",
-      "\u043D\u0430 \u043E\u0441\u043D\u043E\u0432\u0435 \u0440\u0435\u0448\u0451\u0442\u043E\u043A"
+      "\u043D\u0430 \u043E\u0441\u043D\u043E\u0432\u0435 \u0440\u0435\u0448\u0451\u0442\u043E\u043A",
+      // German
+      "quanten",
+      "photonik",
+      "genomik",
+      "proteomik",
+      "topologisch",
+      "homomorph",
+      "zero-knowledge",
+      "gitterbasiert"
     ],
     // Dimension weights (sum to 1.0)
     dimensionWeights: {
@@ -2322,6 +2422,7 @@ async function resolveOrGenerateWalletKey() {
 import { readFileSync, writeFileSync, existsSync, readdirSync, mkdirSync } from "fs";
 import { homedir as homedir3 } from "os";
 import { join as join4 } from "path";
+import { privateKeyToAccount as privateKeyToAccount4 } from "viem/accounts";
 
 // src/retry.ts
 var DEFAULT_RETRY_CONFIG = {
@@ -2551,6 +2652,81 @@ async function startProxyInBackground(api) {
   activeProxyHandle = proxy;
   api.logger.info(`BlockRun provider active \u2014 ${proxy.baseUrl}/v1 (smart routing enabled)`);
 }
+async function createWalletCommand() {
+  return {
+    name: "wallet",
+    description: "Show BlockRun wallet info or export private key for backup",
+    acceptsArgs: true,
+    requireAuth: true,
+    handler: async (ctx) => {
+      const subcommand = ctx.args?.trim().toLowerCase() || "status";
+      let walletKey;
+      let address;
+      try {
+        if (existsSync(WALLET_FILE)) {
+          walletKey = readFileSync(WALLET_FILE, "utf-8").trim();
+          if (walletKey.startsWith("0x") && walletKey.length === 66) {
+            const account = privateKeyToAccount4(walletKey);
+            address = account.address;
+          }
+        }
+      } catch {
+      }
+      if (!walletKey || !address) {
+        return {
+          text: `No ClawRouter wallet found.
+
+Run \`openclaw plugins install @blockrun/clawrouter\` to generate a wallet.`,
+          isError: true
+        };
+      }
+      if (subcommand === "export") {
+        return {
+          text: [
+            "\u{1F510} **ClawRouter Wallet Export**",
+            "",
+            "\u26A0\uFE0F **SECURITY WARNING**: Your private key controls your wallet funds.",
+            "Never share this key. Anyone with this key can spend your USDC.",
+            "",
+            `**Address:** \`${address}\``,
+            "",
+            `**Private Key:**`,
+            `\`${walletKey}\``,
+            "",
+            "**To restore on a new machine:**",
+            "1. Set the environment variable before running OpenClaw:",
+            `   \`export BLOCKRUN_WALLET_KEY=${walletKey}\``,
+            "2. Or save to file:",
+            `   \`mkdir -p ~/.openclaw/blockrun && echo "${walletKey}" > ~/.openclaw/blockrun/wallet.key && chmod 600 ~/.openclaw/blockrun/wallet.key\``
+          ].join("\n")
+        };
+      }
+      let balanceText = "Balance: (checking...)";
+      try {
+        const monitor = new BalanceMonitor(address);
+        const balance = await monitor.checkBalance();
+        balanceText = `Balance: ${balance.balanceUSD}`;
+      } catch {
+        balanceText = "Balance: (could not check)";
+      }
+      return {
+        text: [
+          "\u{1F99E} **ClawRouter Wallet**",
+          "",
+          `**Address:** \`${address}\``,
+          `**${balanceText}**`,
+          `**Key File:** \`${WALLET_FILE}\``,
+          "",
+          "**Commands:**",
+          "\u2022 `/wallet` - Show this status",
+          "\u2022 `/wallet export` - Export private key for backup",
+          "",
+          `**Fund with USDC on Base:** https://basescan.org/address/${address}`
+        ].join("\n")
+      };
+    }
+  };
+}
 var plugin = {
   id: "clawrouter",
   name: "ClawRouter",
@@ -2590,6 +2766,13 @@ var plugin = {
     if (!defaults.model) defaults.model = {};
     defaults.model.primary = "blockrun/auto";
     api.logger.info("BlockRun provider registered (30+ models via x402)");
+    createWalletCommand().then((walletCommand) => {
+      api.registerCommand(walletCommand);
+    }).catch((err) => {
+      api.logger.warn(
+        `Failed to register /wallet command: ${err instanceof Error ? err.message : String(err)}`
+      );
+    });
     api.registerService({
       id: "clawrouter-proxy",
       start: () => {