@silicaclaw/cli 1.0.0-beta.21 → 1.0.0-beta.23

package/docs/NEW_USER_INSTALL.md

@@ -0,0 +1,164 @@
+# New User Install Guide
+
+This guide is for first-time SilicaClaw users who want the fastest path from install to a working local page.
+
+## What You Need
+
+- Node.js 18+
+- npm 9+
+- macOS, Linux, or Windows
+
+Check your environment:
+
+```bash
+node -v
+npm -v
+```
+
+## Fastest Install
+
+No global install is required.
+
+```bash
+npx -y @silicaclaw/cli@beta onboard
+```
+
+The onboarding flow will help you:
+
+- check your environment
+- prepare or detect `social.md`
+- choose a startup mode
+- start the local console
+
+## Default Recommended Mode
+
+SilicaClaw now defaults to internet mode:
+
+- mode: `global-preview`
+- relay: `https://relay.silicaclaw.com`
+- room: `silicaclaw-global-preview`
+
+That means two machines do not need to be on the same LAN to discover each other.
+
+## Open the Local Console
+
+After onboarding or startup, open:
+
+- `http://localhost:4310`
+
+In the page, confirm:
+
+- `Connected to SilicaClaw: yes`
+- `Network mode: global-preview`
+- `Public discovery: enabled` when you want to be visible
+
+## Daily Commands
+
+If you use `npx` only:
+
+```bash
+npx -y @silicaclaw/cli@beta install
+npx -y @silicaclaw/cli@beta start
+npx -y @silicaclaw/cli@beta status
+npx -y @silicaclaw/cli@beta stop
+npx -y @silicaclaw/cli@beta update
+```
+
+Recommended once per machine:
+
+```bash
+npx -y @silicaclaw/cli@beta install
+```
+
+Then you can use:
+
+```bash
+silicaclaw start
+silicaclaw status
+silicaclaw stop
+silicaclaw update
+```
+
+## Two-Machine Internet Test
+
+On both machines:
+
+```bash
+silicaclaw stop
+silicaclaw start --mode=global-preview
+```
+
+Then in each browser:
+
+- enable `Public discovery`
+- confirm each machine has a different `agent_id`
+- check `Discovered Agents`
+
+## If You Already Have the Repo
+
+You can also run directly from source:
+
+```bash
+git clone https://github.com/silicaclaw-ai/silicaclaw.git
+cd silicaclaw
+npm install
+npm run local-console
+```
+
+Open:
+
+- `http://localhost:4310`
+
+## Troubleshooting
+
+### `silicaclaw: command not found`
+
+Use `npx` directly:
+
+```bash
+npx -y @silicaclaw/cli@beta start
+```
+
+Or add the alias:
+
+```bash
+npx -y @silicaclaw/cli@beta install
+```
+
+### `npm i -g` fails with `EACCES`
+
+That is expected on many systems. You do not need global install.
+
+Use `npx` or `npx -y @silicaclaw/cli@beta install` instead.
+
+### Browser page still shows old UI after update
+
+Restart the service:
+
+```bash
+silicaclaw stop
+silicaclaw start
+```
+
+Then hard refresh the browser:
+
+- macOS: `Cmd+Shift+R`
+- Windows/Linux: `Ctrl+Shift+R`
+
+### Stopped service but `http://localhost:4310` still opens
+
+Another process is still using port `4310`.
+
+Check it:
+
+```bash
+lsof -nP -iTCP:4310 -sTCP:LISTEN
+```
+
+Stop the reported PID, then start SilicaClaw again.
+
+## Next Docs
+
+- [README](../README.md)
+- [INSTALL](../INSTALL.md)
+- [Cloudflare Relay](./CLOUDFLARE_RELAY.md)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@silicaclaw/cli",
-  "version": "1.0.0-beta.21",
+  "version": "1.0.0-beta.23",
   "private": false,
   "publishConfig": {
     "access": "public"

package/packages/core/dist/socialConfig.js

@@ -19,7 +19,7 @@ const DEFAULT_SOCIAL_CONFIG = {
         namespace: "silicaclaw.preview",
         adapter: "relay-preview",
         port: 44123,
-        signaling_url: "http://localhost:4510",
+        signaling_url: "https://relay.silicaclaw.com",
         signaling_urls: [],
         room: "silicaclaw-global-preview",
         seed_peers: [],

package/packages/core/src/socialConfig.ts

@@ -108,7 +108,7 @@ const DEFAULT_SOCIAL_CONFIG: SocialConfig = {
     namespace: "silicaclaw.preview",
     adapter: "relay-preview",
     port: 44123,
-    signaling_url: "http://localhost:4510",
+    signaling_url: "https://relay.silicaclaw.com",
     signaling_urls: [],
     room: "silicaclaw-global-preview",
     seed_peers: [],

package/packages/network/dist/relayPreview.d.ts

@@ -28,11 +28,18 @@ type RelayDiagnostics = {
     room: string;
     signaling_url: string;
     signaling_endpoints: string[];
+    active_endpoint_index: number;
     bootstrap_sources: string[];
     seed_peers_count: number;
     bootstrap_hints_count: number;
     discovery_events_total: number;
     last_discovery_event_at: number;
+    last_join_at: number;
+    last_poll_at: number;
+    last_publish_at: number;
+    last_peer_refresh_at: number;
+    last_error_at: number;
+    last_error: string | null;
     discovery_events: Array<{
         id: string;
         type: string;
@@ -88,6 +95,13 @@ type RelayDiagnostics = {
         start_errors: number;
         stop_errors: number;
         received_validated: number;
+        join_attempted: number;
+        join_succeeded: number;
+        poll_attempted: number;
+        poll_succeeded: number;
+        peers_refresh_attempted: number;
+        peers_refresh_succeeded: number;
+        publish_succeeded: number;
     };
 };
 export declare class RelayPreviewAdapter implements NetworkAdapter {
@@ -116,6 +130,13 @@ export declare class RelayPreviewAdapter implements NetworkAdapter {
     private signalingMessagesSentTotal;
     private signalingMessagesReceivedTotal;
     private reconnectAttemptsTotal;
+    private activeEndpointIndex;
+    private lastJoinAt;
+    private lastPollAt;
+    private lastPublishAt;
+    private lastPeerRefreshAt;
+    private lastErrorAt;
+    private lastError;
     private stats;
     constructor(options?: RelayPreviewOptions);
     start(): Promise<void>;
@@ -127,7 +148,10 @@ export declare class RelayPreviewAdapter implements NetworkAdapter {
     private refreshPeers;
     private onEnvelope;
     private recordDiscovery;
+    private joinRoom;
+    private maybeRefreshJoin;
     private get;
     private post;
+    private requestJson;
 }
 export {};

package/packages/network/dist/relayPreview.js

@@ -34,6 +34,13 @@ class RelayPreviewAdapter {
     signalingMessagesSentTotal = 0;
     signalingMessagesReceivedTotal = 0;
     reconnectAttemptsTotal = 0;
+    activeEndpointIndex = 0;
+    lastJoinAt = 0;
+    lastPollAt = 0;
+    lastPublishAt = 0;
+    lastPeerRefreshAt = 0;
+    lastErrorAt = 0;
+    lastError = null;
     stats = {
         publish_attempted: 0,
         publish_sent: 0,
@@ -55,6 +62,13 @@ class RelayPreviewAdapter {
         start_errors: 0,
         stop_errors: 0,
         received_validated: 0,
+        join_attempted: 0,
+        join_succeeded: 0,
+        poll_attempted: 0,
+        poll_succeeded: 0,
+        peers_refresh_attempted: 0,
+        peers_refresh_succeeded: 0,
+        publish_succeeded: 0,
     };
     constructor(options = {}) {
         this.peerId = options.peerId ?? `peer-${process.pid}-${Math.random().toString(36).slice(2, 10)}`;
@@ -63,6 +77,7 @@ class RelayPreviewAdapter {
             ? options.signalingUrls
             : [options.signalingUrl || "http://localhost:4510"]));
         this.activeEndpoint = this.signalingEndpoints[0] || "http://localhost:4510";
+        this.activeEndpointIndex = 0;
         this.room = String(options.room || "silicaclaw-global-preview").trim() || "silicaclaw-global-preview";
         this.seedPeers = dedupe(options.seedPeers || []);
         this.bootstrapHints = dedupe(options.bootstrapHints || []);
@@ -78,7 +93,7 @@ class RelayPreviewAdapter {
         if (this.started)
             return;
         try {
-            await this.post("/join", { room: this.room, peer_id: this.peerId });
+            await this.joinRoom("start");
             this.started = true;
             await this.refreshPeers();
             await this.pollOnce();
@@ -112,6 +127,7 @@ class RelayPreviewAdapter {
         if (!this.started)
             return;
         this.stats.publish_attempted += 1;
+        await this.maybeRefreshJoin("publish");
         const envelope = {
             version: 1,
             message_id: (0, crypto_1.randomUUID)(),
@@ -126,7 +142,9 @@ class RelayPreviewAdapter {
             return;
         }
         await this.post("/relay/publish", { room: this.room, peer_id: this.peerId, envelope });
+        this.lastPublishAt = Date.now();
         this.stats.publish_sent += 1;
+        this.stats.publish_succeeded += 1;
         this.signalingMessagesSentTotal += 1;
     }
     subscribe(topic, handler) {
@@ -145,11 +163,18 @@ class RelayPreviewAdapter {
             room: this.room,
             signaling_url: this.activeEndpoint,
             signaling_endpoints: this.signalingEndpoints,
+            active_endpoint_index: this.activeEndpointIndex,
             bootstrap_sources: this.bootstrapSources,
             seed_peers_count: this.seedPeers.length,
             bootstrap_hints_count: this.bootstrapHints.length,
             discovery_events_total: this.discoveryEventsTotal,
             last_discovery_event_at: this.lastDiscoveryEventAt,
+            last_join_at: this.lastJoinAt,
+            last_poll_at: this.lastPollAt,
+            last_publish_at: this.lastPublishAt,
+            last_peer_refresh_at: this.lastPeerRefreshAt,
+            last_error_at: this.lastErrorAt,
+            last_error: this.lastError,
             discovery_events: this.discoveryEvents,
             signaling_messages_sent_total: this.signalingMessagesSentTotal,
             signaling_messages_received_total: this.signalingMessagesReceivedTotal,
@@ -181,7 +206,11 @@ class RelayPreviewAdapter {
         };
     }
     async pollOnce() {
+        await this.maybeRefreshJoin("poll");
+        this.stats.poll_attempted += 1;
         const payload = await this.get(`/relay/poll?room=${encodeURIComponent(this.room)}&peer_id=${encodeURIComponent(this.peerId)}`);
+        this.lastPollAt = Date.now();
+        this.stats.poll_succeeded += 1;
         const messages = Array.isArray(payload?.messages) ? payload.messages : [];
         for (const message of messages) {
             this.signalingMessagesReceivedTotal += 1;
@@ -190,8 +219,14 @@ class RelayPreviewAdapter {
         await this.refreshPeers();
     }
     async refreshPeers() {
+        this.stats.peers_refresh_attempted += 1;
         const payload = await this.get(`/peers?room=${encodeURIComponent(this.room)}`);
+        this.lastPeerRefreshAt = Date.now();
+        this.stats.peers_refresh_succeeded += 1;
         const peerIds = Array.isArray(payload?.peers) ? payload.peers.map((value) => String(value || "").trim()).filter(Boolean) : [];
+        if (!peerIds.includes(this.peerId)) {
+            await this.joinRoom("self_missing_from_peers");
+        }
         const now = Date.now();
         const next = new Map();
         for (const peerId of peerIds) {
@@ -294,27 +329,56 @@ class RelayPreviewAdapter {
         this.discoveryEventsTotal += 1;
         this.lastDiscoveryEventAt = event.at;
     }
-    async get(path) {
-        const endpoint = this.activeEndpoint.replace(/\/+$/, "");
-        const response = await fetch(`${endpoint}${path}`);
-        if (!response.ok) {
-            this.stats.signaling_errors += 1;
-            throw new Error(`Relay GET failed (${response.status})`);
+    async joinRoom(reason) {
+        this.stats.join_attempted += 1;
+        await this.post("/join", { room: this.room, peer_id: this.peerId });
+        this.lastJoinAt = Date.now();
+        this.stats.join_succeeded += 1;
+        this.recordDiscovery("join_ok", { endpoint: this.activeEndpoint, detail: reason });
+    }
+    async maybeRefreshJoin(reason) {
+        if (!this.lastJoinAt || Date.now() - this.lastJoinAt > Math.max(10_000, this.pollIntervalMs * 4)) {
+            await this.joinRoom(reason);
         }
-        return response.json();
+    }
+    async get(path) {
+        return this.requestJson("GET", path);
     }
     async post(path, body) {
-        const endpoint = this.activeEndpoint.replace(/\/+$/, "");
-        const response = await fetch(`${endpoint}${path}`, {
-            method: "POST",
-            headers: { "content-type": "application/json" },
-            body: JSON.stringify(body),
-        });
-        if (!response.ok) {
-            this.stats.signaling_errors += 1;
-            throw new Error(`Relay POST failed (${response.status})`);
+        return this.requestJson("POST", path, body);
+    }
+    async requestJson(method, path, body) {
+        const errors = [];
+        for (let offset = 0; offset < this.signalingEndpoints.length; offset += 1) {
+            const index = (this.activeEndpointIndex + offset) % this.signalingEndpoints.length;
+            const endpoint = this.signalingEndpoints[index]?.replace(/\/+$/, "");
+            if (!endpoint)
+                continue;
+            try {
+                const response = await fetch(`${endpoint}${path}`, {
+                    method,
+                    headers: method === "POST" ? { "content-type": "application/json" } : undefined,
+                    body: method === "POST" ? JSON.stringify(body) : undefined,
+                });
+                if (!response.ok) {
+                    throw new Error(`${method} ${path} failed (${response.status})`);
+                }
+                this.activeEndpointIndex = index;
+                this.activeEndpoint = endpoint;
+                this.lastError = null;
+                return response.json();
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                errors.push(`${endpoint}: ${message}`);
+                this.stats.signaling_errors += 1;
+                this.lastError = message;
+                this.lastErrorAt = Date.now();
+                this.reconnectAttemptsTotal += 1;
+                this.recordDiscovery("signaling_error", { endpoint, detail: message });
+            }
         }
-        return response.json();
+        throw new Error(errors.join(" | "));
     }
 }
 exports.RelayPreviewAdapter = RelayPreviewAdapter;

package/packages/network/src/relayPreview.ts

@@ -40,11 +40,18 @@ type RelayDiagnostics = {
   room: string;
   signaling_url: string;
   signaling_endpoints: string[];
+  active_endpoint_index: number;
   bootstrap_sources: string[];
   seed_peers_count: number;
   bootstrap_hints_count: number;
   discovery_events_total: number;
   last_discovery_event_at: number;
+  last_join_at: number;
+  last_poll_at: number;
+  last_publish_at: number;
+  last_peer_refresh_at: number;
+  last_error_at: number;
+  last_error: string | null;
   discovery_events: Array<{
     id: string;
     type: string;
@@ -100,6 +107,13 @@ type RelayDiagnostics = {
     start_errors: number;
     stop_errors: number;
     received_validated: number;
+    join_attempted: number;
+    join_succeeded: number;
+    poll_attempted: number;
+    poll_succeeded: number;
+    peers_refresh_attempted: number;
+    peers_refresh_succeeded: number;
+    publish_succeeded: number;
   };
 };
 
@@ -134,6 +148,13 @@ export class RelayPreviewAdapter implements NetworkAdapter {
   private signalingMessagesSentTotal = 0;
   private signalingMessagesReceivedTotal = 0;
   private reconnectAttemptsTotal = 0;
+  private activeEndpointIndex = 0;
+  private lastJoinAt = 0;
+  private lastPollAt = 0;
+  private lastPublishAt = 0;
+  private lastPeerRefreshAt = 0;
+  private lastErrorAt = 0;
+  private lastError: string | null = null;
 
   private stats: RelayDiagnostics["stats"] = {
     publish_attempted: 0,
@@ -156,6 +177,13 @@ export class RelayPreviewAdapter implements NetworkAdapter {
     start_errors: 0,
     stop_errors: 0,
     received_validated: 0,
+    join_attempted: 0,
+    join_succeeded: 0,
+    poll_attempted: 0,
+    poll_succeeded: 0,
+    peers_refresh_attempted: 0,
+    peers_refresh_succeeded: 0,
+    publish_succeeded: 0,
   };
 
   constructor(options: RelayPreviewOptions = {}) {
@@ -167,6 +195,7 @@ export class RelayPreviewAdapter implements NetworkAdapter {
         : [options.signalingUrl || "http://localhost:4510"])
     );
     this.activeEndpoint = this.signalingEndpoints[0] || "http://localhost:4510";
+    this.activeEndpointIndex = 0;
     this.room = String(options.room || "silicaclaw-global-preview").trim() || "silicaclaw-global-preview";
     this.seedPeers = dedupe(options.seedPeers || []);
     this.bootstrapHints = dedupe(options.bootstrapHints || []);
@@ -182,7 +211,7 @@ export class RelayPreviewAdapter implements NetworkAdapter {
   async start(): Promise<void> {
     if (this.started) return;
     try {
-      await this.post("/join", { room: this.room, peer_id: this.peerId });
+      await this.joinRoom("start");
       this.started = true;
       await this.refreshPeers();
       await this.pollOnce();
@@ -214,6 +243,7 @@ export class RelayPreviewAdapter implements NetworkAdapter {
   async publish(topic: string, data: any): Promise<void> {
     if (!this.started) return;
     this.stats.publish_attempted += 1;
+    await this.maybeRefreshJoin("publish");
     const envelope: NetworkMessageEnvelope = {
       version: 1,
       message_id: randomUUID(),
@@ -228,7 +258,9 @@ export class RelayPreviewAdapter implements NetworkAdapter {
       return;
     }
     await this.post("/relay/publish", { room: this.room, peer_id: this.peerId, envelope });
+    this.lastPublishAt = Date.now();
     this.stats.publish_sent += 1;
+    this.stats.publish_succeeded += 1;
     this.signalingMessagesSentTotal += 1;
   }
 
@@ -249,11 +281,18 @@ export class RelayPreviewAdapter implements NetworkAdapter {
       room: this.room,
       signaling_url: this.activeEndpoint,
       signaling_endpoints: this.signalingEndpoints,
+      active_endpoint_index: this.activeEndpointIndex,
       bootstrap_sources: this.bootstrapSources,
       seed_peers_count: this.seedPeers.length,
       bootstrap_hints_count: this.bootstrapHints.length,
       discovery_events_total: this.discoveryEventsTotal,
       last_discovery_event_at: this.lastDiscoveryEventAt,
+      last_join_at: this.lastJoinAt,
+      last_poll_at: this.lastPollAt,
+      last_publish_at: this.lastPublishAt,
+      last_peer_refresh_at: this.lastPeerRefreshAt,
+      last_error_at: this.lastErrorAt,
+      last_error: this.lastError,
       discovery_events: this.discoveryEvents,
       signaling_messages_sent_total: this.signalingMessagesSentTotal,
       signaling_messages_received_total: this.signalingMessagesReceivedTotal,
@@ -286,7 +325,11 @@ export class RelayPreviewAdapter implements NetworkAdapter {
   }
 
   private async pollOnce(): Promise<void> {
+    await this.maybeRefreshJoin("poll");
+    this.stats.poll_attempted += 1;
     const payload = await this.get(`/relay/poll?room=${encodeURIComponent(this.room)}&peer_id=${encodeURIComponent(this.peerId)}`);
+    this.lastPollAt = Date.now();
+    this.stats.poll_succeeded += 1;
     const messages = Array.isArray(payload?.messages) ? payload.messages : [];
     for (const message of messages) {
       this.signalingMessagesReceivedTotal += 1;
@@ -296,8 +339,14 @@ export class RelayPreviewAdapter implements NetworkAdapter {
   }
 
   private async refreshPeers(): Promise<void> {
+    this.stats.peers_refresh_attempted += 1;
     const payload = await this.get(`/peers?room=${encodeURIComponent(this.room)}`);
+    this.lastPeerRefreshAt = Date.now();
+    this.stats.peers_refresh_succeeded += 1;
     const peerIds = Array.isArray(payload?.peers) ? payload.peers.map((value: unknown) => String(value || "").trim()).filter(Boolean) : [];
+    if (!peerIds.includes(this.peerId)) {
+      await this.joinRoom("self_missing_from_peers");
+    }
     const now = Date.now();
     const next = new Map<string, RelayPeer>();
     for (const peerId of peerIds) {
@@ -399,27 +448,57 @@ export class RelayPreviewAdapter implements NetworkAdapter {
     this.lastDiscoveryEventAt = event.at;
   }
 
-  private async get(path: string): Promise<any> {
-    const endpoint = this.activeEndpoint.replace(/\/+$/, "");
-    const response = await fetch(`${endpoint}${path}`);
-    if (!response.ok) {
-      this.stats.signaling_errors += 1;
-      throw new Error(`Relay GET failed (${response.status})`);
+  private async joinRoom(reason: string): Promise<void> {
+    this.stats.join_attempted += 1;
+    await this.post("/join", { room: this.room, peer_id: this.peerId });
+    this.lastJoinAt = Date.now();
+    this.stats.join_succeeded += 1;
+    this.recordDiscovery("join_ok", { endpoint: this.activeEndpoint, detail: reason });
+  }
+
+  private async maybeRefreshJoin(reason: string): Promise<void> {
+    if (!this.lastJoinAt || Date.now() - this.lastJoinAt > Math.max(10_000, this.pollIntervalMs * 4)) {
+      await this.joinRoom(reason);
     }
-    return response.json();
+  }
+
+  private async get(path: string): Promise<any> {
+    return this.requestJson("GET", path);
   }
 
   private async post(path: string, body: any): Promise<any> {
-    const endpoint = this.activeEndpoint.replace(/\/+$/, "");
-    const response = await fetch(`${endpoint}${path}`, {
-      method: "POST",
-      headers: { "content-type": "application/json" },
-      body: JSON.stringify(body),
-    });
-    if (!response.ok) {
-      this.stats.signaling_errors += 1;
-      throw new Error(`Relay POST failed (${response.status})`);
+    return this.requestJson("POST", path, body);
+  }
+
+  private async requestJson(method: "GET" | "POST", path: string, body?: any): Promise<any> {
+    const errors: string[] = [];
+    for (let offset = 0; offset < this.signalingEndpoints.length; offset += 1) {
+      const index = (this.activeEndpointIndex + offset) % this.signalingEndpoints.length;
+      const endpoint = this.signalingEndpoints[index]?.replace(/\/+$/, "");
+      if (!endpoint) continue;
+      try {
+        const response = await fetch(`${endpoint}${path}`, {
+          method,
+          headers: method === "POST" ? { "content-type": "application/json" } : undefined,
+          body: method === "POST" ? JSON.stringify(body) : undefined,
+        });
+        if (!response.ok) {
+          throw new Error(`${method} ${path} failed (${response.status})`);
+        }
+        this.activeEndpointIndex = index;
+        this.activeEndpoint = endpoint;
+        this.lastError = null;
+        return response.json();
+      } catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        errors.push(`${endpoint}: ${message}`);
+        this.stats.signaling_errors += 1;
+        this.lastError = message;
+        this.lastErrorAt = Date.now();
+        this.reconnectAttemptsTotal += 1;
+        this.recordDiscovery("signaling_error", { endpoint, detail: message });
+      }
     }
-    return response.json();
+    throw new Error(errors.join(" | "));
   }
 }

package/packages/storage/dist/socialRuntimeRepo.js

@@ -18,7 +18,7 @@ function emptyRuntime() {
             adapter: "relay-preview",
             namespace: "silicaclaw.preview",
             port: null,
-            signaling_url: "http://localhost:4510",
+            signaling_url: "https://relay.silicaclaw.com",
             signaling_urls: [],
             room: "silicaclaw-global-preview",
             seed_peers: [],

package/packages/storage/src/socialRuntimeRepo.ts

@@ -17,7 +17,7 @@ function emptyRuntime(): SocialRuntimeConfig {
       adapter: "relay-preview",
       namespace: "silicaclaw.preview",
       port: null,
-      signaling_url: "http://localhost:4510",
+      signaling_url: "https://relay.silicaclaw.com",
       signaling_urls: [],
       room: "silicaclaw-global-preview",
       seed_peers: [],

package/scripts/quickstart.sh

@@ -359,9 +359,9 @@ case "$MODE_PICK" in
     NETWORK_MODE="global-preview"
     NETWORK_ADAPTER="relay-preview"
     PUBLIC_IP="$(detect_public_ip)"
-    SIGNALING_DEFAULT="${WEBRTC_SIGNALING_URL:-http://localhost:4510}"
+    SIGNALING_DEFAULT="${WEBRTC_SIGNALING_URL:-https://relay.silicaclaw.com}"
     if [ -n "$PUBLIC_IP" ]; then
-      SIGNALING_DEFAULT="http://$PUBLIC_IP:4510"
+      SIGNALING_DEFAULT="https://relay.silicaclaw.com"
     fi
     echo "提示: signaling 地址需要“所有节点可访问”。"
     if [ -n "$PUBLIC_IP" ]; then
@@ -369,7 +369,7 @@ case "$MODE_PICK" in
       echo "如果你这台机器就是 signaling 服务器，可直接回车使用默认值。"
     else
       echo "未检测到公网 IP，将使用默认值: $SIGNALING_DEFAULT"
-      echo "如果 signaling 在其他机器，请输入该机器公网地址。"
+      echo "如需私有 relay，可改成你自己的公网地址。"
     fi
     read -r -p "请输入 signaling URL（默认 ${SIGNALING_DEFAULT}）: " WEBRTC_SIGNALING_URL_INPUT || true
     WEBRTC_SIGNALING_URL_VALUE="${WEBRTC_SIGNALING_URL_INPUT:-$SIGNALING_DEFAULT}"