clawd-models 1.0.2 → 1.0.4

package/README.md

@@ -2,6 +2,10 @@
 
 CLI tool to manage OpenClaw model configurations.
 
+## Quick Start Flow
+
+![Setup Flow](docs/setup-flow.svg)
+
 ## Prerequisite
 Install and Setup `openclaw` firstly, refer to https://github.com/openclaw/openclaw
 ```
@@ -22,10 +26,26 @@ npm i -g clawd-models
 ## Usage
 
 ```bash
-clawd-models <command>
+clawd-models <command> [--bot <openclaw|clawdbot|moltbot>]
 # clawd-models help
 ```
 
+**Global Options:**
+- `--bot <bot-id>` - Target bot (openclaw, clawdbot, moltbot). Also saves as default for future commands.
+- `--clear-bot` - Clear the default bot setting
+
+**Bot Priority (when --bot not specified):**
+1. Saved preference (if set via previous `--bot` use)
+2. Auto-detect: openclaw → clawdbot → moltbot
+
+**Config Locations:**
+- OpenClaw: `~/.openclaw/openclaw.json`
+- ClawdBot: `~/.clawdbot/clawdbot.json`
+- MoltBot: `~/.moltbot/moltbot.json`
+- Preferred bot: `~/.clawd-models/bot`
+
+**Default Bot Priority:** `openclaw` → `clawdbot` → `moltbot` (auto-selected if not specified via `--bot`)
+
 ## Commands
 
 ### Core
@@ -43,13 +63,15 @@ clawd-models <command>
 | `providers:add -n <name> -u <url> [-k <api-key>]` | Add a new model provider |
 | `providers:remove -n <name>` | Remove a model provider |
 | `providers:list` | List all configured providers |
+Should add a provider firstly, then add a model (refer to next section).
 
 ### Model Management
 | Command | Description |
 |---------|-------------|
 | `models:add -p <provider> -i <model-id> --name <name>` | Add a model to a provider |
 | `models:remove -p <provider> -i <model-id>` | Remove a model from a provider |
-| `model:list [--provider <name>]` | List all configured models |
+| `models:list [--provider <name>]` | List all configured models |
+| `models:test` | Test the default model configuration by sending a test message |
 
 Use `agents:set-default` in next section or refer to `openclaw models set` to set a default model for 'main' and all agents.
 
@@ -79,4 +101,8 @@ Refer to `openclaw gateway status` for more.
 
 ## Configuration Location
 
-`~/.openclaw/openclaw.json`
+`~/.openclaw/openclaw.json`
+or
+`~/.clawdbot/clawdbot.json`
+or
+`~/.moltbot/moltbot.json`

package/bin/clawd-models.js

@@ -6,14 +6,210 @@ const path = require('path');
 const os = require('os');
 
 const OPENCLAW_CONFIG_PATH = path.join(os.homedir(), '.openclaw', 'openclaw.json');
+const CLAWD_MODELS_DIR = path.join(os.homedir(), '.clawd-models');
+const CLAWD_MODELS_BOT_FILE = path.join(CLAWD_MODELS_DIR, 'bot.json');
 
 const CURRENT_VERSION = '2026.2.1';
 
+// Supported bot configurations
+const BOT_CONFIGS = [
+  { id: 'openclaw', name: 'OpenClaw', path: '.openclaw/openclaw.json' },
+  { id: 'clawdbot', name: 'ClawdBot', path: '.clawdbot/clawdbot.json' },
+  { id: 'moltbot', name: 'MoltBot', path: '.moltbot/moltbot.json' }
+];
+
+function getBotConfigPath(botId) {
+  const bot = BOT_CONFIGS.find(b => b.id === botId);
+  if (!bot) return null;
+  return path.join(os.homedir(), bot.path);
+}
+
+function loadPreferredBot() {
+  if (fs.existsSync(CLAWD_MODELS_BOT_FILE)) {
+    try {
+      const content = JSON.parse(fs.readFileSync(CLAWD_MODELS_BOT_FILE, 'utf8'));
+      const botId = content.bot;
+      // Validate it's a known bot
+      if (botId && BOT_CONFIGS.some(b => b.id === botId)) {
+        return botId;
+      }
+    } catch (e) {
+      return null;
+    }
+  }
+  return null;
+}
+
+function savePreferredBot(botId) {
+  // Validate bot ID
+  if (!BOT_CONFIGS.some(b => b.id === botId)) {
+    console.error(`Unknown bot: ${botId}. Valid options: ${BOT_CONFIGS.map(b => b.id).join(', ')}`);
+    process.exit(1);
+  }
+  fs.ensureDirSync(CLAWD_MODELS_DIR);
+  fs.writeFileSync(CLAWD_MODELS_BOT_FILE, JSON.stringify({ bot: botId }, null, 2));
+}
+
+function clearPreferredBot() {
+  if (fs.existsSync(CLAWD_MODELS_BOT_FILE)) {
+    fs.unlinkSync(CLAWD_MODELS_BOT_FILE);
+  }
+}
+
+async function promptBotSelection() {
+  const available = [];
+  for (const bot of BOT_CONFIGS) {
+    const configPath = getBotConfigPath(bot.id);
+    if (fs.existsSync(configPath)) {
+      available.push(bot);
+    }
+  }
+
+  if (available.length === 0) {
+    console.log('No bot configurations found.');
+    console.log('Expected locations:');
+    for (const bot of BOT_CONFIGS) {
+      console.log(`  ${bot.name}: ${getBotConfigPath(bot.id)}`);
+    }
+    return null;
+  }
+
+  if (available.length === 1) {
+    return available[0];
+  }
+
+  console.log('Multiple bot configurations found. Select one:');
+  for (let i = 0; i < available.length; i++) {
+    console.log(`  ${i + 1}. ${available[i].name} (${getBotConfigPath(available[i].id)})`);
+  }
+
+  const { promisify } = require('util');
+  const readline = require('readline');
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  const question = promisify(rl.question).bind(rl);
+
+  while (true) {
+    const answer = await question('\nEnter number (1-' + available.length + '): ');
+    const idx = parseInt(answer) - 1;
+    if (idx >= 0 && idx < available.length) {
+      rl.close();
+      return available[idx];
+    }
+    console.log('Invalid selection. Please try again.');
+  }
+}
+
+async function resolveConfig(botOption) {
+  if (botOption) {
+    const bot = BOT_CONFIGS.find(b => b.id === botOption);
+    if (!bot) {
+      throw new Error(`Unknown bot: ${botOption}. Available: ${BOT_CONFIGS.map(b => b.id).join(', ')}`);
+    }
+    const configPath = getBotConfigPath(bot.id);
+    if (!fs.existsSync(configPath)) {
+      throw new Error(`${bot.name} config not found at ~/.${bot.name}/${bot.name}.json`);
+    }
+    return { bot, configPath };
+  }
+
+  // No bot specified, prompt or auto-detect
+  const bot = await promptBotSelection();
+  if (!bot) {
+    throw new Error('No bot configurations available');
+  }
+  return { bot, configPath: getBotConfigPath(bot.id) };
+}
+
+function loadBotConfig(botOption) {
+  const { configPath } = resolveConfigSync(botOption);
+  const content = fs.readFileSync(configPath, 'utf8');
+  return JSON.parse(content);
+}
+
+function resolveConfigSync(botOption) {
+  // If botOption is provided, validate and use it
+  if (botOption) {
+    const bot = BOT_CONFIGS.find(b => b.id === botOption);
+    if (!bot) {
+      throw new Error(`Unknown bot: ${botOption}. Available: ${BOT_CONFIGS.map(b => b.id).join(', ')}`);
+    }
+    const configPath = getBotConfigPath(bot.id);
+    if (!fs.existsSync(configPath)) {
+      throw new Error(`${bot.name} config not found at ${configPath}`);
+    }
+    return { bot, configPath };
+  }
+
+  // Auto-detect: try saved preference first, then priority order
+  const savedBot = loadPreferredBot();
+  if (savedBot) {
+    const bot = BOT_CONFIGS.find(b => b.id === savedBot);
+    const configPath = getBotConfigPath(savedBot);
+    if (bot && fs.existsSync(configPath)) {
+      return { bot, configPath };
+    }
+  }
+
+  // Try bots in priority order: openclaw -> clawdbot -> moltbot
+  const priorityOrder = ['openclaw', 'clawdbot', 'moltbot'];
+  for (const botId of priorityOrder) {
+    const configPath = getBotConfigPath(botId);
+    if (fs.existsSync(configPath)) {
+      const bot = BOT_CONFIGS.find(b => b.id === botId);
+      // Auto-detected and valid, save as preference
+      savePreferredBot(bot.id);
+      console.log(`Auto-detected bot: ${bot.id}`);
+      return { bot, configPath };
+    }
+  }
+
+  throw new Error('No bot configurations found');
+}
+
+async function resolveConfig(botOption) {
+  return resolveConfigSync(botOption);
+}
+
+function getBotFromArgs() {
+  const botIdx = process.argv.indexOf('--bot');
+  if (botIdx !== -1 && botIdx + 1 < process.argv.length) {
+    const botId = process.argv[botIdx + 1];
+    // Validate bot ID
+    const bot = BOT_CONFIGS.find(b => b.id === botId);
+    if (!bot) {
+      console.error(`Unknown bot: ${botId}. Valid options: ${BOT_CONFIGS.map(b => b.id).join(', ')}`);
+      process.exit(1);
+    }
+    // Verify config file exists
+    const configPath = getBotConfigPath(botId);
+    if (!fs.existsSync(configPath)) {
+      console.error(`${bot.name} config not found at ${configPath}`);
+      process.exit(1);
+    }
+    // Save to bot.json
+    fs.ensureDirSync(CLAWD_MODELS_DIR);
+    fs.writeFileSync(CLAWD_MODELS_BOT_FILE, JSON.stringify({ bot: botId }, null, 2));
+    console.log(`Default bot set to: ${botId}`);
+    return botId;
+  }
+  return null;
+}
+
 program
   .name('clawd-models')
   .description('CLI tool to manage OpenClaw model configurations')
-  .version('1.0.2')
-  .showHelpAfterError();
+  .version('1.0.4')
+  .showHelpAfterError()
+  .option('--bot <bot-id>', 'Target bot: openclaw, clawdbot, moltbot (also sets as default)')
+  .option('--clear-bot', 'Clear the default bot setting');
+
+// Handle --clear-bot before normal command parsing
+const clearBotIdx = process.argv.indexOf('--clear-bot');
+if (clearBotIdx !== -1) {
+  clearPreferredBot();
+  console.log('Default bot cleared.');
+  process.exit(0);
+}
 
 // ============ Core Commands ============
 
@@ -84,25 +280,29 @@ program
 program
   .command('view')
   .description('View current configuration')
-  .action(() => {
-    const config = loadConfig();
+  .action((cmdOptions) => {
+    const botOption = getBotFromArgs();
+    const { bot, configPath } = resolveConfigSync(botOption);
+    const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
     console.log(JSON.stringify(config, null, 2));
-    console.log(`\n${OPENCLAW_CONFIG_PATH}`);
+    console.log(`\n${bot.name}: ${configPath}`);
   });
 
 program
   .command('edit')
   .description('Edit configuration in default editor')
   .action(() => {
-    const config = loadConfig();
+    const botOption = getBotFromArgs();
+    const { bot, configPath } = resolveConfigSync(botOption);
+    const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
     config.meta.lastTouchedVersion = CURRENT_VERSION;
     config.meta.lastTouchedAt = new Date().toISOString();
-    saveConfig(config);
+    fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
 
     const editor = process.env.EDITOR || 'vi';
-    require('child_process').execSync(`${editor} "${OPENCLAW_CONFIG_PATH}"`, { stdio: 'inherit' });
+    require('child_process').execSync(`${editor} "${configPath}"`, { stdio: 'inherit' });
 
-    console.log(`Configuration updated at ${OPENCLAW_CONFIG_PATH}`);
+    console.log(`Configuration updated at ${bot.name}: ${configPath}`);
   });
 
 // ============ Provider Commands ============
@@ -116,7 +316,9 @@ program
   .option('--api <api-type>', 'API type (e.g., openai-completions, anthropic-messages)', 'openai-completions')
   .option('--auth <auth-type>', 'Auth method (e.g., api-key, bearer)', 'api-key')
   .action((options) => {
-    const config = loadConfig();
+    const botOption = getBotFromArgs();
+    const { bot, configPath } = resolveConfigSync(botOption);
+    const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
     config.models.providers = config.models.providers || {};
 
     const provider = {
@@ -133,8 +335,8 @@ program
     config.models.providers[options.name] = provider;
 
     config.meta.lastTouchedAt = new Date().toISOString();
-    saveConfig(config);
-    console.log(`Provider "${options.name}" added. Use "clawd-models models:add" to add models.`);
+    fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+    console.log(`Provider "${options.name}" added to ${bot.name}.`);
   });
 
 program
@@ -142,12 +344,14 @@ program
   .description('Remove a model provider')
   .requiredOption('-n, --name <name>', 'Provider name')
   .action((options) => {
-    const config = loadConfig();
+    const botOption = getBotFromArgs();
+    const { bot, configPath } = resolveConfigSync(botOption);
+    const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
     if (config.models.providers && config.models.providers[options.name]) {
       delete config.models.providers[options.name];
       config.meta.lastTouchedAt = new Date().toISOString();
-      saveConfig(config);
-      console.log(`Provider "${options.name}" removed.`);
+      fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+      console.log(`Provider "${options.name}" removed from ${bot.name}.`);
     } else {
       console.log(`Provider "${options.name}" not found.`);
     }
@@ -156,8 +360,10 @@ program
 program
   .command('providers:list')
   .description('List all configured providers')
-  .action(() => {
-    const config = loadConfig();
+  .action((options) => {
+    const botOption = getBotFromArgs();
+    const { configPath } = resolveConfigSync(botOption);
+    const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
     const providers = config.models?.providers || {};
 
     if (Object.keys(providers).length === 0) {
@@ -193,7 +399,9 @@ program
   .option('--context <tokens>', 'Context window size', '200000')
   .option('--max-tokens <tokens>', 'Max output tokens', '8192')
   .action((options) => {
-    const config = loadConfig();
+    const botOption = getBotFromArgs();
+    const { bot, configPath } = resolveConfigSync(botOption);
+    const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
 
     if (!config.models.providers || !config.models.providers[options.provider]) {
       console.log(`Provider "${options.provider}" not found. Add it first with "clawd-models providers:add".`);
@@ -227,8 +435,8 @@ program
 
     provider.models.push(model);
     config.meta.lastTouchedAt = new Date().toISOString();
-    saveConfig(config);
-    console.log(`Model "${options.id}" added to provider "${options.provider}".`);
+    fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+    console.log(`Model "${options.id}" added to provider "${options.provider}" in ${bot.name}.`);
   });
 
 program
@@ -237,7 +445,9 @@ program
   .requiredOption('-p, --provider <provider>', 'Provider name')
   .requiredOption('-i, --id <id>', 'Model ID')
   .action((options) => {
-    const config = loadConfig();
+    const botOption = getBotFromArgs();
+    const { bot, configPath } = resolveConfigSync(botOption);
+    const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
 
     if (!config.models.providers || !config.models.providers[options.provider]) {
       console.log(`Provider "${options.provider}" not found.`);
@@ -254,8 +464,8 @@ program
 
     provider.models.splice(idx, 1);
     config.meta.lastTouchedAt = new Date().toISOString();
-    saveConfig(config);
-    console.log(`Model "${options.id}" removed from provider "${options.provider}".`);
+    fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+    console.log(`Model "${options.id}" removed from provider "${options.provider}" in ${bot.name}.`);
   });
 
 program
@@ -263,7 +473,9 @@ program
   .description('List all configured models')
   .option('--provider <provider>', 'Filter by provider')
   .action((options) => {
-    const config = loadConfig();
+    const botOption = getBotFromArgs();
+    const { configPath } = resolveConfigSync(botOption);
+    const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
     const providers = config.models?.providers || {};
 
     if (options.provider) {
@@ -288,6 +500,146 @@ program
     }
   });
 
+program
+  .command('models:test')
+  .description('Test the default model configuration by sending a test message')
+  .action(async () => {
+    const botOption = getBotFromArgs();
+    const { bot, configPath } = await resolveConfig(botOption);
+    console.log(`\nUsing ${bot.name} configuration`);
+
+    let config;
+    try {
+      config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+    } catch (error) {
+      console.error(`Error loading configuration: ${error.message}`);
+      return;
+    }
+
+    const defaultModel = config.agents?.defaults?.model?.primary;
+
+    if (!defaultModel) {
+      console.log('No default model configured. Use "clawd-models agents:set-default" to set one.');
+      return;
+    }
+
+    // Parse provider/model from default model
+    const [providerName, ...modelPath] = defaultModel.split('/');
+    const modelId = modelPath.join('/');
+
+    const provider = config.models?.providers?.[providerName];
+    if (!provider) {
+      console.log(`Provider "${providerName}" not found in configuration.`);
+      return;
+    }
+
+    console.log(`Testing model: ${defaultModel}`);
+    console.log(`Provider: ${providerName}`);
+    console.log(`Base URL: ${provider.baseUrl}`);
+    console.log(`API: ${provider.api}`);
+
+    const apiKey = provider.apiKey;
+    if (!apiKey) {
+      console.log('\nWarning: No API key configured for this provider.');
+    }
+
+    // Build the endpoint URL based on API type
+    let endpoint;
+    if (provider.api === 'openai-completions') {
+      endpoint = `${provider.baseUrl.replace(/\/$/, '')}/chat/completions`;
+    } else if (provider.api === 'anthropic-messages') {
+      endpoint = `${provider.baseUrl.replace(/\/$/, '')}/v1/messages`;
+    } else {
+      console.log(`Unsupported API type: ${provider.api}`);
+      return;
+    }
+
+    console.log(`\nEndpoint: ${endpoint}`);
+
+    // Prepare the request body
+    let body;
+    let headers = {};
+
+    if (apiKey) {
+      if (provider.auth === 'bearer') {
+        headers['Authorization'] = `Bearer ${apiKey}`;
+      } else {
+        headers['Authorization'] = `Bearer ${apiKey}`;
+        headers['X-API-Key'] = apiKey;
+      }
+    }
+
+    if (provider.api === 'openai-completions') {
+      body = JSON.stringify({
+        model: modelId,
+        messages: [{ role: 'user', content: 'hi, there' }],
+        max_tokens: 10
+      });
+      headers['Content-Type'] = 'application/json';
+    } else if (provider.api === 'anthropic-messages') {
+      body = JSON.stringify({
+        model: modelId,
+        messages: [{ role: 'user', content: 'hi, there' }],
+        max_tokens: 10
+      });
+      headers['Content-Type'] = 'application/json';
+      headers['anthropic-version'] = '2023-06-01';
+    }
+
+    console.log('\n--- Request Headers ---');
+    for (const [key, value] of Object.entries(headers)) {
+      // Mask API key for display - hide last 32 chars
+      const displayValue = key.toLowerCase().includes('api') || key.toLowerCase().includes('authorization')
+        ? value.length > 32 ? value.slice(0, -32) + '********************************' : '********************************'
+        : value;
+      console.log(`${key}: ${displayValue}`);
+    }
+
+    try {
+      const response = await fetch(endpoint, {
+        method: 'POST',
+        headers,
+        body
+      });
+
+      const status = response.status;
+      const contentType = response.headers.get('content-type');
+
+      console.log('\n--- Response Headers ---');
+      for (const [key, value] of response.headers.entries()) {
+        console.log(`${key}: ${value}`);
+      }
+
+      let responseBody;
+
+      if (contentType && contentType.includes('application/json')) {
+        responseBody = await response.json();
+      } else {
+        responseBody = await response.text();
+      }
+
+      console.log(`\nStatus: ${status}`);
+      console.log('Response body:');
+      console.log(JSON.stringify(responseBody, null, 2));
+
+      // Provide helpful advice on 404 errors
+      if (status === 404) {
+        console.log('\n--- Troubleshooting ---');
+        if (provider.api === 'openai-completions') {
+          console.log('For OpenAI-compatible APIs, ensure your base URL ends with /v1');
+          console.log('Expected format: <schema>://<hostname>[:port]/v1');
+          console.log('Example: https://api.example.com/v1');
+        } else if (provider.api === 'anthropic-messages') {
+          console.log('For Anthropic Messages APIs, ensure your base URL ends with /v1');
+          console.log('Expected format: <schema>://<hostname>[:port]/v1');
+          console.log('Example: https://api.anthropic.com/v1');
+        }
+      }
+    } catch (error) {
+      console.error(`\nRequest failed: ${error.message}`);
+    }
+  });
+
 // ============ Agent Commands ============
 
 program
@@ -299,7 +651,9 @@ program
   .option('--workspace <path>', 'Workspace directory')
   .option('--agent-dir <path>', 'Agent directory')
   .action((options) => {
-    const config = loadConfig();
+    const botOption = getBotFromArgs();
+    const { bot, configPath } = resolveConfigSync(botOption);
+    const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
     config.agents = config.agents || { defaults: {}, list: [] };
 
     const existing = config.agents.list.find(a => a.id === options.id);
@@ -316,8 +670,8 @@ program
 
     config.agents.list.push(agent);
     config.meta.lastTouchedAt = new Date().toISOString();
-    saveConfig(config);
-    console.log(`Agent "${options.id}" added.`);
+    fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+    console.log(`Agent "${options.id}" added to ${bot.name}.`);
   });
 
 program
@@ -325,7 +679,9 @@ program
   .description('Remove an agent')
   .requiredOption('-i, --id <id>', 'Agent ID')
   .action((options) => {
-    const config = loadConfig();
+    const botOption = getBotFromArgs();
+    const { configPath } = resolveConfigSync(botOption);
+    const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
     if (!config.agents?.list) {
       console.log('No agents configured.');
       return;
@@ -339,15 +695,17 @@ program
 
     config.agents.list.splice(idx, 1);
     config.meta.lastTouchedAt = new Date().toISOString();
-    saveConfig(config);
+    fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
     console.log(`Agent "${options.id}" removed.`);
   });
 
 program
   .command('agents:list')
   .description('List all configured agents')
-  .action(() => {
-    const config = loadConfig();
+  .action((options) => {
+    const botOption = getBotFromArgs();
+    const { configPath } = resolveConfigSync(botOption);
+    const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
     const agents = config.agents?.list || [];
     const defaults = config.agents?.defaults || {};
 
@@ -385,15 +743,17 @@ program
   .requiredOption('-a, --agent <agent>', 'Agent type (e.g., main, code)')
   .requiredOption('-m, --model <model>', 'Model ID')
   .action((options) => {
-    const config = loadConfig();
+    const botOption = getBotFromArgs();
+    const { bot, configPath } = resolveConfigSync(botOption);
+    const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
     config.agents = config.agents || { defaults: {}, list: [] };
     config.agents.defaults = config.agents.defaults || {};
     config.agents.defaults.model = config.agents.defaults.model || {};
     config.agents.defaults.model.primary = options.model;
 
     config.meta.lastTouchedAt = new Date().toISOString();
-    saveConfig(config);
-    console.log(`Default model for agent "${options.agent}" set to "${options.model}".`);
+    fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+    console.log(`Default model for agent "${options.agent}" set to "${options.model}" in ${bot.name}.`);
   });
 
 // ============ Gateway Commands ============
@@ -401,8 +761,10 @@ program
 program
   .command('gateway:view')
   .description('View gateway configuration')
-  .action(() => {
-    const config = loadConfig();
+  .action((options) => {
+    const botOption = getBotFromArgs();
+    const { configPath } = resolveConfigSync(botOption);
+    const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
     const gw = config.gateway || {};
     console.log(`Port: ${gw.port || 18789}`);
     console.log(`Mode: ${gw.mode || 'local'}`);
@@ -416,13 +778,15 @@ program
 program
   .command('gateway:refresh-token')
   .description('Refresh gateway auth token')
-  .action(() => {
-    const config = loadConfig();
+  .action((options) => {
+    const botOption = getBotFromArgs();
+    const { bot, configPath } = resolveConfigSync(botOption);
+    const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
     config.gateway = config.gateway || {};
     config.gateway.auth = config.gateway.auth || { mode: 'token' };
     config.gateway.auth.token = generateToken();
     config.meta.lastTouchedAt = new Date().toISOString();
-    saveConfig(config);
+    fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
     console.log('Gateway auth token refreshed.');
   });
 
@@ -431,8 +795,10 @@ program
 program
   .command('auth:profiles')
   .description('List all auth profiles (configured and supported)')
-  .action(() => {
-    const config = loadConfig();
+  .action((options) => {
+    const botOption = getBotFromArgs();
+    const { configPath } = resolveConfigSync(botOption);
+    const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
     const providers = config.models?.providers || {};
     const profiles = config.auth?.profiles || {};
 
@@ -467,7 +833,9 @@ program
   .requiredOption('-p, --provider <provider>', 'Auth provider')
   .requiredOption('-m, --mode <mode>', 'Auth mode (api_key, bearer)')
   .action((options) => {
-    const config = loadConfig();
+    const botOption = getBotFromArgs();
+    const { bot, configPath } = resolveConfigSync(botOption);
+    const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
     config.auth = config.auth || { profiles: {} };
 
     config.auth.profiles[options.name] = {
@@ -476,8 +844,8 @@ program
     };
 
     config.meta.lastTouchedAt = new Date().toISOString();
-    saveConfig(config);
-    console.log(`Auth profile "${options.name}" added.`);
+    fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+    console.log(`Auth profile "${options.name}" added to ${bot.name}.`);
   });
 
 // ============ Import/Export ============
@@ -487,6 +855,8 @@ program
   .description('Import configuration from a JSON file')
   .requiredOption('-f, --file <file>', 'Path to JSON file')
   .action((options) => {
+    const botOption = getBotFromArgs();
+    const { bot, configPath } = resolveConfigSync(botOption);
     if (!fs.existsSync(options.file)) {
       console.error(`File not found: ${options.file}`);
       return;
@@ -500,44 +870,22 @@ program
       lastTouchedAt: new Date().toISOString()
     };
 
-    saveConfig(config);
-    console.log(`Configuration imported from ${options.file}`);
+    fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+    console.log(`Configuration imported from ${options.file} to ${bot.name}.`);
   });
 
 program
   .command('export')
   .description('Export configuration to stdout')
-  .action(() => {
-    const config = loadConfig();
+  .action((options) => {
+    const botOption = getBotFromArgs();
+    const { configPath } = resolveConfigSync(botOption);
+    const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
     console.log(JSON.stringify(config, null, 2));
   });
 
 // ============ Helpers ============
 
-function loadConfig() {
-  try {
-    if (fs.existsSync(OPENCLAW_CONFIG_PATH)) {
-      const content = fs.readFileSync(OPENCLAW_CONFIG_PATH, 'utf8');
-      return JSON.parse(content);
-    }
-    return {};
-  } catch (error) {
-    console.error(`Error loading configuration: ${error.message}`);
-    return {};
-  }
-}
-
-function saveConfig(config) {
-  try {
-    const dir = path.dirname(OPENCLAW_CONFIG_PATH);
-    fs.ensureDirSync(dir);
-    fs.writeFileSync(OPENCLAW_CONFIG_PATH, JSON.stringify(config, null, 2));
-  } catch (error) {
-    console.error(`Error saving configuration: ${error.message}`);
-    process.exit(1);
-  }
-}
-
 function generateToken() {
   const chars = 'abcdef0123456789';
   let token = '';

package/docs/setup-flow.svg

@@ -0,0 +1,86 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 800 380">
+  <defs>
+    <marker id="arrowhead" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto">
+      <polygon points="0 0, 10 3.5, 0 7" fill="#333"/>
+    </marker>
+    <filter id="shadow" x="-20%" y="-20%" width="140%" height="140%">
+      <feDropShadow dx="2" dy="2" stdDeviation="3" flood-opacity="0.2"/>
+    </filter>
+  </defs>
+
+  <!-- Background -->
+  <rect width="800" height="380" fill="#fafafa"/>
+
+  <!-- Title -->
+  <text x="400" y="30" text-anchor="middle" font-size="20" font-weight="bold" fill="#333">Setup Models for OpenClaw with clawd-models</text>
+
+  <!-- Step 1: Install OpenClaw -->
+  <rect x="20" y="55" width="150" height="90" rx="8" fill="#e3f2fd" stroke="#1976d2" stroke-width="2" filter="url(#shadow)"/>
+  <text x="95" y="80" text-anchor="middle" font-size="13" font-weight="bold" fill="#1976d2">1. Install &amp;</text>
+  <text x="95" y="98" text-anchor="middle" font-size="13" font-weight="bold" fill="#1976d2">Init OpenClaw</text>
+  <text x="95" y="118" text-anchor="middle" font-size="9" fill="#555">npm i -g openclaw@latest</text>
+  <text x="95" y="128" text-anchor="middle" font-size="9" fill="#555">openclaw setup</text>
+
+  <!-- Arrow 1 -->
+  <path d="M175 90 L210 90" stroke="#333" stroke-width="2" marker-end="url(#arrowhead)"/>
+
+  <!-- Step 2: Install clawd-models -->
+  <rect x="220" y="55" width="150" height="70" rx="8" fill="#e8f5e9" stroke="#388e3c" stroke-width="2" filter="url(#shadow)"/>
+  <text x="295" y="80" text-anchor="middle" font-size="13" font-weight="bold" fill="#388e3c">2. Install</text>
+  <text x="295" y="98" text-anchor="middle" font-size="13" font-weight="bold" fill="#388e3c">clawd-models</text>
+  <text x="295" y="118" text-anchor="middle" font-size="9" fill="#555">npm i -g clawd-models</text>
+
+  <!-- Arrow 2 -->
+  <path d="M375 90 L410 90" stroke="#333" stroke-width="2" marker-end="url(#arrowhead)"/>
+
+  <!-- Step 3: Add Providers -->
+  <rect x="420" y="55" width="150" height="70" rx="8" fill="#fff3e0" stroke="#f57c00" stroke-width="2" filter="url(#shadow)"/>
+  <text x="495" y="80" text-anchor="middle" font-size="13" font-weight="bold" fill="#f57c00">3. Add Providers</text>
+  <text x="495" y="100" text-anchor="middle" font-size="10" fill="#555">providers:add</text>
+  <text x="495" y="115" text-anchor="middle" font-size="9" fill="#555">-n &lt;name&gt; -u &lt;url&gt;</text>
+
+  <!-- Arrow 3 -->
+  <path d="M575 90 L610 90" stroke="#333" stroke-width="2" marker-end="url(#arrowhead)"/>
+
+  <!-- Step 4: Add Models -->
+  <rect x="620" y="55" width="150" height="70" rx="8" fill="#fff3e0" stroke="#f57c00" stroke-width="2" filter="url(#shadow)"/>
+  <text x="695" y="80" text-anchor="middle" font-size="13" font-weight="bold" fill="#f57c00">4. Add Models</text>
+  <text x="695" y="100" text-anchor="middle" font-size="10" fill="#555">models:add</text>
+  <text x="695" y="115" text-anchor="middle" font-size="9" fill="#555">-p &lt;provider&gt; -i &lt;model-id&gt;</text>
+
+  <!-- Row 2: Test & loop -->
+  <rect x="100" y="180" width="160" height="60" rx="8" fill="#e8f5e9" stroke="#388e3c" stroke-width="2" filter="url(#shadow)"/>
+  <text x="180" y="205" text-anchor="middle" font-size="13" font-weight="bold" fill="#388e3c">5. Test Models</text>
+  <text x="180" y="225" text-anchor="middle" font-size="9" fill="#555">models:test [--bot &lt;name&gt;]</text>
+
+  <!-- Arrow from Add Models to Test -->
+  <path d="M695 125 L695 160 L210 160 L210 180" stroke="#333" stroke-width="1.5" fill="none" marker-end="url(#arrowhead)"/>
+
+  <!-- Alternative: Direct OpenClaw Commands -->
+  <rect x="550" y="180" width="220" height="90" rx="8" fill="#fafafa" stroke="#999" stroke-width="1" stroke-dasharray="5,5"/>
+  <text x="660" y="200" text-anchor="middle" font-size="11" font-weight="bold" fill="#333">Native Commands</text>
+  <text x="660" y="212" text-anchor="middle" font-size="9" fill="#555">openclaw models list</text>
+  <text x="660" y="224" text-anchor="middle" font-size="9" fill="#555">openclaw models set &lt;model-id&gt;</text>
+  <text x="660" y="236" text-anchor="middle" font-size="9" fill="#555">openclaw agent --agent main -m "hi, there"</text>
+
+  <!-- Legend -->
+  <rect x="20" y="280" width="100" height="80" rx="6" fill="#fff" stroke="#ccc" stroke-width="1"/>
+  <text x="70" y="298" text-anchor="middle" font-size="10" font-weight="bold" fill="#333">Legend</text>
+  <circle cx="35" cy="320" r="5" fill="#1976d2"/>
+  <text x="48" y="324" font-size="9" fill="#555" text-anchor="start">OpenClaw</text>
+  <circle cx="35" cy="338" r="5" fill="#f57c00"/>
+  <text x="48" y="342" font-size="9" fill="#555" text-anchor="start">Config</text>
+  <circle cx="35" cy="354" r="5" fill="#388e3c"/>
+  <text x="48" y="358" font-size="9" fill="#555" text-anchor="start">Test</text>
+
+  <!-- Default Bot Priority -->
+  <rect x="350" y="190" width="140" height="50" rx="6" fill="#f5f5f5" stroke="#ddd" stroke-width="1"/>
+  <text x="420" y="210" text-anchor="middle" font-size="10" font-weight="bold" fill="#333">Default Bot</text>
+  <text x="420" y="228" text-anchor="middle" font-size="9" fill="#555">openclaw → clawdbot → moltbot</text>
+
+  <!-- Dashed line from Step 5 to Default Bot -->
+  <path d="M260 210 L350 210" stroke="#777" stroke-width="1" stroke-dasharray="4,4" fill="none"/>
+
+  <!-- Dashed line from Default Bot to Step 3 -->
+  <path d="M440 190 L440 150 L495 150 L495 125" stroke="#777" stroke-width="1" stroke-dasharray="4,4" fill="none" marker-end="url(#arrowhead)"/>
+</svg>

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "clawd-models",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "CLI tool to manage OpenClaw model configurations",
   "main": "bin/clawd-models.js",
   "bin": {
-    "clawd-models": "./bin/clawd-models.js"
+    "clawd-models": "bin/clawd-models.js"
   },
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1"