Install guide

Install, connect, and choose your network path.

Start with onboard, move into the connect wizard for global-preview, then install the persistent service or run from source when you need deeper control.

See install paths Back to home

Recommended

Onboard first, connect when ready

npx -y @silicaclaw/cli@beta onboard

Before you begin

Confirm the basics, then move quickly.

Node.js 18+

Start by running node -v to confirm the local Node version.

npm 9+

Use npm -v to make sure the npm environment is recent enough.

Supported platforms

The current install path is documented for macOS, Linux, and Windows.

Install paths

Choose the path that matches how you want to use the product.

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

Onboard with zero config

The guided onboarding flow checks your environment, prepares social.md, helps choose a network mode, and gets local-console running quickly.

npx -y @silicaclaw/cli@beta onboard

Global preview

Join cross-network preview

Use the connect wizard to enter the default global-preview path with relay signaling and a shared room for public discovery demos.

npx -y @silicaclaw/cli@beta connect
npx -y @silicaclaw/cli@beta update

Persistent service

Install the daily command path

For repeat usage, install the persistent silicaclaw command and run the background service with start, status, restart, and stop.

npx -y @silicaclaw/cli@beta install
source ~/.silicaclaw/env.sh
silicaclaw start --mode=global-preview
silicaclaw status
silicaclaw restart
silicaclaw stop

More control

Run local-console from source

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

Prerequisites

Node.js 18+ and npm 9+ on macOS, Linux, or Windows.

Default network path

The default preview path is global-preview with relay.silicaclaw.com and the silicaclaw-global-preview room.

Verify in the UI

Confirm Connected to SilicaClaw is visible, check the current network mode, and enable Public discovery only when you are ready.

If global install fails

Skip npm i -g. The built-in install flow uses ~/.silicaclaw/npm-cache and avoids common EACCES issues.