oc-inspector 1.4.0 → 1.5.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kirill Shidenko
+
+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/README.md

@@ -1,5 +1,7 @@
 # oc-inspector
 
+[![npm](https://img.shields.io/npm/v/oc-inspector)](https://www.npmjs.com/package/oc-inspector) [![license](https://img.shields.io/github/license/kshidenko/openclaw-inspector)](LICENSE) [![AI Agents](https://img.shields.io/badge/AI_Agents-AGENTS.md-blue)](AGENTS.md)
+
 A debugging and monitoring tool for [OpenClaw](https://openclaw.ai) that helps you understand **where your tokens and money are going**.
 
 When working with LLM agents you often have no visibility into what's actually happening under the hood — how many tokens each request burns, which models cost the most, what system prompts look like, how tool calls are structured. `oc-inspector` sits between OpenClaw and your LLM providers as a transparent proxy, capturing every request and response in real time so you can see the full picture: token usage, costs, message flow, thinking blocks, tool calls — everything in a clear, human-readable format.
@@ -31,7 +33,7 @@ Use it to:
 npx oc-inspector
 ```
 
-Starts the inspector daemon in background on `localhost:18800` with a live web dashboard.
+Starts the inspector daemon in background on `localhost:3000` with a live web dashboard.
 
 ---
 
@@ -110,6 +112,24 @@ oc-inspector stop
 oc-inspector restart
 ```
 
+### Autostart (run on login/boot)
+
+```bash
+# Install autostart service (launchd on macOS, systemd on Linux)
+oc-inspector install
+
+# Install with custom port
+oc-inspector install --port 9000
+
+# Remove autostart
+oc-inspector uninstall
+
+# Check autostart status
+oc-inspector status
+```
+
+The inspector will start automatically when you log in (macOS) or boot (Linux), and restart if it crashes.
+
 ### CLI Commands
 
 | Command | Description |
@@ -127,6 +147,8 @@ oc-inspector restart
 | `providers` | List detected providers and their upstream URLs |
 | `config` | Show `.inspector.json` path and contents |
 | `logs` | Show daemon log output |
+| `install` | Install autostart — run inspector on login/boot |
+| `uninstall` | Remove autostart service |
 
 ### Examples
 
@@ -157,7 +179,7 @@ oc-inspector logs --lines 100
 
 | Flag | Description | Default |
 |------|-------------|---------|
-| `--port <number>` | Port for the inspector proxy | `18800` |
+| `--port <number>` | Port for the inspector proxy | `3000` |
 | `--open` | Auto-open the dashboard in a browser | `false` |
 | `--config <path>` | Custom path to `openclaw.json` | `~/.openclaw/openclaw.json` |
 | `--json` | Output as JSON (for `stats`, `status`, `providers`, `history`, `pricing`) | `false` |
@@ -169,10 +191,10 @@ oc-inspector logs --lines 100
 
 ## How It Works
 
-1. **Start** — `oc-inspector` launches a background daemon with an HTTP reverse proxy on `localhost:18800`. The terminal is free immediately.
+1. **Start** — `oc-inspector` launches a background daemon with an HTTP reverse proxy on `localhost:3000`. The terminal is free immediately.
 2. **Enable** — Click **Enable** in the web UI (or run `oc-inspector enable`). This:
    - Backs up `openclaw.json`
-   - Rewrites each provider's `baseUrl` to route through `http://127.0.0.1:18800/{provider}/...`
+   - Rewrites each provider's `baseUrl` to route through `http://127.0.0.1:3000/{provider}/...`
    - Restarts the OpenClaw gateway
 3. **Intercept** — All LLM API traffic flows through the inspector:
    - Requests/responses are logged in real time

package/bin/cli.mjs

@@ -21,7 +21,7 @@
  *   logs              Tail daemon log file
  *
  * Options:
- *   --port <number>   Port for the inspector proxy (default: 18800)
+ *   --port <number>   Port for the inspector proxy (default: 3000)
  *   --open            Auto-open the dashboard in a browser
  *   --config <path>   Custom path to openclaw.json
  *   --json            Output as JSON (for stats/status)
@@ -66,7 +66,7 @@ const LOG_FILE = join(INSPECTOR_DIR, "inspector.log");
 function parseArgs(argv) {
   const opts = {
     command: "start",
-    port: 18800,
+    port: 3000,
     open: false,
     config: undefined,
     json: false,
@@ -80,6 +80,7 @@ function parseArgs(argv) {
     "enable", "disable", "status",
     "stats", "providers", "history", "pricing", "config",
     "logs", "help", "_serve",
+    "install", "uninstall",
   ]);
   for (let i = 0; i < argv.length; i++) {
     const arg = argv[i];
@@ -124,9 +125,11 @@ if (opts.help) {
     pricing           Show model pricing table
     config            Show .inspector.json path and status
     logs              Show daemon log output
+    install           Install autostart (run on login/boot)
+    uninstall         Remove autostart service
 
   \x1b[1mOptions:\x1b[0m
-    --port <number>   Port for the inspector proxy (default: 18800)
+    --port <number>   Port for the inspector proxy (default: 3000)
     --open            Auto-open the dashboard in a browser
     --config <path>   Custom path to openclaw.json
     --json            Output as JSON (for stats, status, providers, history)
@@ -148,6 +151,8 @@ if (opts.help) {
     npx oc-inspector history --days 30 # Last 30 days
     npx oc-inspector pricing           # Show pricing table
     npx oc-inspector logs              # Show daemon logs
+    npx oc-inspector install           # Autostart on login/boot
+    npx oc-inspector uninstall         # Remove autostart
 `);
   process.exit(0);
 }
@@ -202,6 +207,12 @@ if (opts.command === "logs") {
   process.exit(0);
 }
 
+// install / uninstall: autostart management
+if (opts.command === "install" || opts.command === "uninstall") {
+  await runAutostart(opts);
+  process.exit(0);
+}
+
 // Remote commands: talk to a running inspector
 const remoteCommands = new Set(["stats", "providers", "history", "pricing", "config"]);
 if (remoteCommands.has(opts.command)) {
@@ -523,6 +534,49 @@ async function restoreConfigOnExit(cmdOpts = {}) {
   }
 }
 
+// ═══════════════════════════════════════════════════════════════
+// Autostart (install / uninstall)
+// ═══════════════════════════════════════════════════════════════
+
+/**
+ * Handle `install` and `uninstall` commands for system autostart.
+ *
+ * Uses launchd on macOS, systemd on Linux.
+ *
+ * @param {object} opts - Parsed CLI options.
+ */
+async function runAutostart(opts) {
+  const { install, uninstall, autostartStatus } = await import("../src/autostart.mjs");
+
+  console.log("");
+
+  if (opts.command === "install") {
+    const result = install({ port: opts.port, config: opts.config });
+    if (result.ok) {
+      console.log(`  \x1b[32m✓\x1b[0m ${result.message}`);
+      console.log(`  \x1b[90m  Service file: ${result.path}\x1b[0m`);
+      console.log("");
+      console.log("  Inspector will now start automatically on login.");
+      console.log("  Use \x1b[36moc-inspector uninstall\x1b[0m to remove.");
+    } else {
+      console.log(`  \x1b[31m✗\x1b[0m ${result.message}`);
+    }
+    console.log("");
+    return;
+  }
+
+  if (opts.command === "uninstall") {
+    const result = uninstall();
+    if (result.ok) {
+      console.log(`  \x1b[32m✓\x1b[0m ${result.message}`);
+    } else {
+      console.log(`  \x1b[31m✗\x1b[0m ${result.message}`);
+    }
+    console.log("");
+    return;
+  }
+}
+
 // ═══════════════════════════════════════════════════════════════
 // Local commands (enable / disable / status)
 // ═══════════════════════════════════════════════════════════════
@@ -557,6 +611,17 @@ async function runLocalCommand(opts) {
         console.log(`    Providers: ${st.providers.join(", ")}`);
       }
 
+      // Autostart status
+      try {
+        const { autostartStatus } = await import("../src/autostart.mjs");
+        const as = autostartStatus();
+        const asDot = as.installed ? "\x1b[32m●\x1b[0m" : "\x1b[90m●\x1b[0m";
+        const asLabel = as.installed
+          ? (as.running ? `\x1b[32minstalled & running\x1b[0m (${as.platform})` : `\x1b[33minstalled, not running\x1b[0m (${as.platform})`)
+          : `\x1b[90mnot installed\x1b[0m  \x1b[90m(use: oc-inspector install)\x1b[0m`;
+        console.log(`  ${asDot} Autostart:    ${asLabel}`);
+      } catch { /* autostart module not available */ }
+
       if (daemon.alive) {
         console.log(`\n  \x1b[90mDashboard: http://127.0.0.1:${st.port || opts.port}\x1b[0m`);
       }
@@ -673,6 +738,8 @@ function printCommandsHelp() {
   console.log(`    ${C}oc-inspector providers${R}     Active providers list`);
   console.log(`    ${C}oc-inspector config${R}        Inspector config info`);
   console.log(`    ${C}oc-inspector logs${R}          Daemon log output`);
+  console.log(`    ${C}oc-inspector install${R}       Autostart on login/boot`);
+  console.log(`    ${C}oc-inspector uninstall${R}     Remove autostart`);
   console.log(`    ${C}oc-inspector help${R}          Show this help`);
   console.log("");
   console.log(`  ${D}Use --json for machine-readable output. See oc-inspector --help for all options.${R}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oc-inspector",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "description": "Real-time API traffic inspector for OpenClaw — intercepts LLM provider requests, shows token usage, costs, and message flow in a live web dashboard.",
   "type": "module",
   "bin": {

package/src/autostart.mjs

@@ -0,0 +1,379 @@
+/**
+ * Autostart management for OpenClaw Inspector.
+ *
+ * Installs/uninstalls a system service so the inspector starts
+ * automatically on login (macOS) or boot (Linux).
+ *
+ * Supported platforms:
+ *   - macOS: launchd (~/Library/LaunchAgents/)
+ *   - Linux: systemd user unit (~/.config/systemd/user/)
+ *
+ * @module autostart
+ */
+
+import { writeFileSync, readFileSync, unlinkSync, existsSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+import { homedir, platform } from "node:os";
+import { execSync } from "node:child_process";
+import { fileURLToPath } from "node:url";
+
+/** launchd plist label / systemd unit name. */
+const SERVICE_ID = "com.openclaw.inspector";
+
+/** systemd unit file name. */
+const SYSTEMD_UNIT = "oc-inspector.service";
+
+/**
+ * Resolve the absolute path to the CLI entry point (bin/cli.mjs).
+ *
+ * @returns {string} Absolute path to cli.mjs.
+ */
+function cliPath() {
+  const thisFile = fileURLToPath(import.meta.url);
+  return join(thisFile, "..", "..", "bin", "cli.mjs");
+}
+
+/**
+ * Resolve the absolute path to the current Node.js binary.
+ *
+ * @returns {string} Absolute path to `node`.
+ */
+function nodePath() {
+  return process.execPath;
+}
+
+// ════════════════════════════════════════════════════════════════
+// macOS — launchd
+// ════════════════════════════════════════════════════════════════
+
+/**
+ * Path to the launchd plist file.
+ *
+ * @returns {string} ~/Library/LaunchAgents/com.openclaw.inspector.plist
+ */
+function plistPath() {
+  return join(homedir(), "Library", "LaunchAgents", `${SERVICE_ID}.plist`);
+}
+
+/**
+ * Generate a launchd plist XML string.
+ *
+ * The plist tells launchd to run `node bin/cli.mjs _serve --port <port>`
+ * at login, keep it alive (restart on crash), and log stdout/stderr.
+ *
+ * @param {object} opts
+ * @param {number} opts.port - Inspector proxy port.
+ * @param {string} [opts.config] - Custom openclaw.json path.
+ * @returns {string} Plist XML content.
+ */
+function buildPlist({ port, config }) {
+  const args = [nodePath(), cliPath(), "_serve", "--port", String(port)];
+  if (config) args.push("--config", config);
+
+  const logDir = join(homedir(), ".openclaw", ".inspector-runtime");
+  const stdout = join(logDir, "launchd-stdout.log");
+  const stderr = join(logDir, "launchd-stderr.log");
+
+  const argsXml = args.map((a) => `      <string>${escapeXml(a)}</string>`).join("\n");
+
+  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">
+<dict>
+    <key>Label</key>
+    <string>${SERVICE_ID}</string>
+
+    <key>ProgramArguments</key>
+    <array>
+${argsXml}
+    </array>
+
+    <key>RunAtLoad</key>
+    <true/>
+
+    <key>KeepAlive</key>
+    <true/>
+
+    <key>StandardOutPath</key>
+    <string>${escapeXml(stdout)}</string>
+
+    <key>StandardErrorPath</key>
+    <string>${escapeXml(stderr)}</string>
+
+    <key>EnvironmentVariables</key>
+    <dict>
+        <key>PATH</key>
+        <string>/usr/local/bin:/usr/bin:/bin:/opt/homebrew/bin</string>
+    </dict>
+</dict>
+</plist>
+`;
+}
+
+/**
+ * Escape special XML characters.
+ *
+ * @param {string} s - Raw string.
+ * @returns {string} XML-safe string.
+ */
+function escapeXml(s) {
+  return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+}
+
+/**
+ * Install the launchd agent on macOS.
+ *
+ * @param {object} opts
+ * @param {number} opts.port - Inspector port.
+ * @param {string} [opts.config] - Custom openclaw.json path.
+ * @returns {{ ok: boolean, message: string, path: string }}
+ */
+function installLaunchd({ port, config }) {
+  const path = plistPath();
+  const dir = join(homedir(), "Library", "LaunchAgents");
+  mkdirSync(dir, { recursive: true });
+
+  // Ensure log directory exists
+  mkdirSync(join(homedir(), ".openclaw", ".inspector-runtime"), { recursive: true });
+
+  // Unload if already loaded
+  try {
+    execSync(`launchctl unload "${path}" 2>/dev/null`, { stdio: "pipe" });
+  } catch { /* not loaded — fine */ }
+
+  // Write plist
+  const content = buildPlist({ port, config });
+  writeFileSync(path, content, "utf-8");
+
+  // Load the agent
+  try {
+    execSync(`launchctl load "${path}"`, { stdio: "pipe" });
+  } catch (err) {
+    return { ok: false, message: `Plist written but launchctl load failed: ${err.message}`, path };
+  }
+
+  return { ok: true, message: "Autostart installed (launchd)", path };
+}
+
+/**
+ * Uninstall the launchd agent on macOS.
+ *
+ * @returns {{ ok: boolean, message: string }}
+ */
+function uninstallLaunchd() {
+  const path = plistPath();
+  if (!existsSync(path)) {
+    return { ok: true, message: "Autostart was not installed" };
+  }
+
+  // Unload
+  try {
+    execSync(`launchctl unload "${path}" 2>/dev/null`, { stdio: "pipe" });
+  } catch { /* ignore */ }
+
+  // Remove file
+  try {
+    unlinkSync(path);
+  } catch (err) {
+    return { ok: false, message: `Failed to remove plist: ${err.message}` };
+  }
+
+  return { ok: true, message: "Autostart removed (launchd)" };
+}
+
+/**
+ * Check if the launchd agent is installed.
+ *
+ * @returns {{ installed: boolean, running: boolean, path: string }}
+ */
+function statusLaunchd() {
+  const path = plistPath();
+  const installed = existsSync(path);
+  let running = false;
+  if (installed) {
+    try {
+      const out = execSync(`launchctl list ${SERVICE_ID} 2>/dev/null`, { stdio: "pipe" }).toString();
+      running = !out.includes("Could not find");
+    } catch {
+      running = false;
+    }
+  }
+  return { installed, running, path };
+}
+
+// ════════════════════════════════════════════════════════════════
+// Linux — systemd user unit
+// ════════════════════════════════════════════════════════════════
+
+/**
+ * Path to the systemd user unit file.
+ *
+ * @returns {string} ~/.config/systemd/user/oc-inspector.service
+ */
+function unitPath() {
+  return join(homedir(), ".config", "systemd", "user", SYSTEMD_UNIT);
+}
+
+/**
+ * Generate a systemd user unit file content.
+ *
+ * @param {object} opts
+ * @param {number} opts.port - Inspector proxy port.
+ * @param {string} [opts.config] - Custom openclaw.json path.
+ * @returns {string} Unit file content.
+ */
+function buildUnit({ port, config }) {
+  const args = [cliPath(), "_serve", "--port", String(port)];
+  if (config) args.push("--config", config);
+
+  return `[Unit]
+Description=OpenClaw Inspector — LLM API traffic monitor
+After=network.target
+
+[Service]
+Type=simple
+ExecStart=${nodePath()} ${args.join(" ")}
+Restart=on-failure
+RestartSec=5
+Environment=NODE_ENV=production
+
+[Install]
+WantedBy=default.target
+`;
+}
+
+/**
+ * Install the systemd user service on Linux.
+ *
+ * @param {object} opts
+ * @param {number} opts.port - Inspector port.
+ * @param {string} [opts.config] - Custom openclaw.json path.
+ * @returns {{ ok: boolean, message: string, path: string }}
+ */
+function installSystemd({ port, config }) {
+  const path = unitPath();
+  const dir = join(homedir(), ".config", "systemd", "user");
+  mkdirSync(dir, { recursive: true });
+
+  // Write unit
+  const content = buildUnit({ port, config });
+  writeFileSync(path, content, "utf-8");
+
+  // Reload and enable
+  try {
+    execSync("systemctl --user daemon-reload", { stdio: "pipe" });
+    execSync(`systemctl --user enable ${SYSTEMD_UNIT}`, { stdio: "pipe" });
+    execSync(`systemctl --user restart ${SYSTEMD_UNIT}`, { stdio: "pipe" });
+  } catch (err) {
+    return { ok: false, message: `Unit written but systemctl failed: ${err.message}`, path };
+  }
+
+  return { ok: true, message: "Autostart installed (systemd)", path };
+}
+
+/**
+ * Uninstall the systemd user service on Linux.
+ *
+ * @returns {{ ok: boolean, message: string }}
+ */
+function uninstallSystemd() {
+  const path = unitPath();
+  if (!existsSync(path)) {
+    return { ok: true, message: "Autostart was not installed" };
+  }
+
+  try {
+    execSync(`systemctl --user stop ${SYSTEMD_UNIT} 2>/dev/null`, { stdio: "pipe" });
+    execSync(`systemctl --user disable ${SYSTEMD_UNIT} 2>/dev/null`, { stdio: "pipe" });
+  } catch { /* ignore */ }
+
+  try {
+    unlinkSync(path);
+    execSync("systemctl --user daemon-reload", { stdio: "pipe" });
+  } catch (err) {
+    return { ok: false, message: `Failed to remove unit: ${err.message}` };
+  }
+
+  return { ok: true, message: "Autostart removed (systemd)" };
+}
+
+/**
+ * Check if the systemd user service is installed.
+ *
+ * @returns {{ installed: boolean, running: boolean, path: string }}
+ */
+function statusSystemd() {
+  const path = unitPath();
+  const installed = existsSync(path);
+  let running = false;
+  if (installed) {
+    try {
+      const out = execSync(`systemctl --user is-active ${SYSTEMD_UNIT} 2>/dev/null`, { stdio: "pipe" }).toString().trim();
+      running = out === "active";
+    } catch {
+      running = false;
+    }
+  }
+  return { installed, running, path };
+}
+
+// ════════════════════════════════════════════════════════════════
+// Public API — platform-agnostic
+// ════════════════════════════════════════════════════════════════
+
+/**
+ * Install autostart service for the current platform.
+ *
+ * @param {object} opts
+ * @param {number} opts.port - Inspector proxy port (default: 3000).
+ * @param {string} [opts.config] - Custom openclaw.json path.
+ * @returns {{ ok: boolean, message: string, path?: string }}
+ *
+ * @throws {Error} If the platform is not supported.
+ *
+ * Example:
+ *   >>> import { install } from './autostart.mjs';
+ *   >>> const result = install({ port: 3000 });
+ *   >>> console.log(result.message);
+ */
+export function install({ port = 3000, config } = {}) {
+  const os = platform();
+  if (os === "darwin") return installLaunchd({ port, config });
+  if (os === "linux") return installSystemd({ port, config });
+  return { ok: false, message: `Unsupported platform: ${os}. Only macOS and Linux are supported.` };
+}
+
+/**
+ * Uninstall autostart service for the current platform.
+ *
+ * @returns {{ ok: boolean, message: string }}
+ *
+ * Example:
+ *   >>> import { uninstall } from './autostart.mjs';
+ *   >>> const result = uninstall();
+ *   >>> console.log(result.message);
+ */
+export function uninstall() {
+  const os = platform();
+  if (os === "darwin") return uninstallLaunchd();
+  if (os === "linux") return uninstallSystemd();
+  return { ok: false, message: `Unsupported platform: ${os}. Only macOS and Linux are supported.` };
+}
+
+/**
+ * Check autostart status for the current platform.
+ *
+ * @returns {{ installed: boolean, running: boolean, path: string, platform: string }}
+ *
+ * Example:
+ *   >>> import { autostartStatus } from './autostart.mjs';
+ *   >>> const s = autostartStatus();
+ *   >>> console.log(s.installed, s.running);
+ */
+export function autostartStatus() {
+  const os = platform();
+  if (os === "darwin") return { ...statusLaunchd(), platform: "launchd" };
+  if (os === "linux") return { ...statusSystemd(), platform: "systemd" };
+  return { installed: false, running: false, path: "", platform: os };
+}

package/src/config.mjs

@@ -145,7 +145,7 @@ export function restartGateway() {
  * @returns {{ ok: boolean, message: string, providers: string[] }}
  *
  * Example:
- *   >>> enable({ configPath: "~/.openclaw/openclaw.json", openclawDir: "~/.openclaw", port: 18800 })
+ *   >>> enable({ configPath: "~/.openclaw/openclaw.json", openclawDir: "~/.openclaw", port: 3000 })
  *   { ok: true, message: "Enabled 3 providers", providers: ["anthropic", "byteplus", "ollama"] }
  */
 export function enable({ configPath, openclawDir, port }) {
@@ -260,7 +260,7 @@ export function disable({ configPath, openclawDir }) {
       // Verify backup is clean (doesn't contain proxy URLs)
       try {
         const backupContent = readFileSync(backupPath, "utf-8");
-        if (!backupContent.includes("127.0.0.1:18800")) {
+        if (!backupContent.includes("127.0.0.1:3000")) {
           copyFileSync(backupPath, configPath);
           removeState(openclawDir);
           const restart = restartGateway();
@@ -331,7 +331,7 @@ function cleanProxyUrls(configPath) {
     let cleaned = false;
 
     for (const [name, cfg] of Object.entries(providers)) {
-      if (cfg.baseUrl && cfg.baseUrl.includes("127.0.0.1:18800")) {
+      if (cfg.baseUrl && cfg.baseUrl.includes("127.0.0.1:3000")) {
         if (BUILTIN_URLS[name]) {
           // Known provider — restore builtin URL
           cfg.baseUrl = BUILTIN_URLS[name];

package/src/server.mjs

@@ -21,16 +21,16 @@ import { initHistory, getRecent, getDay, listDates } from "./history.mjs";
  * Start the inspector server.
  *
  * @param {object} options
- * @param {number} options.port - Port to listen on (default 18800).
+ * @param {number} options.port - Port to listen on (default 3000).
  * @param {string} [options.configPath] - Custom path to openclaw.json.
  * @param {boolean} [options.open] - Open browser on start.
  * @returns {Promise<{ server: http.Server, url: string, openclawDir: string }>}
  *
  * Example:
- *   >>> const { url } = await startServer({ port: 18800 });
+ *   >>> const { url } = await startServer({ port: 3000 });
  *   >>> console.log("Inspector at", url);
  */
-export async function startServer({ port = 18800, configPath, open = false }) {
+export async function startServer({ port = 3000, configPath, open = false }) {
   // Detect OpenClaw
   const oc = detect(configPath);
   if (!oc.exists) {