@silicaclaw/cli 2026.3.19-15 → 2026.3.19-16

package/packages/network/src/realPreview.ts

@@ -12,6 +12,7 @@ import { JsonMessageEnvelopeCodec } from "./codec/jsonMessageEnvelopeCodec";
 import { JsonTopicCodec } from "./codec/jsonTopicCodec";
 import { UdpLanBroadcastTransport } from "./transport/udpLanBroadcastTransport";
 import { HeartbeatPeerDiscovery } from "./discovery/heartbeatPeerDiscovery";
+import defaults from "../../../config/silicaclaw-defaults.json";
 
 type RealNetworkAdapterPreviewOptions = {
   peerId?: string;
@@ -124,7 +125,7 @@ export class RealNetworkAdapterPreview implements NetworkAdapter {
 
   constructor(options: RealNetworkAdapterPreviewOptions = {}) {
     this.peerId = options.peerId ?? `peer-${process.pid}-${Math.random().toString(36).slice(2, 10)}`;
-    this.namespace = this.normalizeNamespace(options.namespace ?? "silicaclaw.preview");
+    this.namespace = this.normalizeNamespace(options.namespace ?? defaults.network.default_namespace);
     this.transport = options.transport ?? new UdpLanBroadcastTransport();
     this.envelopeCodec = options.envelopeCodec ?? new JsonMessageEnvelopeCodec();
     this.topicCodec = options.topicCodec ?? new JsonTopicCodec();
@@ -424,7 +425,7 @@ export class RealNetworkAdapterPreview implements NetworkAdapter {
 
   private normalizeNamespace(namespace: string): string {
     const normalized = namespace.trim();
-    return normalized.length > 0 ? normalized : "silicaclaw.preview";
+    return normalized.length > 0 ? normalized : defaults.network.default_namespace;
   }
 
   private errorMessage(error: unknown): string {

package/packages/network/src/relayPreview.ts

@@ -8,6 +8,7 @@ import {
 import { TopicCodec } from "./abstractions/topicCodec";
 import { JsonMessageEnvelopeCodec } from "./codec/jsonMessageEnvelopeCodec";
 import { JsonTopicCodec } from "./codec/jsonTopicCodec";
+import defaults from "../../../config/silicaclaw-defaults.json";
 
 type RelayPreviewOptions = {
   peerId?: string;
@@ -196,7 +197,8 @@ export class RelayPreviewAdapter implements NetworkAdapter {
 
   constructor(options: RelayPreviewOptions = {}) {
     this.peerId = options.peerId ?? `peer-${process.pid}-${Math.random().toString(36).slice(2, 10)}`;
-    this.namespace = String(options.namespace || "silicaclaw.preview").trim() || "silicaclaw.preview";
+    this.namespace =
+      String(options.namespace || defaults.network.default_namespace).trim() || defaults.network.default_namespace;
     this.signalingEndpoints = dedupe(
       (options.signalingUrls && options.signalingUrls.length > 0
         ? options.signalingUrls
@@ -204,7 +206,8 @@ export class RelayPreviewAdapter implements NetworkAdapter {
     );
     this.activeEndpoint = this.signalingEndpoints[0] || "http://localhost:4510";
     this.activeEndpointIndex = 0;
-    this.room = String(options.room || "silicaclaw-global-preview").trim() || "silicaclaw-global-preview";
+    this.room =
+      String(options.room || defaults.network.global_preview.room).trim() || defaults.network.global_preview.room;
     this.seedPeers = dedupe(options.seedPeers || []);
     this.bootstrapHints = dedupe(options.bootstrapHints || []);
     this.bootstrapSources = dedupe(options.bootstrapSources || []);

package/packages/network/src/transport/udpLanBroadcastTransport.ts

@@ -1,4 +1,5 @@
 import dgram from "dgram";
+import defaults from "../../../../config/silicaclaw-defaults.json";
 import {
   NetworkTransport,
   TransportConfigSnapshot,
@@ -38,7 +39,7 @@ export class UdpLanBroadcastTransport implements NetworkTransport {
   private broadcastAddress: string;
 
   constructor(options: UdpLanBroadcastTransportOptions = {}) {
-    this.port = options.port ?? 44123;
+    this.port = options.port ?? defaults.ports.network_default;
     this.bindAddress = options.bindAddress ?? "0.0.0.0";
     this.broadcastAddress = options.broadcastAddress ?? "255.255.255.255";
   }

package/packages/network/src/webrtcPreview.ts

@@ -8,6 +8,7 @@ import {
 import { TopicCodec } from "./abstractions/topicCodec";
 import { JsonMessageEnvelopeCodec } from "./codec/jsonMessageEnvelopeCodec";
 import { JsonTopicCodec } from "./codec/jsonTopicCodec";
+import defaults from "../../../config/silicaclaw-defaults.json";
 
 type WebRTCPreviewOptions = {
   peerId?: string;
@@ -261,7 +262,7 @@ export class WebRTCPreviewAdapter implements NetworkAdapter {
 
   constructor(options: WebRTCPreviewOptions = {}) {
     this.peerId = options.peerId ?? `webrtc-${process.pid}-${Math.random().toString(36).slice(2, 9)}`;
-    this.namespace = (options.namespace ?? "silicaclaw.preview").trim() || "silicaclaw.preview";
+    this.namespace = (options.namespace ?? defaults.network.default_namespace).trim() || defaults.network.default_namespace;
     const configuredSignalingUrls = dedupeArray([
       ...(options.signalingUrls ?? []),
       options.signalingUrl ?? "",

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/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) ;;
@@ -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

@@ -21,6 +21,10 @@ function normalizeVersion(value) {
   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);
@@ -55,11 +59,14 @@ function verifyVersionSync() {
   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)],
   ];
@@ -69,7 +76,12 @@ function verifyVersionSync() {
     assert(actual === expected, `Version mismatch: ${label}=${actual}, expected ${expected}`);
   }
 
-  console.log(`Version sync OK: ${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 main() {

package/scripts/silicaclaw-cli.mjs

@@ -238,7 +238,7 @@ function installPersistentCommand() {
       "#!/usr/bin/env bash",
       "set -euo pipefail",
       'export npm_config_cache="${npm_config_cache:-$HOME/.silicaclaw/npm-cache}"',
-      'exec npx -y @silicaclaw/cli@beta "$@"',
+      'exec npx -y @silicaclaw/cli@latest "$@"',
       "",
     ].join("\n"),
     { encoding: "utf8", mode: 0o755 }
@@ -306,14 +306,14 @@ function canWriteGlobalPrefix() {
   }
 }
 
-function showUpdateGuide(current, latest, beta) {
+function showUpdateGuide(current, latest) {
   headline();
   console.log("");
-  const upToDate = Boolean(beta) && current === beta;
+  const upToDate = Boolean(latest) && current === latest;
   if (upToDate) {
     kv("Status", `up to date (${current})`);
   } else {
-    kv("Status", `beta update available (${beta || "-"})`);
+    kv("Status", `update available (${latest || "-"})`);
   }
   console.log("");
   kv("Start", "silicaclaw start");
@@ -404,11 +404,11 @@ 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 exactResult = runCapture("npm", ["i", "-g", `@silicaclaw/cli@${beta}`]);
+  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);
@@ -417,8 +417,8 @@ function tryGlobalUpgrade(beta) {
 
   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"]);
+    kv("Fallback", "registry metadata is still settling, retrying via @latest tag");
+    const fallbackResult = runInherit("npm", ["i", "-g", "@silicaclaw/cli@latest"]);
     return (fallbackResult.status ?? 1) === 0;
   }
 
@@ -445,18 +445,17 @@ 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);
-    const hasNewBeta = Boolean(beta) && beta !== current;
+    showUpdateGuide(current, latest);
+    const hasNewLatest = Boolean(latest) && latest !== current;
     const npxRuntime = isNpxRun();
 
-    if (hasNewBeta) {
+    if (hasNewLatest) {
       if (npxRuntime) {
-        kv("Update", `next run will use ${beta}`);
-      } else if (tryGlobalUpgrade(beta)) {
-        kv("Update", `installed ${beta}`);
+        kv("Update", `next run will use ${latest}`);
+      } else if (tryGlobalUpgrade(latest)) {
+        kv("Update", `installed ${latest}`);
       } else {
-        kv("Update", `install ${beta} manually if needed`);
+        kv("Update", `install ${latest} manually if needed`);
       }
     }
 
@@ -504,7 +503,8 @@ function help() {
   headline();
   console.log("");
   section("Commands");
-  kv("Install", "npx -y @silicaclaw/cli@beta install");
+  kv("First Run", "npx -y @silicaclaw/cli@latest onboard");
+  kv("Install", "npx -y @silicaclaw/cli@latest install");
   kv("Start", "silicaclaw start");
   kv("Status", "silicaclaw status");
   kv("Stop", "silicaclaw stop");
@@ -519,6 +519,11 @@ 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");
 }
 
 const cmd = String(process.argv[2] || "help").trim().toLowerCase();