@silicaclaw/cli 2026.3.19-2 → 2026.3.19-21

package/packages/storage/dist/socialRuntimeRepo.js

@@ -1,8 +1,12 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SocialRuntimeRepo = void 0;
 const path_1 = require("path");
 const jsonRepo_1 = require("./jsonRepo");
+const silicaclaw_defaults_json_1 = __importDefault(require("../config/silicaclaw-defaults.json"));
 function emptyRuntime() {
     return {
         enabled: true,
@@ -14,13 +18,13 @@ function emptyRuntime() {
         resolved_identity: null,
         resolved_profile: null,
         resolved_network: {
-            mode: "global-preview",
+            mode: silicaclaw_defaults_json_1.default.network.default_mode,
             adapter: "relay-preview",
-            namespace: "silicaclaw.preview",
+            namespace: silicaclaw_defaults_json_1.default.network.default_namespace,
             port: null,
-            signaling_url: "https://relay.silicaclaw.com",
+            signaling_url: silicaclaw_defaults_json_1.default.network.global_preview.relay_url,
             signaling_urls: [],
-            room: "silicaclaw-global-preview",
+            room: silicaclaw_defaults_json_1.default.network.global_preview.room,
             seed_peers: [],
             bootstrap_hints: [],
             bootstrap_sources: [],

package/packages/storage/src/socialRuntimeRepo.ts

@@ -1,6 +1,7 @@
 import { resolve } from "path";
 import { SocialRuntimeConfig } from "@silicaclaw/core";
 import { JsonFileRepo } from "./jsonRepo";
+import defaults from "../config/silicaclaw-defaults.json";
 
 function emptyRuntime(): SocialRuntimeConfig {
   return {
@@ -13,13 +14,13 @@ function emptyRuntime(): SocialRuntimeConfig {
     resolved_identity: null,
     resolved_profile: null,
     resolved_network: {
-      mode: "global-preview",
+      mode: defaults.network.default_mode as SocialRuntimeConfig["resolved_network"]["mode"],
       adapter: "relay-preview",
-      namespace: "silicaclaw.preview",
+      namespace: defaults.network.default_namespace,
       port: null,
-      signaling_url: "https://relay.silicaclaw.com",
+      signaling_url: defaults.network.global_preview.relay_url,
       signaling_urls: [],
-      room: "silicaclaw-global-preview",
+      room: defaults.network.global_preview.room,
       seed_peers: [],
       bootstrap_hints: [],
       bootstrap_sources: [],

package/packages/storage/tsconfig.json

@@ -1,12 +1,7 @@
 {
   "extends": "../../tsconfig.base.json",
   "compilerOptions": {
-    "outDir": "./dist",
-    "rootDir": "./src",
-    "baseUrl": ".",
-    "paths": {
-      "@silicaclaw/core": ["../../packages/core/dist/index.d.ts"]
-    }
+    "outDir": "./dist"
   },
   "include": ["src"]
 }

package/scripts/functional-check.mjs

@@ -13,13 +13,23 @@ function checkJson(filePath) {
   JSON.parse(raw);
 }
 
-function checkInlineScriptSyntax(htmlPath) {
+function checkBrowserScriptSyntax(htmlPath) {
   const html = readFileSync(htmlPath, 'utf8');
   const start = html.indexOf('<script>');
   const end = html.lastIndexOf('</script>');
-  assert(start >= 0 && end > start, `Missing inline script in ${htmlPath}`);
-  const js = html.slice(start + '<script>'.length, end);
-  new vm.Script(js, { filename: htmlPath });
+  if (start >= 0 && end > start) {
+    const js = html.slice(start + '<script>'.length, end);
+    new vm.Script(js, { filename: htmlPath });
+    return;
+  }
+
+  const moduleMatch = html.match(/<script\s+type="module"\s+src="([^"]+)"/i);
+  assert(moduleMatch?.[1], `Missing browser script in ${htmlPath}`);
+  const src = String(moduleMatch[1]);
+  const resolved = src.startsWith('/')
+    ? path.resolve(path.dirname(htmlPath), `.${src}`)
+    : path.resolve(path.dirname(htmlPath), src);
+  assert(existsSync(resolved), `Missing module script target for ${htmlPath}: ${src}`);
 }
 
 class InMemoryLoopbackTransport {
@@ -66,6 +76,14 @@ async function main() {
     'openclaw-skills/silicaclaw-broadcast/scripts/owner-dispatch-adapter-demo.mjs',
     'openclaw-skills/silicaclaw-broadcast/scripts/send-to-owner-via-openclaw.mjs',
     'openclaw-skills/silicaclaw-broadcast/scripts/owner-forwarder-demo.mjs',
+    'openclaw-skills/silicaclaw-owner-push/SKILL.md',
+    'openclaw-skills/silicaclaw-owner-push/VERSION',
+    'openclaw-skills/silicaclaw-owner-push/manifest.json',
+    'openclaw-skills/silicaclaw-owner-push/agents/openai.yaml',
+    'openclaw-skills/silicaclaw-owner-push/references/push-routing-policy.md',
+    'openclaw-skills/silicaclaw-owner-push/references/runtime-setup.md',
+    'openclaw-skills/silicaclaw-owner-push/scripts/owner-push-forwarder.mjs',
+    'openclaw-skills/silicaclaw-owner-push/scripts/send-to-owner-via-openclaw.mjs',
     'apps/local-console/public/index.html',
     'apps/public-explorer/public/index.html',
     'data/cache.json',
@@ -86,8 +104,8 @@ async function main() {
   checkJson(path.resolve(root, 'data/identity.json'));
 
   // Browser script syntax sanity
-  checkInlineScriptSyntax(path.resolve(root, 'apps/local-console/public/index.html'));
-  checkInlineScriptSyntax(path.resolve(root, 'apps/public-explorer/public/index.html'));
+  checkBrowserScriptSyntax(path.resolve(root, 'apps/local-console/public/index.html'));
+  checkBrowserScriptSyntax(path.resolve(root, 'apps/public-explorer/public/index.html'));
 
   const skillBody = readFileSync(path.resolve(root, 'openclaw-skills/silicaclaw-broadcast/SKILL.md'), 'utf8');
   assert(skillBody.includes('name: silicaclaw-broadcast'), 'OpenClaw skill metadata missing');
@@ -102,6 +120,17 @@ async function main() {
   const skillUi = readFileSync(path.resolve(root, 'openclaw-skills/silicaclaw-broadcast/agents/openai.yaml'), 'utf8');
   assert(skillUi.includes('display_name: "SilicaClaw Broadcast"'), 'OpenClaw skill UI metadata missing');
 
+  const ownerPushBody = readFileSync(path.resolve(root, 'openclaw-skills/silicaclaw-owner-push/SKILL.md'), 'utf8');
+  assert(ownerPushBody.includes('name: silicaclaw-owner-push'), 'Owner push skill metadata missing');
+  const ownerPushManifest = JSON.parse(readFileSync(path.resolve(root, 'openclaw-skills/silicaclaw-owner-push/manifest.json'), 'utf8'));
+  assert(ownerPushManifest.name === 'silicaclaw-owner-push', 'Owner push skill manifest missing name');
+  assert(ownerPushManifest.references?.push_routing_policy === 'references/push-routing-policy.md', 'Owner push skill manifest missing push routing policy reference');
+  assert(ownerPushManifest.references?.runtime_setup === 'references/runtime-setup.md', 'Owner push skill manifest missing runtime setup reference');
+  assert(ownerPushManifest.entrypoints?.owner_push_forwarder === 'scripts/owner-push-forwarder.mjs', 'Owner push skill manifest missing owner push forwarder entrypoint');
+  assert(ownerPushManifest.entrypoints?.owner_send_via_openclaw === 'scripts/send-to-owner-via-openclaw.mjs', 'Owner push skill manifest missing owner send via openclaw entrypoint');
+  const ownerPushUi = readFileSync(path.resolve(root, 'openclaw-skills/silicaclaw-owner-push/agents/openai.yaml'), 'utf8');
+  assert(ownerPushUi.includes('display_name: "SilicaClaw Owner Push"'), 'Owner push skill UI metadata missing');
+
   // Import built modules (requires npm run build)
   const core = await import(pathToFileURL(path.resolve(root, 'packages/core/dist/index.js')).href);
   const network = await import(pathToFileURL(path.resolve(root, 'packages/network/dist/index.js')).href);

package/scripts/install-openclaw-skill.mjs

@@ -26,10 +26,16 @@ function main() {
   const sourceRoot = resolve(ROOT_DIR, "openclaw-skills");
   const targetRoot = resolve(homedir(), ".openclaw", "workspace", "skills");
   const legacyTargetRoot = resolve(homedir(), ".openclaw", "skills");
-  const skills = listSkillDirs(sourceRoot);
+  const requestedSkill = String(process.argv.find((arg) => arg.startsWith("--skill=")) || "")
+    .replace(/^--skill=/, "")
+    .trim();
+  const allSkills = listSkillDirs(sourceRoot);
+  const skills = requestedSkill
+    ? allSkills.filter((skill) => skill.name === requestedSkill)
+    : allSkills;
 
   if (!skills.length) {
-    throw new Error("No bundled OpenClaw skills found.");
+    throw new Error(requestedSkill ? `Bundled OpenClaw skill not found: ${requestedSkill}` : "No bundled OpenClaw skills found.");
   }
 
   mkdirSync(targetRoot, { recursive: true });
@@ -41,6 +47,7 @@ function main() {
   }
 
   console.log(JSON.stringify({
+    requested_skill: requestedSkill || null,
     installed: skills.map((skill) => ({
       name: skill.name,
       target_path: resolve(targetRoot, skill.name),

package/scripts/openclaw-bridge-adapter.mjs

@@ -1,4 +1,6 @@
-const DEFAULT_API_BASE = "http://localhost:4310";
+import defaults from "../config/silicaclaw-defaults.json" with { type: "json" };
+
+const DEFAULT_API_BASE = defaults.bridge.api_base;
 
 function normalizeApiBase(value) {
   return String(value || DEFAULT_API_BASE).replace(/\/+$/, "");

package/scripts/openclaw-bridge-client.mjs

@@ -4,7 +4,9 @@ import { createOpenClawBridgeClient } from "./openclaw-bridge-adapter.mjs";
 
 const argv = process.argv.slice(2);
 const cmd = String(argv[0] || "help").toLowerCase();
-const API_BASE = String(process.env.SILICACLAW_API_BASE || "http://localhost:4310").replace(/\/+$/, "");
+import defaults from "../config/silicaclaw-defaults.json" with { type: "json" };
+
+const API_BASE = String(process.env.SILICACLAW_API_BASE || defaults.bridge.api_base).replace(/\/+$/, "");
 const client = createOpenClawBridgeClient({ apiBase: API_BASE });
 
 const COLOR = {

package/scripts/openclaw-runtime-demo.mjs

@@ -3,7 +3,9 @@
 import readline from "node:readline";
 import { createOpenClawBridgeClient } from "./openclaw-bridge-adapter.mjs";
 
-const apiBase = String(process.env.SILICACLAW_API_BASE || "http://localhost:4310").replace(/\/+$/, "");
+import defaults from "../config/silicaclaw-defaults.json" with { type: "json" };
+
+const apiBase = String(process.env.SILICACLAW_API_BASE || defaults.bridge.api_base).replace(/\/+$/, "");
 const bridge = createOpenClawBridgeClient({ apiBase });
 
 const COLOR = {

package/scripts/quickstart.sh

@@ -7,6 +7,10 @@ WORK_DIR="$ROOT_DIR"
 IS_NPX_MODE=0
 DEFAULT_MODE_PICK="${QUICKSTART_DEFAULT_MODE:-3}"
 CONNECT_MODE="${QUICKSTART_CONNECT_MODE:-0}"
+DEFAULTS_FILE="$ROOT_DIR/config/silicaclaw-defaults.json"
+DEFAULT_LOCAL_CONSOLE_PORT="$(node -p "require(process.argv[1]).ports.local_console" "$DEFAULTS_FILE")"
+DEFAULT_GLOBAL_SIGNALING_URL="$(node -p "require(process.argv[1]).network.global_preview.relay_url" "$DEFAULTS_FILE")"
+DEFAULT_GLOBAL_ROOM="$(node -p "require(process.argv[1]).network.global_preview.room" "$DEFAULTS_FILE")"
 
 case "$DEFAULT_MODE_PICK" in
   1|2|3) ;;
@@ -48,7 +52,7 @@ title() {
 }
 
 headline() {
-  printf '%sSilicaClaw%s %s%s%s\n' "$ORANGE$BOLD" "$RESET" "$DIM" "$(cat "$WORK_DIR/VERSION" 2>/dev/null || printf 'unknown')" "$RESET"
+  printf '%s🦀 SilicaClaw%s %s%s%s\n' "$ORANGE$BOLD" "$RESET" "$DIM" "$(cat "$WORK_DIR/VERSION" 2>/dev/null || printf 'unknown')" "$RESET"
   printf '%sPublic identity and discovery for OpenClaw agents.%s\n' "$DIM" "$RESET"
 }
 
@@ -144,7 +148,7 @@ install_npx_alias() {
   rc_file="$(detect_shell_rc_file)"
   local begin_mark="# >>> silicaclaw npx alias >>>"
   local end_mark="# <<< silicaclaw npx alias <<<"
-  local alias_line="alias silicaclaw='npx -y @silicaclaw/cli@beta'"
+  local alias_line="alias silicaclaw='npx -y @silicaclaw/cli@latest'"
 
   mkdir -p "$(dirname "$rc_file")"
   touch "$rc_file"
@@ -345,14 +349,14 @@ EOF"
 
   if [ "$INSTALLED" != "1" ]; then
     echo "你也可以选择无需全局安装的命令别名模式。"
-    if ask_yes_no "是否自动写入 shell alias（silicaclaw -> npx @silicaclaw/cli@beta）？" "Y"; then
+    if ask_yes_no "是否自动写入 shell alias（silicaclaw -> npx @silicaclaw/cli@latest）？" "Y"; then
       if install_npx_alias; then
         success "alias 安装完成"
       else
         note "alias 安装失败。继续使用 npx 即可。"
       fi
     else
-      kv "临时用法" "npx @silicaclaw/cli@beta <command>"
+      kv "临时用法" "npx @silicaclaw/cli@latest <command>"
     fi
   fi
 fi
@@ -386,7 +390,7 @@ fi
 NETWORK_MODE="local"
 NETWORK_ADAPTER="local-event-bus"
 WEBRTC_SIGNALING_URL_VALUE=""
-WEBRTC_ROOM_VALUE="silicaclaw-global-preview"
+WEBRTC_ROOM_VALUE="$DEFAULT_GLOBAL_ROOM"
 AUTO_START_SIGNALING=0
 
 case "$MODE_PICK" in
@@ -398,9 +402,9 @@ case "$MODE_PICK" in
     NETWORK_MODE="global-preview"
     NETWORK_ADAPTER="relay-preview"
     PUBLIC_IP="$(detect_public_ip)"
-    SIGNALING_DEFAULT="${WEBRTC_SIGNALING_URL:-https://relay.silicaclaw.com}"
+    SIGNALING_DEFAULT="${WEBRTC_SIGNALING_URL:-$DEFAULT_GLOBAL_SIGNALING_URL}"
     if [ -n "$PUBLIC_IP" ]; then
-      SIGNALING_DEFAULT="https://relay.silicaclaw.com"
+      SIGNALING_DEFAULT="$DEFAULT_GLOBAL_SIGNALING_URL"
     fi
     note "signaling 地址需要所有节点都可访问。"
     if [ -n "$PUBLIC_IP" ]; then
@@ -428,8 +432,8 @@ case "$MODE_PICK" in
       kv "本地 relay" "PORT=$SIGNALING_PORT_VALUE"
     fi
 
-    read -r -p "请输入 room（默认 silicaclaw-global-preview）: " WEBRTC_ROOM_VALUE_INPUT || true
-    WEBRTC_ROOM_VALUE="${WEBRTC_ROOM_VALUE_INPUT:-silicaclaw-global-preview}"
+    read -r -p "请输入 room（默认 ${DEFAULT_GLOBAL_ROOM}）: " WEBRTC_ROOM_VALUE_INPUT || true
+    WEBRTC_ROOM_VALUE="${WEBRTC_ROOM_VALUE_INPUT:-$DEFAULT_GLOBAL_ROOM}"
     ;;
   *)
     NETWORK_MODE="local"
@@ -481,7 +485,7 @@ else
   run_cmd "$GATEWAY_CMD"
   echo ""
   success "已启动完成"
-  kv "打开" "http://localhost:4310"
+  kv "打开" "http://localhost:${DEFAULT_LOCAL_CONSOLE_PORT}"
   echo ""
   echo "常用命令："
   kv "Status" "silicaclaw status"

package/scripts/release-pack.mjs

@@ -0,0 +1,147 @@
+#!/usr/bin/env node
+
+import { spawnSync } from "node:child_process";
+import { existsSync, readFileSync } from "node:fs";
+import { resolve } from "node:path";
+
+const ROOT_DIR = resolve(new URL("..", import.meta.url).pathname);
+const args = process.argv.slice(2);
+const dryRun = args.includes("--dry-run");
+
+function readJson(filePath) {
+  return JSON.parse(readFileSync(filePath, "utf8"));
+}
+
+function readText(filePath) {
+  return readFileSync(filePath, "utf8").trim();
+}
+
+function normalizeVersion(value) {
+  const text = String(value || "").trim();
+  return text.startsWith("v") ? text.slice(1) : text;
+}
+
+function toSkillVersion(rootVersion) {
+  return String(rootVersion || "").replace(/-(\d+)$/, "-beta.$1");
+}
+
+function assert(condition, message) {
+  if (!condition) {
+    console.error(message);
+    process.exit(1);
+  }
+}
+
+function run(cmd, cmdArgs, extraEnv = {}) {
+  const result = spawnSync(cmd, cmdArgs, {
+    cwd: ROOT_DIR,
+    stdio: "inherit",
+    env: {
+      ...process.env,
+      npm_config_cache: resolve(ROOT_DIR, ".npm-cache"),
+      ...extraEnv,
+    },
+  });
+  if (result.error) {
+    console.error(result.error.message);
+    process.exit(1);
+  }
+  if ((result.status ?? 1) !== 0) {
+    process.exit(result.status ?? 1);
+  }
+}
+
+function runCapture(cmd, cmdArgs, extraEnv = {}) {
+  const result = spawnSync(cmd, cmdArgs, {
+    cwd: ROOT_DIR,
+    encoding: "utf8",
+    env: {
+      ...process.env,
+      npm_config_cache: resolve(ROOT_DIR, ".npm-cache"),
+      ...extraEnv,
+    },
+  });
+  if (result.error) {
+    console.error(result.error.message);
+    process.exit(1);
+  }
+  if ((result.status ?? 1) !== 0) {
+    if (result.stdout) process.stdout.write(result.stdout);
+    if (result.stderr) process.stderr.write(result.stderr);
+    process.exit(result.status ?? 1);
+  }
+  return String(result.stdout || "");
+}
+
+function verifyVersionSync() {
+  const pkg = readJson(resolve(ROOT_DIR, "package.json"));
+  const lock = readJson(resolve(ROOT_DIR, "package-lock.json"));
+  const rootVersionFile = readText(resolve(ROOT_DIR, "VERSION"));
+  const skillVersionFile = readText(resolve(ROOT_DIR, "openclaw-skills", "silicaclaw-broadcast", "VERSION"));
+  const skillManifest = readJson(resolve(ROOT_DIR, "openclaw-skills", "silicaclaw-broadcast", "manifest.json"));
+
+  const expected = normalizeVersion(pkg.version);
+  const expectedSkill = toSkillVersion(expected);
+  const checks = [
+    ["package.json", normalizeVersion(pkg.version)],
+    ["package-lock.json", normalizeVersion(lock.version)],
+    ['package-lock.json packages[""]', normalizeVersion(lock.packages?.[""]?.version)],
+    ["VERSION", normalizeVersion(rootVersionFile)],
+  ];
+  const skillChecks = [
+    ["skill VERSION", normalizeVersion(skillVersionFile)],
+    ["skill manifest", normalizeVersion(skillManifest.version)],
+  ];
+
+  for (const [label, actual] of checks) {
+    assert(Boolean(actual), `Missing version in ${label}`);
+    assert(actual === expected, `Version mismatch: ${label}=${actual}, expected ${expected}`);
+  }
+
+  for (const [label, actual] of skillChecks) {
+    assert(Boolean(actual), `Missing version in ${label}`);
+    assert(actual === expectedSkill, `Version mismatch: ${label}=${actual}, expected ${expectedSkill}`);
+  }
+
+  console.log(`Version sync OK: root=${expected}, skill=${expectedSkill}`);
+}
+
+function verifyPackContents() {
+  const raw = runCapture("npm", ["pack", "--json", "--dry-run", "--ignore-scripts"]);
+  const start = raw.indexOf("[");
+  const payload = start >= 0 ? raw.slice(start) : raw;
+  const packInfo = JSON.parse(payload);
+  const files = new Set((Array.isArray(packInfo) ? packInfo[0]?.files : packInfo?.files || []).map((entry) => entry.path));
+  const requiredFiles = [
+    "config/silicaclaw-defaults.json",
+    "packages/storage/config/silicaclaw-defaults.json",
+    "node_modules/@silicaclaw/storage/config/silicaclaw-defaults.json",
+    "scripts/silicaclaw-cli.mjs",
+    "scripts/silicaclaw-gateway.mjs",
+  ];
+
+  for (const file of requiredFiles) {
+    assert(files.has(file), `Packed tarball is missing required file: ${file}`);
+  }
+
+  console.log(`Pack contents OK: ${requiredFiles.join(", ")}`);
+}
+
+function main() {
+  assert(existsSync(resolve(ROOT_DIR, "package.json")), "package.json not found");
+  verifyVersionSync();
+
+  console.log("Building workspaces...");
+  run("npm", ["run", "build"]);
+
+  console.log("Validating bundled OpenClaw skill...");
+  run("node", [resolve(ROOT_DIR, "scripts", "validate-openclaw-skill.mjs")]);
+
+  console.log("Verifying npm pack contents...");
+  verifyPackContents();
+
+  console.log(dryRun ? "Running npm pack dry-run..." : "Packing npm tarball...");
+  run("npm", ["pack", ...(dryRun ? ["--dry-run"] : [])]);
+}
+
+main();

package/scripts/silicaclaw-cli.mjs

@@ -9,6 +9,7 @@ import { fileURLToPath } from "node:url";
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 const ROOT_DIR = resolve(__dirname, "..");
+const INVOCATION_CWD = process.cwd();
 
 const COLOR = {
   reset: "\x1b[0m",
@@ -34,7 +35,7 @@ function displayVersion(raw) {
 }
 
 function headline() {
-  console.log(`${paint("SilicaClaw", COLOR.bold, COLOR.orange)} ${paint(displayVersion(readVersion()), COLOR.dim)}`);
+  console.log(`${paint("🦀 SilicaClaw", COLOR.bold, COLOR.orange)} ${paint(displayVersion(readVersion()), COLOR.dim)}`);
   console.log(paint("Public identity and discovery for OpenClaw agents.", COLOR.dim));
 }
 
@@ -50,7 +51,10 @@ function run(cmd, args, extra = {}) {
   const result = spawnSync(cmd, args, {
     cwd: ROOT_DIR,
     stdio: "inherit",
-    env: process.env,
+    env: {
+      ...process.env,
+      SILICACLAW_WORKSPACE_DIR: process.env.SILICACLAW_WORKSPACE_DIR || INVOCATION_CWD,
+    },
     ...extra,
   });
   if (result.error) {
@@ -68,7 +72,10 @@ function runCapture(cmd, args, extra = {}) {
     cwd: ROOT_DIR,
     stdio: ["ignore", "pipe", "pipe"],
     encoding: "utf8",
-    env: process.env,
+    env: {
+      ...process.env,
+      SILICACLAW_WORKSPACE_DIR: process.env.SILICACLAW_WORKSPACE_DIR || INVOCATION_CWD,
+    },
     ...extra,
   });
   if (result.error) {
@@ -81,7 +88,10 @@ function runInherit(cmd, args, extra = {}) {
   const result = spawnSync(cmd, args, {
     cwd: ROOT_DIR,
     stdio: "inherit",
-    env: process.env,
+    env: {
+      ...process.env,
+      SILICACLAW_WORKSPACE_DIR: process.env.SILICACLAW_WORKSPACE_DIR || INVOCATION_CWD,
+    },
     ...extra,
   });
   if (result.error) {
@@ -296,18 +306,19 @@ function canWriteGlobalPrefix() {
   }
 }
 
-function showUpdateGuide(current, latest, beta) {
+function showUpdateGuide(current, targetVersion, channel = "beta") {
   headline();
   console.log("");
-  const upToDate = Boolean(beta) && current === beta;
+  const upToDate = Boolean(targetVersion) && current === targetVersion;
   if (upToDate) {
     kv("Status", `up to date (${current})`);
   } else {
-    kv("Status", `beta update available (${beta || "-"})`);
+    kv("Status", `update available (${targetVersion || "-"})`);
   }
   console.log("");
   kv("Start", "silicaclaw start");
   kv("Status", "silicaclaw status");
+  kv("Channel", channel);
 }
 
 function getGatewayStatus() {
@@ -394,12 +405,29 @@ function restartGatewayIfRunning() {
   runInherit("node", args, { cwd: process.cwd() });
 }
 
-function tryGlobalUpgrade(beta) {
+function tryGlobalUpgrade(version) {
   const writableGlobal = canWriteGlobalPrefix();
   if (!writableGlobal) return false;
-  kv("Upgrade", `installing @silicaclaw/cli@${beta} globally`);
-  const result = runInherit("npm", ["i", "-g", `@silicaclaw/cli@${beta}`]);
-  return (result.status ?? 1) === 0;
+  kv("Upgrade", `installing @silicaclaw/cli@${version} globally`);
+  const exactResult = runCapture("npm", ["i", "-g", `@silicaclaw/cli@${version}`]);
+  if ((exactResult.status ?? 1) === 0) {
+    if (exactResult.stdout) process.stdout.write(exactResult.stdout);
+    if (exactResult.stderr) process.stderr.write(exactResult.stderr);
+    return true;
+  }
+
+  const detail = compactOutput(`${exactResult.stdout || ""}\n${exactResult.stderr || ""}`);
+  if (detail.includes("ETARGET") || detail.includes("No matching version found")) {
+    kv("Fallback", "registry metadata is still settling, retrying via @beta tag");
+    const fallbackResult = runInherit("npm", ["i", "-g", "@silicaclaw/cli@beta"]);
+    return (fallbackResult.status ?? 1) === 0;
+  }
+
+  if (detail) {
+    console.log("");
+    console.log(detail);
+  }
+  return false;
 }
 
 function update() {
@@ -417,9 +445,8 @@ function update() {
     }
     const text = String(result.stdout || "").trim();
     const tags = text ? JSON.parse(text) : {};
-    const latest = tags.latest ? String(tags.latest) : "";
     const beta = tags.beta ? String(tags.beta) : "";
-    showUpdateGuide(current, latest, beta);
+    showUpdateGuide(current, beta, "beta");
     const hasNewBeta = Boolean(beta) && beta !== current;
     const npxRuntime = isNpxRun();
 
@@ -477,6 +504,7 @@ function help() {
   headline();
   console.log("");
   section("Commands");
+  kv("First Run", "npx -y @silicaclaw/cli@beta onboard");
   kv("Install", "npx -y @silicaclaw/cli@beta install");
   kv("Start", "silicaclaw start");
   kv("Status", "silicaclaw status");
@@ -492,6 +520,12 @@ function help() {
   kv("Logs", "silicaclaw logs local-console");
   kv("Doctor", "silicaclaw doctor");
   kv("Help", "silicaclaw help");
+  console.log("");
+  section("Meaning");
+  kv("onboard", "first-time setup wizard");
+  kv("connect", "quick network setup wizard");
+  kv("install", "install persistent silicaclaw command only");
+  kv("channel", "@beta is the recommended first-run channel right now");
 }
 
 const cmd = String(process.argv[2] || "help").trim().toLowerCase();