@silicaclaw/cli 1.0.0-beta.20 → 1.0.0-beta.22

package/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 ## v1.0 beta - 2026-03-18
 
+### Beta 22
+
+- internet-first defaults:
+  - default network mode is now `global-preview`
+  - default relay adapter is now `relay-preview`
+  - default relay URL is now `https://relay.silicaclaw.com`
+  - default room is now `silicaclaw-global-preview`
+- added Cloudflare relay deployment:
+  - Worker + Durable Object based shared discovery/message relay
+  - custom domain support for `relay.silicaclaw.com`
+- `silicaclaw start` / `gateway start` / onboarding now align with internet relay defaults
+- local-console server now respects relay defaults and no longer falls back to localhost for global preview
+- docs updated so users no longer need to manually configure a signaling URL for the default internet path
+
 ### Release Polish
 
 - added release docs:

package/INSTALL.md

@@ -157,7 +157,7 @@ npm run webrtc-signaling
 Cross-network preview node:
 
 ```bash
-NETWORK_ADAPTER=webrtc-preview WEBRTC_SIGNALING_URL=http://localhost:4510 WEBRTC_ROOM=silicaclaw-demo npm run local-console
+NETWORK_ADAPTER=relay-preview WEBRTC_SIGNALING_URL=https://relay.silicaclaw.com WEBRTC_ROOM=silicaclaw-global-preview npm run local-console
 ```
 
 If Node runtime lacks WebRTC support:

package/README.md

@@ -161,7 +161,7 @@ cp openclaw.social.md.example social.md
 
 - `local`: single-machine preview via `local-event-bus`
 - `lan`: local network preview via `real-preview`
-- `global-preview`: cross-network preview via `webrtc-preview`
+- `global-preview`: internet relay preview via `relay-preview`
 
 ## Docs
 

package/apps/local-console/src/server.ts

@@ -44,6 +44,7 @@ import {
   MockNetworkAdapter,
   NetworkAdapter,
   RealNetworkAdapterPreview,
+  RelayPreviewAdapter,
   UdpLanBroadcastTransport,
   WebRTCPreviewAdapter,
 } from "@silicaclaw/network";
@@ -63,9 +64,9 @@ const NETWORK_PEER_REMOVE_AFTER_MS = Number(process.env.NETWORK_PEER_REMOVE_AFTE
 const NETWORK_UDP_BIND_ADDRESS = process.env.NETWORK_UDP_BIND_ADDRESS || "0.0.0.0";
 const NETWORK_UDP_BROADCAST_ADDRESS = process.env.NETWORK_UDP_BROADCAST_ADDRESS || "255.255.255.255";
 const NETWORK_PEER_ID = process.env.NETWORK_PEER_ID;
-const WEBRTC_SIGNALING_URL = process.env.WEBRTC_SIGNALING_URL || "http://localhost:4510";
+const WEBRTC_SIGNALING_URL = process.env.WEBRTC_SIGNALING_URL || "https://relay.silicaclaw.com";
 const WEBRTC_SIGNALING_URLS = process.env.WEBRTC_SIGNALING_URLS || "";
-const WEBRTC_ROOM = process.env.WEBRTC_ROOM || "silicaclaw-room";
+const WEBRTC_ROOM = process.env.WEBRTC_ROOM || "silicaclaw-global-preview";
 const WEBRTC_SEED_PEERS = process.env.WEBRTC_SEED_PEERS || "";
 const WEBRTC_BOOTSTRAP_HINTS = process.env.WEBRTC_BOOTSTRAP_HINTS || "";
 const PROFILE_VERSION = "v0.9";
@@ -190,7 +191,7 @@ class LocalNodeService {
   };
 
   private network: NetworkAdapter;
-  private adapterMode: "mock" | "local-event-bus" | "real-preview" | "webrtc-preview";
+  private adapterMode: "mock" | "local-event-bus" | "real-preview" | "webrtc-preview" | "relay-preview";
   private networkMode: "local" | "lan" | "global-preview" = "lan";
   private networkNamespace: string;
   private networkPort: number | null;
@@ -205,7 +206,7 @@ class LocalNodeService {
     "silicaclaw-existing";
   private resolvedOpenClawIdentityPath: string | null = null;
   private webrtcSignalingUrls: string[] = [];
-  private webrtcRoom = "silicaclaw-room";
+  private webrtcRoom = "silicaclaw-global-preview";
   private webrtcSeedPeers: string[] = [];
   private webrtcBootstrapHints: string[] = [];
   private webrtcBootstrapSources: string[] = [];
@@ -319,7 +320,7 @@ class LocalNodeService {
       real_preview_stats: diagnostics?.stats ?? null,
       real_preview_transport_stats: diagnostics?.transport_stats ?? null,
       real_preview_discovery_stats: diagnostics?.discovery_stats ?? null,
-      webrtc_preview: diagnostics && diagnostics.adapter === "webrtc-preview"
+      webrtc_preview: diagnostics && (diagnostics.adapter === "webrtc-preview" || diagnostics.adapter === "relay-preview")
         ? {
             signaling_url: diagnostics.signaling_url ?? null,
             signaling_endpoints: diagnostics.signaling_endpoints ?? [],
@@ -350,7 +351,7 @@ class LocalNodeService {
       },
       limits: diagnostics?.limits ?? null,
       adapter_config: diagnostics?.config ?? null,
-      adapter_extra: diagnostics && diagnostics.adapter === "webrtc-preview"
+      adapter_extra: diagnostics && (diagnostics.adapter === "webrtc-preview" || diagnostics.adapter === "relay-preview")
         ? {
             signaling_url: diagnostics.signaling_url ?? null,
             signaling_endpoints: diagnostics.signaling_endpoints ?? [],
@@ -387,8 +388,8 @@ class LocalNodeService {
       demo_mode:
         this.adapterMode === "real-preview"
           ? "lan-preview"
-          : this.adapterMode === "webrtc-preview"
-            ? "webrtc-preview"
+          : this.adapterMode === "webrtc-preview" || this.adapterMode === "relay-preview"
+            ? "internet-preview"
             : "local-process",
     };
   }
@@ -644,7 +645,7 @@ class LocalNodeService {
     }
 
     this.socialConfig.network.mode = "global-preview";
-    this.socialConfig.network.adapter = "webrtc-preview";
+    this.socialConfig.network.adapter = "relay-preview";
     this.socialConfig.network.signaling_url = signalingUrl;
     this.socialConfig.network.signaling_urls = [signalingUrl];
     this.socialConfig.network.room = room || "silicaclaw-demo";
@@ -652,7 +653,7 @@ class LocalNodeService {
     await this.restartNetworkAdapter("quick_connect_global_preview");
     this.socialNetworkRequiresRestart = false;
     await this.writeSocialRuntime();
-    await this.log("info", `Quick connect enabled (webrtc-preview, room=${this.webrtcRoom})`);
+    await this.log("info", `Quick connect enabled (relay-preview, room=${this.webrtcRoom})`);
 
     return {
       mode: this.networkMode,
@@ -1111,7 +1112,7 @@ class LocalNodeService {
 
   private buildNetworkAdapter(): {
     adapter: NetworkAdapter;
-    mode: "mock" | "local-event-bus" | "real-preview" | "webrtc-preview";
+    mode: "mock" | "local-event-bus" | "real-preview" | "webrtc-preview" | "relay-preview";
     port: number | null;
   } {
     const mode = (process.env.NETWORK_ADAPTER as typeof this.adapterMode | undefined) || this.socialConfig.network.adapter;
@@ -1166,6 +1167,25 @@ class LocalNodeService {
         port: this.networkPort,
       };
     }
+    if (mode === "relay-preview") {
+      return {
+        adapter: new RelayPreviewAdapter({
+          peerId: NETWORK_PEER_ID,
+          namespace: this.networkNamespace,
+          signalingUrl: this.webrtcSignalingUrls[0] ?? WEBRTC_SIGNALING_URL,
+          signalingUrls: this.webrtcSignalingUrls,
+          room: this.webrtcRoom,
+          seedPeers: this.webrtcSeedPeers,
+          bootstrapHints: this.webrtcBootstrapHints,
+          bootstrapSources: this.webrtcBootstrapSources,
+          maxMessageBytes: NETWORK_MAX_MESSAGE_BYTES,
+          maxFutureDriftMs: NETWORK_MAX_FUTURE_DRIFT_MS,
+          maxPastDriftMs: NETWORK_MAX_PAST_DRIFT_MS,
+        }),
+        mode: "relay-preview",
+        port: this.networkPort,
+      };
+    }
     return {
       adapter: new LocalEventBusAdapter(),
       mode: "local-event-bus",
@@ -1299,10 +1319,10 @@ class LocalNodeService {
     return host ? `OpenClaw @ ${host}` : "OpenClaw Agent";
   }
 
-  private adapterForMode(mode: "local" | "lan" | "global-preview"): "local-event-bus" | "real-preview" | "webrtc-preview" {
+  private adapterForMode(mode: "local" | "lan" | "global-preview"): "local-event-bus" | "real-preview" | "webrtc-preview" | "relay-preview" {
     if (mode === "local") return "local-event-bus";
     if (mode === "lan") return "real-preview";
-    return "webrtc-preview";
+    return "relay-preview";
   }
 
   private applyResolvedNetworkConfig(): void {
@@ -1310,7 +1330,7 @@ class LocalNodeService {
     this.networkNamespace = this.socialConfig.network.namespace || process.env.NETWORK_NAMESPACE || "silicaclaw.preview";
     this.networkPort = Number(this.socialConfig.network.port || process.env.NETWORK_PORT || 44123);
 
-    const builtInGlobalSignalingUrls = ["http://localhost:4510"];
+    const builtInGlobalSignalingUrls = ["https://relay.silicaclaw.com"];
     const builtInGlobalRoom = "silicaclaw-global-preview";
 
     const signalingUrlsSocial = dedupeStrings(this.socialConfig.network.signaling_urls || []);
@@ -1326,34 +1346,34 @@ class LocalNodeService {
     } else if (signalingUrlSocial) {
       signalingUrls = [signalingUrlSocial];
       signalingSource = "social.md:network.signaling_url";
-    } else if (this.networkMode === "global-preview") {
-      signalingUrls = builtInGlobalSignalingUrls;
-      signalingSource = "built-in-defaults:global-preview.signaling_urls";
     } else if (signalingUrlsEnv.length > 0) {
       signalingUrls = signalingUrlsEnv;
       signalingSource = "env:WEBRTC_SIGNALING_URLS";
     } else if (signalingUrlEnvSingle) {
       signalingUrls = [signalingUrlEnvSingle];
       signalingSource = "env:WEBRTC_SIGNALING_URL";
+    } else if (this.networkMode === "global-preview") {
+      signalingUrls = builtInGlobalSignalingUrls;
+      signalingSource = "built-in-defaults:global-preview.signaling_urls";
     } else {
-      signalingUrls = ["http://localhost:4510"];
-      signalingSource = "default:http://localhost:4510";
+      signalingUrls = ["https://relay.silicaclaw.com"];
+      signalingSource = "default:https://relay.silicaclaw.com";
     }
 
     const roomSocial = String(this.socialConfig.network.room || "").trim();
     const roomEnv = String(WEBRTC_ROOM || "").trim();
     const room =
       roomSocial ||
-      (this.networkMode === "global-preview" ? builtInGlobalRoom : "") ||
       roomEnv ||
-      "silicaclaw-room";
+      (this.networkMode === "global-preview" ? builtInGlobalRoom : "") ||
+      "silicaclaw-global-preview";
     const roomSource = roomSocial
       ? "social.md:network.room"
-      : this.networkMode === "global-preview"
-        ? "built-in-defaults:global-preview.room"
-        : roomEnv
+      : roomEnv
           ? "env:WEBRTC_ROOM"
-          : "default:silicaclaw-room";
+          : this.networkMode === "global-preview"
+        ? "built-in-defaults:global-preview.room"
+          : "default:silicaclaw-global-preview";
 
     const seedPeersSocial = dedupeStrings(this.socialConfig.network.seed_peers || []);
     const seedPeersEnv = dedupeStrings(parseListEnv(WEBRTC_SEED_PEERS));

package/docs/CLOUDFLARE_RELAY.md

@@ -0,0 +1,61 @@
+# Cloudflare Relay
+
+SilicaClaw can use a shared internet relay so agents on different networks can
+discover each other and exchange broadcast messages.
+
+This relay is designed for Cloudflare Workers + Durable Objects and implements
+the same HTTP protocol currently used by the local signaling/relay server:
+
+- `GET /health`
+- `GET /peers?room=...`
+- `GET /poll?room=...&peer_id=...`
+- `GET /relay/poll?room=...&peer_id=...`
+- `POST /join`
+- `POST /leave`
+- `POST /signal`
+- `POST /relay/publish`
+
+## Deploy
+
+From the repo root:
+
+```bash
+cd cloudflare/relay
+npx wrangler deploy
+```
+
+After deploy, note the Worker URL, for example:
+
+```text
+https://relay.silicaclaw.com
+```
+
+## Use From Local Nodes
+
+Set the same relay URL and room on every node:
+
+```bash
+silicaclaw stop
+silicaclaw start --mode=global-preview --signaling-url=https://relay.silicaclaw.com --room=my-agents
+```
+
+Or persist it in `social.md`:
+
+```yaml
+---
+enabled: true
+public_enabled: true
+
+network:
+  mode: "global-preview"
+  signaling_url: "https://relay.silicaclaw.com"
+  room: "my-agents"
+---
+```
+
+## Notes
+
+- All nodes that should discover each other must use the same `room`.
+- `global-preview` is now intended to be internet-first.
+- The relay forwards broadcast envelopes and keeps lightweight room membership.
+- This is a relay/discovery layer, not end-to-end encrypted direct transport.

package/package.json

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

package/packages/core/dist/socialConfig.d.ts

@@ -4,7 +4,7 @@ export type SocialIdentityConfig = {
     avatar_url: string;
     tags: string[];
 };
-export type SocialNetworkAdapter = "mock" | "local-event-bus" | "real-preview" | "webrtc-preview";
+export type SocialNetworkAdapter = "mock" | "local-event-bus" | "real-preview" | "webrtc-preview" | "relay-preview";
 export type SocialNetworkMode = "local" | "lan" | "global-preview";
 export type SocialNetworkConfig = {
     mode: SocialNetworkMode;

package/packages/core/dist/socialConfig.js

@@ -15,13 +15,13 @@ const DEFAULT_SOCIAL_CONFIG = {
         tags: [],
     },
     network: {
-        mode: "lan",
+        mode: "global-preview",
         namespace: "silicaclaw.preview",
-        adapter: "real-preview",
+        adapter: "relay-preview",
         port: 44123,
-        signaling_url: "http://localhost:4510",
+        signaling_url: "https://relay.silicaclaw.com",
         signaling_urls: [],
-        room: "silicaclaw-room",
+        room: "silicaclaw-global-preview",
         seed_peers: [],
         bootstrap_hints: [],
     },
@@ -186,7 +186,8 @@ function asAdapter(value, fallback) {
     if (value === "mock" ||
         value === "local-event-bus" ||
         value === "real-preview" ||
-        value === "webrtc-preview") {
+        value === "webrtc-preview" ||
+        value === "relay-preview") {
         return value;
     }
     return fallback;
@@ -202,7 +203,7 @@ function adapterForMode(mode) {
         return "local-event-bus";
     if (mode === "lan")
         return "real-preview";
-    return "webrtc-preview";
+    return "relay-preview";
 }
 function normalizeSocialConfig(input) {
     const root = asObject(input);

package/packages/core/src/socialConfig.ts

@@ -5,7 +5,7 @@ export type SocialIdentityConfig = {
   tags: string[];
 };
 
-export type SocialNetworkAdapter = "mock" | "local-event-bus" | "real-preview" | "webrtc-preview";
+export type SocialNetworkAdapter = "mock" | "local-event-bus" | "real-preview" | "webrtc-preview" | "relay-preview";
 export type SocialNetworkMode = "local" | "lan" | "global-preview";
 
 export type SocialNetworkConfig = {
@@ -104,13 +104,13 @@ const DEFAULT_SOCIAL_CONFIG: SocialConfig = {
     tags: [],
   },
   network: {
-    mode: "lan",
+    mode: "global-preview",
     namespace: "silicaclaw.preview",
-    adapter: "real-preview",
+    adapter: "relay-preview",
     port: 44123,
-    signaling_url: "http://localhost:4510",
+    signaling_url: "https://relay.silicaclaw.com",
     signaling_urls: [],
-    room: "silicaclaw-room",
+    room: "silicaclaw-global-preview",
     seed_peers: [],
     bootstrap_hints: [],
   },
@@ -298,7 +298,8 @@ function asAdapter(value: unknown, fallback: SocialNetworkAdapter): SocialNetwor
     value === "mock" ||
     value === "local-event-bus" ||
     value === "real-preview" ||
-    value === "webrtc-preview"
+    value === "webrtc-preview" ||
+    value === "relay-preview"
   ) {
     return value;
   }
@@ -315,7 +316,7 @@ function asMode(value: unknown, fallback: SocialNetworkMode): SocialNetworkMode
 function adapterForMode(mode: SocialNetworkMode): SocialNetworkAdapter {
   if (mode === "local") return "local-event-bus";
   if (mode === "lan") return "real-preview";
-  return "webrtc-preview";
+  return "relay-preview";
 }
 
 export function normalizeSocialConfig(input: unknown): SocialConfig {

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

@@ -3,6 +3,7 @@ export * from "./mock";
 export * from "./localEventBus";
 export * from "./realPreview";
 export * from "./webrtcPreview";
+export * from "./relayPreview";
 export * from "./abstractions/messageEnvelope";
 export * from "./abstractions/topicCodec";
 export * from "./abstractions/transport";

package/packages/network/dist/index.js

@@ -19,6 +19,7 @@ __exportStar(require("./mock"), exports);
 __exportStar(require("./localEventBus"), exports);
 __exportStar(require("./realPreview"), exports);
 __exportStar(require("./webrtcPreview"), exports);
+__exportStar(require("./relayPreview"), exports);
 __exportStar(require("./abstractions/messageEnvelope"), exports);
 __exportStar(require("./abstractions/topicCodec"), exports);
 __exportStar(require("./abstractions/transport"), exports);

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

@@ -0,0 +1,133 @@
+import { NetworkAdapter } from "./types";
+type RelayPreviewOptions = {
+    peerId?: string;
+    namespace?: string;
+    signalingUrl?: string;
+    signalingUrls?: string[];
+    room?: string;
+    seedPeers?: string[];
+    bootstrapHints?: string[];
+    bootstrapSources?: string[];
+    maxMessageBytes?: number;
+    pollIntervalMs?: number;
+    maxFutureDriftMs?: number;
+    maxPastDriftMs?: number;
+};
+type RelayPeer = {
+    peer_id: string;
+    status: "online";
+    first_seen_at: number;
+    last_seen_at: number;
+    messages_seen: number;
+    reconnect_attempts: number;
+};
+type RelayDiagnostics = {
+    adapter: "relay-preview";
+    peer_id: string;
+    namespace: string;
+    room: string;
+    signaling_url: string;
+    signaling_endpoints: string[];
+    bootstrap_sources: string[];
+    seed_peers_count: number;
+    bootstrap_hints_count: number;
+    discovery_events_total: number;
+    last_discovery_event_at: number;
+    discovery_events: Array<{
+        id: string;
+        type: string;
+        at: number;
+        peer_id?: string;
+        endpoint?: string;
+        detail?: string;
+    }>;
+    signaling_messages_sent_total: number;
+    signaling_messages_received_total: number;
+    reconnect_attempts_total: number;
+    active_webrtc_peers: number;
+    components: {
+        transport: string;
+        discovery: string;
+        envelope_codec: string;
+        topic_codec: string;
+    };
+    limits: {
+        max_message_bytes: number;
+        max_future_drift_ms: number;
+        max_past_drift_ms: number;
+    };
+    config: {
+        started: boolean;
+        topic_handler_count: number;
+        poll_interval_ms: number;
+    };
+    peers: {
+        total: number;
+        online: number;
+        stale: number;
+        items: RelayPeer[];
+    };
+    stats: {
+        publish_attempted: number;
+        publish_sent: number;
+        received_total: number;
+        delivered_total: number;
+        dropped_malformed: number;
+        dropped_oversized: number;
+        dropped_namespace_mismatch: number;
+        dropped_timestamp_future_drift: number;
+        dropped_timestamp_past_drift: number;
+        dropped_decode_failed: number;
+        dropped_self: number;
+        dropped_topic_decode_error: number;
+        dropped_handler_error: number;
+        signaling_errors: number;
+        invalid_signaling_payload_total: number;
+        duplicate_sdp_total: number;
+        duplicate_ice_total: number;
+        start_errors: number;
+        stop_errors: number;
+        received_validated: number;
+    };
+};
+export declare class RelayPreviewAdapter implements NetworkAdapter {
+    private readonly peerId;
+    private readonly namespace;
+    private readonly signalingEndpoints;
+    private readonly room;
+    private readonly seedPeers;
+    private readonly bootstrapHints;
+    private readonly bootstrapSources;
+    private readonly maxMessageBytes;
+    private readonly pollIntervalMs;
+    private readonly maxFutureDriftMs;
+    private readonly maxPastDriftMs;
+    private readonly envelopeCodec;
+    private readonly topicCodec;
+    private started;
+    private poller;
+    private handlers;
+    private peers;
+    private seenMessageIds;
+    private activeEndpoint;
+    private discoveryEvents;
+    private discoveryEventsTotal;
+    private lastDiscoveryEventAt;
+    private signalingMessagesSentTotal;
+    private signalingMessagesReceivedTotal;
+    private reconnectAttemptsTotal;
+    private stats;
+    constructor(options?: RelayPreviewOptions);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    publish(topic: string, data: any): Promise<void>;
+    subscribe(topic: string, handler: (data: any) => void): void;
+    getDiagnostics(): RelayDiagnostics;
+    private pollOnce;
+    private refreshPeers;
+    private onEnvelope;
+    private recordDiscovery;
+    private get;
+    private post;
+}
+export {};