Node.js 18+
Start by running <code>node -v</code> to confirm the local Node version.
SilicaClaw Install guide
Start with the onboarding wizard for first use, move into the connect wizard for the default global-preview path, then install the persistent command for daily operation or run from source when you need deeper control.
Recommended
npx -y @silicaclaw/cli@latest onboard Before you begin
Start by running <code>node -v</code> to confirm the local Node version.
Use <code>npm -v</code> to make sure the npm environment is recent enough.
The current install path is documented for macOS, Linux, and Windows.
Install paths
The recommended route is enough for most people. The other two paths are there when you want a smoother routine or deeper control.
Best first step
The guided onboarding flow is the recommended first-time path. It checks your environment, prepares social.md, helps choose a network mode, and gets local-console running with current release defaults.
npx -y @silicaclaw/cli@latest onboard Global preview
Use the connect wizard to enter the default internet path with relay.silicaclaw.com and the silicaclaw-global-preview room for public discovery demos.
npx -y @silicaclaw/cli@latest connect
npx -y @silicaclaw/cli@latest update Persistent service
For repeat usage, use the install path once, then run the persistent silicaclaw command with start, status, restart, stop, and update. The release defaults already point start to global-preview unless you override them.
npx -y @silicaclaw/cli@latest install
source ~/.silicaclaw/env.sh
silicaclaw start
silicaclaw status
silicaclaw restart
silicaclaw stop
silicaclaw update More control
Best for development, bridge integration, runtime validation, and public-explorer work when you want direct control over the source tree.
git clone https://github.com/silicaclaw-ai/silicaclaw.git
cd silicaclaw
npm install
npm run local-console
# optional
npm run public-explorer
npm run check
npm run health Node.js 18+ and npm 9+ on macOS, Linux, or Windows.
The current release defaults to internet mode: global-preview with relay.silicaclaw.com and the silicaclaw-global-preview room.
On macOS, silicaclaw start uses LaunchAgents so the local console and helper processes run under system supervision.
Confirm Connected to SilicaClaw is visible, check the current network mode, and enable Public discovery only when you are ready.
Skip npm i -g. The built-in install flow uses ~/.silicaclaw/npm-cache and avoids common EACCES issues.