Environment Variables

A complete reference of all environment variables used by InnoClaw.

Core Configuration

Variable	Type	Required	Default	Description
WORKSPACE_ROOTS	string	Yes	—	Comma-separated absolute paths where workspaces can be created. Directories must exist on the server.
DATABASE_URL	string	No	./data/innoclaw.db	SQLite database filesystem path. Set to a local path when the project resides on NFS or another network filesystem.
AUTH_SECRET	string	Recommended	Development fallback	Long random secret used to sign local authentication session cookies. Set this in production.
AUTH_MODE	string	No	local	Authentication mode. Set to disabled only for trusted local or single-user deployments to bypass registration/login and grant every request admin-level access.
AUTH_SINGLE_ADMIN	boolean	No	false	When true, requires exactly one bootstrapped active administrator. Public registration can create ordinary users only, and administrator role mutation is disabled. Values are strictly true or false.
AUTH_COOKIE_SECURE	boolean	No	true in production	Overrides the Secure attribute on authentication cookies. Set to false only during a temporary plain-HTTP rollout. Values are strictly true or false.
NEXT_BUILD_DIR	string	No	.next	Next.js build output directory inside the project root (for example .next-local). On Next.js 16 / Turbopack this cannot point outside the repo.

With AUTH_SINGLE_ADMIN=true, run the administrator bootstrap command before opening public registration. Ordinary users receive private roots at <WORKSPACE_ROOTS entry>/users/<immutable-user-id>; the administrator retains visibility across the configured operator roots.

AI Provider Configuration

Variable	Type	Required	Default	Description
OPENAI_API_KEY	string	No	—	OpenAI API key for chat and embedding.
ANTHROPIC_API_KEY	string	No	—	Anthropic API key for Claude models.
GEMINI_API_KEY	string	No	—	Google Gemini API key for Gemini models.
SHLAB_API_KEY	string	No	—	SH-Lab API key for Intern models.
QWEN_API_KEY	string	No	—	Qwen API key.
MOONSHOT_API_KEY	string	No	—	Moonshot API key for Kimi models.
DEEPSEEK_API_KEY	string	No	—	DeepSeek API key.
MINIMAX_API_KEY	string	No	—	MiniMax API key.
ZHIPU_API_KEY	string	No	—	Zhipu API key for GLM models.
OPENAI_BASE_URL	string	No	https://api.openai.com/v1	Custom OpenAI-compatible API endpoint (for proxies or third-party providers).
ANTHROPIC_BASE_URL	string	No	https://api.anthropic.com	Custom Anthropic API endpoint.
GEMINI_BASE_URL	string	No	—	Custom Gemini-compatible API endpoint (OpenAI-compatible proxy).
SHLAB_BASE_URL	string	No	—	Vendor-level base URL for all SH-Lab models. Per-model URLs (e.g. SHLAB_INTERN_S1_PRO_BASE_URL) take priority.
QWEN_BASE_URL	string	No	—	Vendor-level base URL for all Qwen models. Per-model URLs (e.g. QWEN_QWEN3_235B_BASE_URL) take priority.
MOONSHOT_BASE_URL	string	No	—	Vendor-level base URL for all Moonshot models. Per-model URLs (e.g. MOONSHOT_KIMI_K2_5_BASE_URL) take priority.
DEEPSEEK_BASE_URL	string	No	—	Vendor-level base URL for all DeepSeek models. Per-model URLs (e.g. DEEPSEEK_DEEPSEEK_V3_2_BASE_URL) take priority.
MINIMAX_BASE_URL	string	No	—	Vendor-level base URL for all MiniMax models. Per-model URLs (e.g. MINIMAX_MINIMAX2_5_BASE_URL) take priority.
ZHIPU_BASE_URL	string	No	—	Vendor-level base URL for all Zhipu models. Per-model URLs (e.g. ZHIPU_GLM_5_BASE_URL) take priority.
LLM_PROVIDER	string	No	openai	Default LLM provider: openai, anthropic, or gemini. Overridable in Settings UI.
LLM_MODEL	string	No	gpt-4o-mini	Default model ID. Overridable in Settings UI.
OPENAI_REASONING_EFFORT	string	No	Provider default	Default reasoning effort for OpenAI language-model calls: none, minimal, low, medium, high, or xhigh. Input is trimmed and case-normalized; ultra is accepted as an alias for xhigh. Invalid values fail explicitly.

:::{note} At least one AI API key (OpenAI, Anthropic, or Gemini) is needed for AI chat and note generation features. Without any API key, workspace management, file browsing, and other non-AI features still work. :::

OPENAI_REASONING_EFFORT applies only to OpenAI language-model calls and the unknown-provider OpenAI-compatible fallback. It does not alter embeddings or named Anthropic, Gemini, Qwen, Moonshot, DeepSeek, MiniMax, Zhipu, or SH-Lab providers. Omit it to preserve the upstream provider default. Confirm that a custom OpenAI-compatible endpoint supports the normalized value before rollout.

Agent Configuration

Variable	Type	Required	Default	Description
AGENT_MAX_STEPS	number	No	10	Maximum agent tool-call steps per request (1–100). Higher values allow complex multi-step tasks but cost more tokens.

Embedding API Configuration

These allow using a separate service for vector embeddings, independent of the chat model provider.

Variable	Type	Required	Default	Description
EMBEDDING_API_KEY	string	No	Falls back to OPENAI_API_KEY	API key for the embedding service.
EMBEDDING_BASE_URL	string	No	Falls back to OPENAI_BASE_URL	Endpoint for the embedding service.
EMBEDDING_MODEL	string	No	text-embedding-3-small	Name of the embedding model to use.

Example — Using a dedicated embedding service:

# Chat model (via OpenAI-compatible proxy)
OPENAI_API_KEY=sk-your-chat-key
OPENAI_BASE_URL=http://your-proxy:3888/v1

# Embedding model (separate configuration)
EMBEDDING_API_KEY=sk-your-embedding-key
EMBEDDING_BASE_URL=http://your-proxy:3888/v1
EMBEDDING_MODEL=google/gemini-embedding-001

GitHub Integration

Variable	Type	Required	Default	Description
GITHUB_TOKEN	string	No	—	GitHub Personal Access Token for cloning/pulling private repositories. Requires repo scope.

HuggingFace / ModelScope Datasets

Variable	Type	Required	Default	Description
HF_TOKEN	string	No	—	HuggingFace access token. Avoids rate limits when downloading datasets. Also settable via the Settings UI.
HF_DATASETS_PATH	string	No	./data/hf-datasets	Local directory for downloaded HuggingFace/ModelScope datasets.

SCP Hub (Scientific Skills)

Variable	Type	Required	Default	Description
SCP_HUB_API_KEY	string	No	—	API key for the Intern-Discovery Platform, enabling 206 built-in SCP scientific skills (drug discovery, protein analysis, genomics, chemistry, etc.).

HTTP Proxy

Variable	Type	Required	Default	Description
HTTP_PROXY	string	No	—	HTTP proxy for all outbound fetch() calls (AI API, GitHub, etc.).
HTTPS_PROXY	string	No	—	HTTPS proxy. Typically the same value as HTTP_PROXY.
NO_PROXY	string	No	—	Comma-separated hosts/CIDRs that bypass the proxy, e.g. localhost,127.0.0.1,10.0.0.0/8.

Feishu (Lark) Bot Configuration

Variable	Type	Required	Default	Description
FEISHU_BOT_ENABLED	boolean	No	false	Enable Feishu bot integration.
FEISHU_APP_ID	string	No	—	Feishu application ID.
FEISHU_APP_SECRET	string	No	—	Feishu application secret.
FEISHU_VERIFICATION_TOKEN	string	No	—	Token for verifying Feishu webhook requests.
FEISHU_ENCRYPT_KEY	string	No	—	Encryption key for Feishu event payloads.
FEISHU_PUSH_SECRET	string	No	—	Shared secret for authenticating the push API (/api/bot/feishu/push). Required for web-to-Feishu message forwarding.
FEISHU_LOG_LEVEL	string	No	info	SDK log verbosity: error, warn, info, debug, trace.

WeChat Enterprise Bot Configuration

Variable	Type	Required	Default	Description
WECHAT_BOT_ENABLED	boolean	No	false	Enable WeChat Enterprise bot integration.
WECHAT_CORP_ID	string	No	—	WeChat Enterprise corporation ID.
WECHAT_CORP_SECRET	string	No	—	WeChat Enterprise application secret.
WECHAT_TOKEN	string	No	—	Token for verifying WeChat webhook requests.
WECHAT_ENCODING_AES_KEY	string	No	—	AES key for encrypting/decrypting WeChat messages.
WECHAT_AGENT_ID	string	No	—	WeChat Enterprise agent (application) ID.

Kubernetes / Cluster Integration

Variable	Type	Required	Default	Description
KUBECONFIG_PATH	string	No	—	Path to the kubeconfig file used by generic Kubernetes Job tools.
K8S_CONTEXT	string	No	—	Kubeconfig context used by the generic Job profile fallback.
K8S_DEFAULT_NAMESPACE	string	No	default	Default namespace for the generic Job profile fallback.
K8S_ALLOWED_NAMESPACES	string	No	K8S_DEFAULT_NAMESPACE	Comma-separated namespace allow-list for generic Job tools.
K8S_JOB_DEFAULT_IMAGE	string	No	—	Default image for the generic Job profile fallback.
K8S_JOB_PROFILE_ID	string	No	default	Profile id used when env vars create the fallback profile.
K8S_JOB_PROFILES_FILE	string	No	—	Path to a private local JSON file containing generic clusters and Job profiles.
K8S_JOB_PROFILES_JSON	string	No	—	Inline JSON config for generic clusters and Job profiles. Use a file for private local values.

Security Notes

• All API keys and tokens are used server-side only and are never exposed to the browser client.
• AUTH_MODE=disabled removes application-level authentication. Anyone who can reach the service gets admin-level access, so use it only behind trusted local access or another access-control layer.
• AUTH_SINGLE_ADMIN=true fails closed until the administrator bootstrap has completed. Do not expose registration before that step.
• AUTH_COOKIE_SECURE=false only permits cookies over plain HTTP. It does not encrypt login credentials, session cookies, or application traffic; use HTTPS and restore the secure-cookie default as soon as possible.
• Store your .env.local file securely and do not commit it to version control.
• The .gitignore file already excludes .env* files (except .env.example).