clawmux 0.3.2 → 0.3.4

package/README.md

@@ -14,15 +14,22 @@ Smart model routing + context compression proxy for OpenClaw.
 
 ## Installation
 
-Fetch the installation guide and follow it:
+Copy and paste this into your OpenClaw agent:
 
 ```bash
+Install and configure ClawMux by following the instructions here:
 curl -s https://raw.githubusercontent.com/HyeokjaeLee/ClawMux/refs/heads/main/docs/guide/installation.md
 ```
 
 ## Configuration
 
-Copy `clawmux.example.json` to `clawmux.json` and adjust as needed:
+ClawMux stores its config at `~/.openclaw/clawmux.json` (next to `openclaw.json`). `clawmux init` creates it automatically. You can also copy `clawmux.example.json` as a starting point:
+
+```bash
+cp clawmux.example.json ~/.openclaw/clawmux.json
+```
+
+Adjust as needed:
 
 ```jsonc
 {
@@ -46,7 +53,7 @@ Copy `clawmux.example.json` to `clawmux.json` and adjust as needed:
 }
 ```
 
-Config is watched for changes. Edit `clawmux.json` while the proxy is running and it reloads automatically.
+Config is watched for changes. Edit `~/.openclaw/clawmux.json` while the proxy is running and it reloads automatically. Override the path with `CLAWMUX_CONFIG=/path/to/clawmux.json`.
 
 ### Cross-Provider Routing
 
@@ -99,7 +106,7 @@ OpenClaw → ClawMux Proxy (localhost:3456) → Upstream Provider(s)
 
 ClawMux resolves each model's context window using this priority chain:
 
-1. **clawmux.json** `routing.contextWindows` — explicit per-model override
+1. **~/.openclaw/clawmux.json** `routing.contextWindows` — explicit per-model override
 2. **openclaw.json** `models.providers[provider].models[].contextWindow` — user config
 3. **OpenClaw built-in catalog** — pi-ai model database (812+ models)
 4. **Default: 200,000 tokens**

package/dist/cli.cjs

@@ -80,7 +80,7 @@ async function writeWebResponse(res, response) {
 
 // src/cli.ts
 var import_promises6 = require("node:fs/promises");
-var import_node_path6 = require("node:path");
+var import_node_path5 = require("node:path");
 var import_node_child_process = require("node:child_process");
 var import_node_os = require("node:os");
 
@@ -424,12 +424,17 @@ function validateConfig(raw) {
 }
 
 // src/config/loader.ts
-function findConfigPath() {
+function getHomeDir() {
+  return process.env.HOME ?? "/root";
+}
+function getClawmuxConfigPath() {
   const envPath = process.env.CLAWMUX_CONFIG;
-  if (envPath) {
+  if (envPath)
     return import_node_path.resolve(envPath);
-  }
-  return import_node_path.resolve(process.cwd(), "clawmux.json");
+  return import_node_path.join(getHomeDir(), ".openclaw", "clawmux.json");
+}
+function findConfigPath() {
+  return getClawmuxConfigPath();
 }
 async function loadConfig(configPath) {
   const filePath = configPath ?? findConfigPath();
@@ -553,7 +558,7 @@ function resolveEnvVar(value) {
   }
   return value;
 }
-function getHomeDir() {
+function getHomeDir2() {
   return process.env.HOME ?? "/root";
 }
 function getConfigPath(override) {
@@ -561,7 +566,7 @@ function getConfigPath(override) {
     return override;
   if (process.env.OPENCLAW_CONFIG_PATH)
     return process.env.OPENCLAW_CONFIG_PATH;
-  return import_node_path2.join(getHomeDir(), ".openclaw", "openclaw.json");
+  return import_node_path2.join(getHomeDir2(), ".openclaw", "openclaw.json");
 }
 async function readOpenClawConfig(configPath) {
   const path = getConfigPath(configPath);
@@ -584,7 +589,7 @@ async function readOpenClawConfig(configPath) {
 }
 function getAuthProfilesPath(agentId) {
   const id = agentId ?? "main";
-  return import_node_path2.join(getHomeDir(), ".openclaw", "agents", id, "agent", "auth-profiles.json");
+  return import_node_path2.join(getHomeDir2(), ".openclaw", "agents", id, "agent", "auth-profiles.json");
 }
 function parseAuthProfilesFile(text) {
   try {
@@ -618,7 +623,7 @@ function parseAuthProfilesFile(text) {
   }
 }
 async function readAuthProfiles(_agentId, _profilesPath, agentsDirOverride) {
-  const agentsDir = agentsDirOverride ?? import_node_path2.join(getHomeDir(), ".openclaw", "agents");
+  const agentsDir = agentsDirOverride ?? import_node_path2.join(getHomeDir2(), ".openclaw", "agents");
   let agentDirs;
   try {
     agentDirs = (await import_promises4.readdir(agentsDir, { withFileTypes: true })).filter((d) => d.isDirectory()).map((d) => d.name).sort();
@@ -3833,9 +3838,8 @@ function setupPipelineRoutes(config, openclawConfig, authProfiles, compressionMi
 }
 
 // src/index.ts
-var import_node_path4 = require("node:path");
 async function bootstrap(portOverride) {
-  const configPath = process.env.CLAWMUX_CONFIG ? import_node_path4.resolve(process.env.CLAWMUX_CONFIG) : import_node_path4.resolve(process.cwd(), "clawmux.json");
+  const configPath = getClawmuxConfigPath();
   const result = await loadConfig(configPath);
   if (!result.valid) {
     console.error("[clawmux] Config errors:");
@@ -3870,8 +3874,8 @@ if (typeof Bun !== "undefined" && Bun.main === "/home/runner/work/ClawMux/ClawMu
 
 // src/utils/logger.ts
 var import_node_fs2 = require("node:fs");
-var import_node_path5 = require("node:path");
-var LOG_DIR = import_node_path5.join(process.env.HOME ?? "/root", ".openclaw", "clawmux");
+var import_node_path4 = require("node:path");
+var LOG_DIR = import_node_path4.join(process.env.HOME ?? "/root", ".openclaw", "clawmux");
 var MAX_DAYS = 7;
 var fileStream = null;
 var currentDate = "";
@@ -3880,7 +3884,7 @@ function todayString() {
   return `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, "0")}-${String(d.getDate()).padStart(2, "0")}`;
 }
 function logPath(date) {
-  return import_node_path5.join(LOG_DIR, `${date}.log`);
+  return import_node_path4.join(LOG_DIR, `${date}.log`);
 }
 function rotateIfNeeded() {
   const today = todayString();
@@ -3898,7 +3902,7 @@ function purgeOldLogs() {
     const files = import_node_fs2.readdirSync(LOG_DIR).filter((f) => f.endsWith(".log")).sort();
     while (files.length > MAX_DAYS) {
       const oldest = files.shift();
-      import_node_fs2.unlinkSync(import_node_path5.join(LOG_DIR, oldest));
+      import_node_fs2.unlinkSync(import_node_path4.join(LOG_DIR, oldest));
     }
   } catch (_) {}
 }
@@ -3938,7 +3942,7 @@ function getLogDir() {
 }
 
 // src/cli.ts
-var VERSION2 = process.env.npm_package_version ?? "0.3.2";
+var VERSION2 = process.env.npm_package_version ?? "0.3.4";
 var SERVICE_NAME = "clawmux";
 var HELP = `Usage: clawmux <command>
 
@@ -3998,13 +4002,13 @@ function resolveClawmuxBin() {
     return detectPackageManager() === "bunx" ? "bunx clawmux" : "npx clawmux";
   }
 }
-function getHomeDir2() {
+function getHomeDir3() {
   return process.env.HOME ?? "/root";
 }
-var SYSTEMD_DIR = import_node_path6.join(getHomeDir2(), ".config", "systemd", "user");
-var SYSTEMD_PATH = import_node_path6.join(SYSTEMD_DIR, `${SERVICE_NAME}.service`);
-var LAUNCHD_DIR = import_node_path6.join(getHomeDir2(), "Library", "LaunchAgents");
-var LAUNCHD_PATH = import_node_path6.join(LAUNCHD_DIR, `com.${SERVICE_NAME}.plist`);
+var SYSTEMD_DIR = import_node_path5.join(getHomeDir3(), ".config", "systemd", "user");
+var SYSTEMD_PATH = import_node_path5.join(SYSTEMD_DIR, `${SERVICE_NAME}.service`);
+var LAUNCHD_DIR = import_node_path5.join(getHomeDir3(), "Library", "LaunchAgents");
+var LAUNCHD_PATH = import_node_path5.join(LAUNCHD_DIR, `com.${SERVICE_NAME}.plist`);
 function buildSystemdUnit(bin, port, workDir) {
   return `[Unit]
 Description=ClawMux - Smart model routing proxy
@@ -4023,7 +4027,7 @@ WantedBy=default.target
 `;
 }
 function buildLaunchdPlist(bin, port, workDir) {
-  const logDir = import_node_path6.join(getHomeDir2(), ".openclaw", "clawmux");
+  const logDir = import_node_path5.join(getHomeDir3(), ".openclaw", "clawmux");
   return `<?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
 <plist version="1.0">
@@ -4078,7 +4082,7 @@ async function installService(port, workDir) {
     }
   } else if (os === "darwin") {
     await import_promises6.mkdir(LAUNCHD_DIR, { recursive: true });
-    const logDir = import_node_path6.join(getHomeDir2(), ".openclaw", "clawmux");
+    const logDir = import_node_path5.join(getHomeDir3(), ".openclaw", "clawmux");
     await import_promises6.mkdir(logDir, { recursive: true });
     await import_promises6.writeFile(LAUNCHD_PATH, buildLaunchdPlist(bin, port, workDir));
     try {
@@ -4227,8 +4231,8 @@ async function update() {
 async function init() {
   const args = process.argv.slice(2);
   const noService = args.includes("--no-service");
-  const homeDir = getHomeDir2();
-  const openclawConfigPath = process.env.OPENCLAW_CONFIG_PATH ?? import_node_path6.join(homeDir, ".openclaw", "openclaw.json");
+  const homeDir = getHomeDir3();
+  const openclawConfigPath = process.env.OPENCLAW_CONFIG_PATH ?? import_node_path5.join(homeDir, ".openclaw", "openclaw.json");
   if (!await fileExistsLocal(openclawConfigPath)) {
     console.error(`[error] OpenClaw config not found at ${openclawConfigPath}`);
     console.error("Set OPENCLAW_CONFIG_PATH or ensure ~/.openclaw/openclaw.json exists");
@@ -4238,8 +4242,9 @@ async function init() {
   const backupPath = `${openclawConfigPath}.bak.${Date.now()}`;
   await import_promises6.copyFile(openclawConfigPath, backupPath);
   console.log(`[info] Backup created: ${backupPath}`);
-  const clawmuxJsonPath = import_node_path6.join(process.cwd(), "clawmux.json");
-  const examplePath = import_node_path6.join(process.cwd(), "clawmux.example.json");
+  const clawmuxJsonPath = getClawmuxConfigPath();
+  const examplePath = import_node_path5.join(process.cwd(), "clawmux.example.json");
+  console.log(`[info] Using ClawMux config: ${clawmuxJsonPath}`);
   if (!await fileExistsLocal(clawmuxJsonPath)) {
     if (await fileExistsLocal(examplePath)) {
       await import_promises6.copyFile(examplePath, clawmuxJsonPath);
@@ -4307,14 +4312,15 @@ async function init() {
 [info] ClawMux setup complete!`);
   console.log(`
 Next steps:`);
-  console.log("  1. Edit clawmux.json to configure your models");
+  console.log(`  1. Edit ${clawmuxJsonPath} to configure your models`);
   if (noService) {
     console.log("  2. Run: clawmux start");
   } else {
     console.log("  2. ClawMux is running and will auto-start on boot");
     console.log("     Check status: clawmux status");
   }
-  console.log("  3. Select a provider: openclaw provider clawmux-openai");
+  console.log("  3. Ask the user whether to switch agent and session models to clawmux/auto,");
+  console.log("     then use the openclaw CLI to apply their choice per agent.");
   console.log("  4. Start chatting: openclaw chat");
 }
 async function start() {
@@ -4331,8 +4337,8 @@ async function start() {
 }
 async function uninstall() {
   await removeService();
-  const homeDir = getHomeDir2();
-  const openclawConfigPath = process.env.OPENCLAW_CONFIG_PATH ?? import_node_path6.join(homeDir, ".openclaw", "openclaw.json");
+  const homeDir = getHomeDir3();
+  const openclawConfigPath = process.env.OPENCLAW_CONFIG_PATH ?? import_node_path5.join(homeDir, ".openclaw", "openclaw.json");
   if (await fileExistsLocal(openclawConfigPath)) {
     const backupPath = `${openclawConfigPath}.bak.${Date.now()}`;
     await import_promises6.copyFile(openclawConfigPath, backupPath);

package/dist/index.cjs

@@ -447,12 +447,17 @@ function validateConfig(raw) {
 }
 
 // src/config/loader.ts
-function findConfigPath() {
+function getHomeDir() {
+  return process.env.HOME ?? "/root";
+}
+function getClawmuxConfigPath() {
   const envPath = process.env.CLAWMUX_CONFIG;
-  if (envPath) {
+  if (envPath)
     return import_node_path.resolve(envPath);
-  }
-  return import_node_path.resolve(process.cwd(), "clawmux.json");
+  return import_node_path.join(getHomeDir(), ".openclaw", "clawmux.json");
+}
+function findConfigPath() {
+  return getClawmuxConfigPath();
 }
 async function loadConfig(configPath) {
   const filePath = configPath ?? findConfigPath();
@@ -576,7 +581,7 @@ function resolveEnvVar(value) {
   }
   return value;
 }
-function getHomeDir() {
+function getHomeDir2() {
   return process.env.HOME ?? "/root";
 }
 function getConfigPath(override) {
@@ -584,7 +589,7 @@ function getConfigPath(override) {
     return override;
   if (process.env.OPENCLAW_CONFIG_PATH)
     return process.env.OPENCLAW_CONFIG_PATH;
-  return import_node_path2.join(getHomeDir(), ".openclaw", "openclaw.json");
+  return import_node_path2.join(getHomeDir2(), ".openclaw", "openclaw.json");
 }
 async function readOpenClawConfig(configPath) {
   const path = getConfigPath(configPath);
@@ -607,7 +612,7 @@ async function readOpenClawConfig(configPath) {
 }
 function getAuthProfilesPath(agentId) {
   const id = agentId ?? "main";
-  return import_node_path2.join(getHomeDir(), ".openclaw", "agents", id, "agent", "auth-profiles.json");
+  return import_node_path2.join(getHomeDir2(), ".openclaw", "agents", id, "agent", "auth-profiles.json");
 }
 function parseAuthProfilesFile(text) {
   try {
@@ -641,7 +646,7 @@ function parseAuthProfilesFile(text) {
   }
 }
 async function readAuthProfiles(_agentId, _profilesPath, agentsDirOverride) {
-  const agentsDir = agentsDirOverride ?? import_node_path2.join(getHomeDir(), ".openclaw", "agents");
+  const agentsDir = agentsDirOverride ?? import_node_path2.join(getHomeDir2(), ".openclaw", "agents");
   let agentDirs;
   try {
     agentDirs = (await import_promises4.readdir(agentsDir, { withFileTypes: true })).filter((d) => d.isDirectory()).map((d) => d.name).sort();
@@ -3856,9 +3861,8 @@ function setupPipelineRoutes(config, openclawConfig, authProfiles, compressionMi
 }
 
 // src/index.ts
-var import_node_path4 = require("node:path");
 async function bootstrap(portOverride) {
-  const configPath = process.env.CLAWMUX_CONFIG ? import_node_path4.resolve(process.env.CLAWMUX_CONFIG) : import_node_path4.resolve(process.cwd(), "clawmux.json");
+  const configPath = getClawmuxConfigPath();
   const result = await loadConfig(configPath);
   if (!result.valid) {
     console.error("[clawmux] Config errors:");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clawmux",
-  "version": "0.3.2",
+  "version": "0.3.4",
   "description": "Smart model routing + context compression proxy for OpenClaw",
   "type": "module",
   "bin": {