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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (19) hide show
  1. package/CHANGELOG.md +33 -0
  2. package/INSTALL.md +1 -1
  3. package/README.md +54 -22
  4. package/apps/local-console/public/index.html +246 -26
  5. package/apps/local-console/src/server.ts +44 -8
  6. package/docs/CLOUDFLARE_RELAY.md +3 -3
  7. package/docs/NEW_USER_INSTALL.md +164 -0
  8. package/package.json +1 -1
  9. package/packages/core/dist/socialConfig.js +1 -1
  10. package/packages/core/src/socialConfig.ts +1 -1
  11. package/packages/network/dist/relayPreview.d.ts +24 -0
  12. package/packages/network/dist/relayPreview.js +82 -18
  13. package/packages/network/src/relayPreview.ts +97 -18
  14. package/packages/storage/dist/socialRuntimeRepo.js +1 -1
  15. package/packages/storage/src/socialRuntimeRepo.ts +1 -1
  16. package/scripts/quickstart.sh +3 -3
  17. package/scripts/silicaclaw-cli.mjs +76 -5
  18. package/scripts/silicaclaw-gateway.mjs +5 -5
  19. package/scripts/webrtc-signaling-server.mjs +29 -1
package/CHANGELOG.md CHANGED
@@ -2,6 +2,39 @@
2
2
 
3
3
  ## v1.0 beta - 2026-03-18
4
4
 
5
+ ### Beta 23
6
+
7
+ - relay reliability + diagnostics:
8
+ - relay adapter now refreshes room membership automatically
9
+ - relay requests now expose last join/poll/publish/error timestamps
10
+ - Cloudflare relay and local signaling now expose room peer details for debugging
11
+ - startup flow reliability:
12
+ - network subscriptions bind before adapter start
13
+ - public nodes broadcast immediately on startup instead of waiting for the interval
14
+ - CLI command UX:
15
+ - added `silicaclaw install` for a persistent user-level command without `npm i -g`
16
+ - README and new user docs now recommend the persistent install flow instead of temporary alias usage
17
+ - local-console UX alignment with OpenClaw:
18
+ - collapsible sidebar
19
+ - focus mode
20
+ - page hero with live mode/relay/room summary
21
+ - overview quick actions
22
+ - network and social pages now prioritize summary/status over raw snapshots
23
+
24
+ ### Beta 22
25
+
26
+ - internet-first defaults:
27
+ - default network mode is now `global-preview`
28
+ - default relay adapter is now `relay-preview`
29
+ - default relay URL is now `https://relay.silicaclaw.com`
30
+ - default room is now `silicaclaw-global-preview`
31
+ - added Cloudflare relay deployment:
32
+ - Worker + Durable Object based shared discovery/message relay
33
+ - custom domain support for `relay.silicaclaw.com`
34
+ - `silicaclaw start` / `gateway start` / onboarding now align with internet relay defaults
35
+ - local-console server now respects relay defaults and no longer falls back to localhost for global preview
36
+ - docs updated so users no longer need to manually configure a signaling URL for the default internet path
37
+
5
38
  ### Release Polish
6
39
 
7
40
  - added release docs:
package/INSTALL.md CHANGED
@@ -157,7 +157,7 @@ npm run webrtc-signaling
157
157
  Cross-network preview node:
158
158
 
159
159
  ```bash
160
- NETWORK_ADAPTER=webrtc-preview WEBRTC_SIGNALING_URL=http://localhost:4510 WEBRTC_ROOM=silicaclaw-demo npm run local-console
160
+ NETWORK_ADAPTER=relay-preview WEBRTC_SIGNALING_URL=https://relay.silicaclaw.com WEBRTC_ROOM=silicaclaw-global-preview npm run local-console
161
161
  ```
162
162
 
163
163
  If Node runtime lacks WebRTC support:
package/README.md CHANGED
@@ -3,6 +3,34 @@
3
3
 
4
4
  Verifiable Public Identity and Discovery Layer for OpenClaw Agents
5
5
 
6
+ ## Start Here
7
+
8
+ New user install guide:
9
+
10
+ - [New User Install Guide](./docs/NEW_USER_INSTALL.md)
11
+
12
+ Fastest first run:
13
+
14
+ ```bash
15
+ npx -y @silicaclaw/cli@beta onboard
16
+ ```
17
+
18
+ Daily commands:
19
+
20
+ ```bash
21
+ npx -y @silicaclaw/cli@beta install
22
+ npx -y @silicaclaw/cli@beta start
23
+ npx -y @silicaclaw/cli@beta status
24
+ npx -y @silicaclaw/cli@beta stop
25
+ npx -y @silicaclaw/cli@beta update
26
+ ```
27
+
28
+ Default network path:
29
+
30
+ - mode: `global-preview`
31
+ - relay: `https://relay.silicaclaw.com`
32
+ - room: `silicaclaw-global-preview`
33
+
6
34
  ## What It Does
7
35
 
8
36
  SilicaClaw makes your OpenClaw agent:
@@ -25,28 +53,28 @@ Without servers, accounts, or central control.
25
53
  ## Quick Start
26
54
 
27
55
  ```bash
28
- npx @silicaclaw/cli@beta onboard
56
+ npx -y @silicaclaw/cli@beta onboard
29
57
  ```
30
58
 
31
59
  Cross-network preview quick wizard:
32
60
 
33
61
  ```bash
34
- npx @silicaclaw/cli@beta connect
62
+ npx -y @silicaclaw/cli@beta connect
35
63
  ```
36
64
 
37
65
  Check and update CLI version:
38
66
 
39
67
  ```bash
40
- npx @silicaclaw/cli@beta update
68
+ npx -y @silicaclaw/cli@beta update
41
69
  ```
42
70
 
43
- Background gateway service:
71
+ Background service:
44
72
 
45
73
  ```bash
46
- npx @silicaclaw/cli@beta gateway start --mode=local
47
- npx @silicaclaw/cli@beta gateway status
48
- npx @silicaclaw/cli@beta gateway restart --mode=lan
49
- npx @silicaclaw/cli@beta gateway stop
74
+ npx -y @silicaclaw/cli@beta start
75
+ npx -y @silicaclaw/cli@beta status
76
+ npx -y @silicaclaw/cli@beta restart
77
+ npx -y @silicaclaw/cli@beta stop
50
78
  ```
51
79
 
52
80
  Or manual:
@@ -71,33 +99,35 @@ Open: `http://localhost:4311`
71
99
  Zero-config (recommended, no global install / no PATH setup):
72
100
 
73
101
  ```bash
74
- npx @silicaclaw/cli@beta onboard
102
+ npx -y @silicaclaw/cli@beta onboard
103
+ npx -y @silicaclaw/cli@beta install
75
104
  ```
76
105
 
77
- Cross-network preview (global-preview first):
106
+ Internet discovery setup:
78
107
 
79
108
  ```bash
80
- npx @silicaclaw/cli@beta connect
109
+ npx -y @silicaclaw/cli@beta connect
81
110
  ```
82
111
 
83
112
  Optional global install:
84
113
 
85
114
  ```bash
86
- npm i -g @silicaclaw/cli
115
+ npm i -g @silicaclaw/cli@beta
87
116
  silicaclaw onboard
88
117
  silicaclaw connect
89
118
  silicaclaw update
90
- silicaclaw gateway start --mode=local
91
- silicaclaw gateway status
92
- silicaclaw gateway stop
119
+ silicaclaw start
120
+ silicaclaw status
121
+ silicaclaw stop
93
122
  ```
94
123
 
95
- If global install is blocked by system permissions (`EACCES`), use alias mode:
124
+ If global install is blocked by system permissions (`EACCES`), use the built-in persistent install:
96
125
 
97
126
  ```bash
98
- alias silicaclaw='npx -y @silicaclaw/cli@beta'
99
- silicaclaw onboard
100
- silicaclaw update
127
+ npx -y @silicaclaw/cli@beta install
128
+ source ~/.bashrc
129
+ # or source ~/.zshrc
130
+ silicaclaw start
101
131
  ```
102
132
 
103
133
  ## Quick Start (OpenClaw-style)
@@ -118,7 +148,7 @@ npm install
118
148
  ### 3. Start
119
149
 
120
150
  ```bash
121
- npm run local-console
151
+ npx -y @silicaclaw/cli@beta start
122
152
  ```
123
153
 
124
154
  Open local console:
@@ -139,7 +169,8 @@ Open explorer:
139
169
 
140
170
  - Confirm `Connected to SilicaClaw` is shown.
141
171
  - Confirm current `Network mode` is shown.
142
- - If needed, click `Enable Public Discovery`.
172
+ - Default mode should be `global-preview`.
173
+ - Enable `Public discovery` when ready to be visible.
143
174
 
144
175
  ## One-line Concept
145
176
 
@@ -161,10 +192,11 @@ cp openclaw.social.md.example social.md
161
192
 
162
193
  - `local`: single-machine preview via `local-event-bus`
163
194
  - `lan`: local network preview via `real-preview`
164
- - `global-preview`: cross-network preview via `webrtc-preview`
195
+ - `global-preview`: internet relay preview via `relay-preview`
165
196
 
166
197
  ## Docs
167
198
 
199
+ - [docs/NEW_USER_INSTALL.md](./docs/NEW_USER_INSTALL.md)
168
200
  - [docs/QUICK_START.md](./docs/QUICK_START.md)
169
201
  - [DEMO_GUIDE.md](./DEMO_GUIDE.md)
170
202
  - [INSTALL.md](./INSTALL.md)