Files
Claw3D/.env.example
2026-04-22 13:28:22 -05:00

116 lines
5.1 KiB
Bash

# Browser/client gateway URL (build-time — requires `npm run build` after changes)
NEXT_PUBLIC_GATEWAY_URL=ws://localhost:18789
# Runtime gateway URL — takes effect on restart without a rebuild.
# Use this instead of NEXT_PUBLIC_GATEWAY_URL when you want to change the
# gateway endpoint without re-running `npm run build`.
# CLAW3D_GATEWAY_URL=ws://localhost:18789
# CLAW3D_GATEWAY_TOKEN=
# Optional: tell Studio which backend that runtime gateway URL represents.
# Valid values: openclaw, hermes, demo, custom
# CLAW3D_GATEWAY_ADAPTER_TYPE=openclaw
# HERMES_API_URL=http://localhost:8642
# HERMES_API_KEY=change-me-local-dev
# HERMES_MODEL=hermes-agent
# Debug UI
DEBUG=true
# App server
# PORT=3000
# HOST=127.0.0.1
# Optional: required only for public/remote deployments
# STUDIO_ACCESS_TOKEN=
# Advanced only: some gateway-host operations can still use SSH, but marketplace skill install does not require it.
# OPENCLAW_GATEWAY_SSH_TARGET=
# OPENCLAW_GATEWAY_SSH_USER=
# OPENCLAW_GATEWAY_SSH_PORT=
# OPENCLAW_GATEWAY_SSH_STRICT_HOST_KEY_CHECKING=accept-new
# Hermes Agent adapter (alternative to OpenClaw)
# Run `npm run hermes-adapter` to start the adapter, then connect Claw3D to ws://localhost:18789
# HERMES_API_URL=http://localhost:8642
# HERMES_API_KEY=
# HERMES_ADAPTER_PORT=18789
# HERMES_MODEL=hermes
# HERMES_AGENT_NAME=Hermes
# If CLAW3D_GATEWAY_URL is unset, Studio can still detect this local adapter port.
# Demo gateway (no OpenClaw or Hermes required)
# Run `npm run demo-gateway` and connect Claw3D to ws://localhost:18789
# DEMO_ADAPTER_PORT=18789
# If CLAW3D_GATEWAY_URL is unset, Studio can still detect this local adapter port.
# Optional: voice features
# ELEVENLABS_API_KEY=
# ELEVENLABS_VOICE_ID=21m00Tcm4TlvDq8ikWAM
# ELEVENLABS_MODEL_ID=eleven_flash_v2_5
# Studio image-to-3D provider configuration
# Enable the self-hosted provider flow in /studio.
# CLAW3D_STUDIO_ENABLE_REAL_AI=true
# Worker/provider base URL consumed by the app route.
# CLAW3D_STUDIO_PROVIDER_URL=http://127.0.0.1:3333/openapi/v1
# Optional bearer token used by the app route.
# CLAW3D_STUDIO_PROVIDER_API_KEY=
# Studio AI worker runtime configuration
# Default mode is local_mock. Set upstream_openapi to delegate to an external backend.
# CLAW3D_STUDIO_WORKER_MODE=local_mock
# Real local upstream helper:
# 1. Run `npm run studio-ai-upstream-setup` once to create the Python environment.
# 2. Run `npm run studio-ai-upstream-local` to start the Hunyuan-based backend on 8080.
# Optional local upstream helper bind overrides.
# CLAW3D_STUDIO_LOCAL_UPSTREAM_HOST=127.0.0.1
# CLAW3D_STUDIO_LOCAL_UPSTREAM_PORT=8080
# Optional public base URL used in the local upstream task responses.
# CLAW3D_STUDIO_LOCAL_UPSTREAM_PUBLIC_URL=
# Real backend runtime knobs.
# CLAW3D_STUDIO_REAL_BACKEND_DEVICE=auto
# Quality-oriented defaults use the non-turbo Hunyuan models plus stronger conditioning.
# Lower these values only if the backend becomes too slow on your machine.
# CLAW3D_STUDIO_REAL_BACKEND_MODEL_ID_SINGLE=tencent/Hunyuan3D-2.1
# CLAW3D_STUDIO_REAL_BACKEND_SUBFOLDER_SINGLE=hunyuan3d-dit-v2-1
# CLAW3D_STUDIO_REAL_BACKEND_HUNYUAN21_SOURCE_ROOT=~/.cache/claw3d/Hunyuan3D-2.1
# CLAW3D_STUDIO_REAL_BACKEND_MODEL_ID_MULTI=tencent/Hunyuan3D-2mv
# CLAW3D_STUDIO_REAL_BACKEND_SUBFOLDER_MULTI=hunyuan3d-dit-v2-mv
# CLAW3D_STUDIO_REAL_BACKEND_NUM_INFERENCE_STEPS=30
# CLAW3D_STUDIO_REAL_BACKEND_GUIDANCE_SCALE=5.0
# CLAW3D_STUDIO_REAL_BACKEND_OCTREE_RESOLUTION=384
# CLAW3D_STUDIO_REAL_BACKEND_NUM_CHUNKS=20000
# CLAW3D_STUDIO_REAL_BACKEND_TARGET_IMAGE_SIZE=1024
# CLAW3D_STUDIO_REAL_BACKEND_CONDITION_PADDING_RATIO=0.12
# CLAW3D_STUDIO_REAL_BACKEND_REMOVE_BACKGROUND=true
# CLAW3D_STUDIO_REAL_BACKEND_ENABLE_FLASHVDM=true
# Enable the official CUDA-only Hunyuan paint/material pass when available.
# CLAW3D_STUDIO_REAL_BACKEND_ENABLE_TEXTURE_PIPELINE=true
# CLAW3D_STUDIO_REAL_BACKEND_TEXTURE_MAX_VIEWS=6
# CLAW3D_STUDIO_REAL_BACKEND_TEXTURE_RESOLUTION=512
# Upstream provider URL used when CLAW3D_STUDIO_WORKER_MODE=upstream_openapi.
# CLAW3D_STUDIO_UPSTREAM_PROVIDER_URL=http://127.0.0.1:8080/openapi/v1
# Optional worker timeout for long-running upstream jobs. Default is 45 minutes.
# CLAW3D_STUDIO_UPSTREAM_TIMEOUT_MS=2700000
# Optional bearer token sent from worker to upstream provider.
# CLAW3D_STUDIO_UPSTREAM_PROVIDER_API_KEY=
# Remote CUDA upstream example for Vast.ai.
# CLAW3D_STUDIO_WORKER_MODE=upstream_openapi
# CLAW3D_STUDIO_UPSTREAM_PROVIDER_URL=https://<vast-host>:<public-port>/openapi/v1
# CLAW3D_STUDIO_UPSTREAM_PROVIDER_API_KEY=<shared-token>
# Optional polling cadence and timeout for upstream task status.
# CLAW3D_STUDIO_UPSTREAM_POLL_INTERVAL_MS=1200
# CLAW3D_STUDIO_UPSTREAM_TIMEOUT_MS=480000
# Optional externally reachable base URL used in returned artifact URLs.
# CLAW3D_STUDIO_PROVIDER_PUBLIC_URL=
# Optional worker bind settings.
# CLAW3D_STUDIO_PROVIDER_HOST=127.0.0.1
# CLAW3D_STUDIO_PROVIDER_PORT=3333
# Remote real backend security/runtime options.
# Require a bearer token on the Python backend when exposed publicly.
# CLAW3D_STUDIO_REAL_BACKEND_API_KEY=
# Force NVIDIA execution on remote hosts when auto-detection is not enough.
# CLAW3D_STUDIO_REAL_BACKEND_DEVICE=cuda