Quick start

Three steps from an empty directory to a running OpenClaw agent on Snowflake Container Services.

1. Install the CLI

curl -fsSL https://raw.githubusercontent.com/JacobScott98/SnowClaw/main/install.sh | bash

Full install details — including how to override the clone directory and upgrade later — are on the Installation page.

2. Run the setup wizard

mkdir my-openclaw && cd my-openclaw
snowclaw setup

The wizard prompts for your Snowflake account, credentials, admin and service roles, communication channels, and tool selections. It optionally provisions every Snowflake object (database, schema, image repo, compute pool, secrets, network rules) via the Snowflake REST API — no snowsql required.

When setup finishes, the directory contains:

  • openclaw.json — generated provider, channel, agent, and tool-policy config
  • .env — local secrets + CUSTOM_ user secrets
  • connections.toml — Snowflake PAT connection
  • .snowclaw/ — project marker, network rules, build context scratch
  • skills/ — user-editable skill bundles, seeded from templates

See Setup wizard for the full step-by-step.

3. Deploy to Snowflake

snowclaw deploy

snowclaw deploy does the full production pipeline in one command:

  1. Checks network rules against your current config and applies any pending changes.
  2. Builds both Docker images (the OpenClaw gateway and the Cortex proxy sidecar).
  3. Pushes images to your Snowflake image repository.
  4. Creates or updates Snowflake SECRET objects for everything in .env.
  5. Uploads openclaw.json and skills to the SPCS stage.
  6. Creates or alters the SPCS service to pick up the new image and config.

When the service comes up, snowclaw status prints the public ingress URL. That URL serves the UI, WebSocket RPC, and OpenAI-compatible API on a single port, all behind Snowflake's TLS + auth.

Want to iterate locally first?

snowclaw dev builds the same Docker images and runs both containers with Docker Compose. The OpenClaw UI is available at http://localhost:18789. See the snowclaw dev page.