SynClaw logoSynClaw Docs
Sign inHome
OverviewHostingPublic WSSSelf-hostedModelFAQ
DocsHosting

Environment Variable Reference

Current env variables for OSS Public WSS mode and self-hosted deployment.

Core Convex variables

  • NEXT_PUBLIC_CONVEX_URL: client URL used by frontend to connect to Convex.
  • NEXT_PUBLIC_CONVEX_SITE_URL: Convex site URL used by auth callback flow.
  • CONVEX_DEPLOYMENT: deployment key mapping app to correct Convex environment.

Auth variables

  • AUTH_GITHUB_ID: GitHub OAuth client id.
  • AUTH_GITHUB_SECRET: GitHub OAuth client secret.
  • AUTH_GOOGLE_ID: Google OAuth client id.
  • AUTH_GOOGLE_SECRET: Google OAuth client secret.

Edition and feature flags

  • SYNCLAW_EDITION and NEXT_PUBLIC_SYNCLAW_EDITION: set to core for OSS/public mode.
  • SYNCLAW_ASSISTED_LAUNCH_ENABLED and NEXT_PUBLIC_ASSISTED_LAUNCH_BETA_ENABLED: internal/testing only.
  • NEXT_PUBLIC_OPENCLAW_FILES_ENABLED: enables remote filesystem bridge UI.
  • NEXT_PUBLIC_AGENT_SETUP_ADVANCED_ENABLED: controls advanced setup UI exposure.

OpenClaw token encryption key (Convex env)

  • OPENCLAW_TOKEN_ENCRYPTION_KEY_HEX: hex key used for encrypting gateway tokens at rest.

Generate and set key

openssl rand -hex 32
bunx convex env set OPENCLAW_TOKEN_ENCRYPTION_KEY_HEX <generated-hex-value>

Recommended OSS Public WSS profile

SYNCLAW_EDITION=core
NEXT_PUBLIC_SYNCLAW_EDITION=core
SYNCLAW_ASSISTED_LAUNCH_ENABLED=false
NEXT_PUBLIC_ASSISTED_LAUNCH_BETA_ENABLED=false
NEXT_PUBLIC_OPENCLAW_FILES_ENABLED=true
NEXT_PUBLIC_AGENT_SETUP_ADVANCED_ENABLED=false

Current launch profile

Keep assisted-launch flags disabled in OSS Public WSS mode.