环境变量¶

InnoClaw 使用的所有环境变量的完整参考。

核心配置¶

变量	类型	必需	默认值	描述
`WORKSPACE_ROOTS`	`string`	是	—	以逗号分隔的绝对路径，用于创建工作空间。目录必须在服务器上已存在。
`DATABASE_URL`	`string`	否	`./data/innoclaw.db`	SQLite database filesystem path. Set to a local path when the project resides on NFS or another network filesystem.
`NEXT_BUILD_DIR`	`string`	否	`.next`	Next.js build output directory. Set to a local filesystem path to avoid Turbopack cache errors on network/shared filesystems.

AI 提供商配置¶

变量	类型	必需	默认值	描述
`OPENAI_API_KEY`	`string`	否	—	用于对话和嵌入的 OpenAI API 密钥。
`ANTHROPIC_API_KEY`	`string`	否	—	用于 Claude 模型的 Anthropic API 密钥。
`GEMINI_API_KEY`	`string`	否	—	Google Gemini API key for Gemini models.
`OPENAI_BASE_URL`	`string`	否	`https://api.openai.com/v1`	自定义 OpenAI 兼容 API 端点（用于代理或第三方提供商）。
`ANTHROPIC_BASE_URL`	`string`	否	`https://api.anthropic.com`	自定义 Anthropic API 端点。
`GEMINI_BASE_URL`	`string`	否	—	Custom Gemini-compatible API endpoint (OpenAI-compatible proxy).
`LLM_PROVIDER`	`string`	否	`openai`	Default LLM provider: `openai`, `anthropic`, or `gemini`. Overridable in Settings UI.
`LLM_MODEL`	`string`	否	`gpt-4o-mini`	Default model ID. Overridable in Settings UI.

备注

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.

Agent Configuration¶

变量	类型	必需	默认值	描述
`AGENT_MAX_STEPS`	`number`	否	`10`	Maximum agent tool-call steps per request (1–100). Higher values allow complex multi-step tasks but cost more tokens.

Embedding API 配置¶

这些配置允许使用独立于对话模型提供商的单独服务来生成向量嵌入。

变量	类型	必需	默认值	描述
`EMBEDDING_API_KEY`	`string`	否	回退到 `OPENAI_API_KEY`	Embedding 服务的 API 密钥。
`EMBEDDING_BASE_URL`	`string`	否	回退到 `OPENAI_BASE_URL`	Embedding 服务的端点。
`EMBEDDING_MODEL`	`string`	否	`text-embedding-3-small`	要使用的 Embedding 模型名称。

示例 —— 使用专用的 Embedding 服务：

# 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 集成¶

变量	类型	必需	默认值	描述
`GITHUB_TOKEN`	`string`	否	—	用于克隆/拉取私有仓库的 GitHub 个人访问令牌。需要 `repo` 权限范围。

HuggingFace / ModelScope Datasets¶

变量	类型	必需	默认值	描述
`HF_TOKEN`	`string`	否	—	HuggingFace access token. Avoids rate limits when downloading datasets. Also settable via the Settings UI.
`HF_DATASETS_PATH`	`string`	否	`./data/hf-datasets`	Local directory for downloaded HuggingFace/ModelScope datasets.

SCP Hub (Scientific Skills)¶

变量	类型	必需	默认值	描述
`SCP_HUB_API_KEY`	`string`	否	—	API key for the Intern-Discovery Platform, enabling 206 built-in SCP scientific skills (drug discovery, protein analysis, genomics, chemistry, etc.).

HTTP Proxy¶

变量	类型	必需	默认值	描述
`HTTP_PROXY`	`string`	否	—	HTTP proxy for all outbound `fetch()` calls (AI API, GitHub, etc.).
`HTTPS_PROXY`	`string`	否	—	HTTPS proxy. Typically the same value as `HTTP_PROXY`.
`NO_PROXY`	`string`	否	—	Comma-separated hosts/CIDRs that bypass the proxy, e.g. `localhost,127.0.0.1,10.0.0.0/8`.

飞书机器人配置¶

变量	类型	必需	默认值	描述
`FEISHU_BOT_ENABLED`	`boolean`	否	`false`	启用飞书机器人集成。
`FEISHU_APP_ID`	`string`	否	—	飞书应用 ID。
`FEISHU_APP_SECRET`	`string`	否	—	飞书应用密钥。
`FEISHU_VERIFICATION_TOKEN`	`string`	否	—	用于验证飞书 Webhook 请求的令牌。
`FEISHU_ENCRYPT_KEY`	`string`	否	—	飞书事件负载的加密密钥。
`FEISHU_PUSH_SECRET`	`string`	否	—	Shared secret for authenticating the push API (`/api/bot/feishu/push`). Required for web-to-Feishu message forwarding.
`FEISHU_LOG_LEVEL`	`string`	否	`info`	SDK log verbosity: `error`, `warn`, `info`, `debug`, `trace`.

企业微信机器人配置¶

变量	类型	必需	默认值	描述
`WECHAT_BOT_ENABLED`	`boolean`	否	`false`	启用企业微信机器人集成。
`WECHAT_CORP_ID`	`string`	否	—	企业微信企业 ID。
`WECHAT_CORP_SECRET`	`string`	否	—	企业微信应用密钥。
`WECHAT_TOKEN`	`string`	否	—	用于验证企业微信 Webhook 请求的令牌。
`WECHAT_ENCODING_AES_KEY`	`string`	否	—	用于加密/解密企业微信消息的 AES 密钥。
`WECHAT_AGENT_ID`	`string`	否	—	企业微信应用（代理）ID。

Kubernetes / Cluster Integration¶

变量	类型	必需	默认值	描述
`KUBECONFIG_PATH`	`string`	否	—	Path to your kubeconfig file for Kubernetes cluster access.
`K8S_SUBMITTER`	`string`	否	—	AD account name used as the job submitter identity.
`K8S_IMAGE_PULL_SECRET`	`string`	否	—	Kubernetes secret name for pulling container images.
`K8S_PVC_AI4S`	`string`	否	—	PersistentVolumeClaim name for AI4S shared storage.
`K8S_PVC_USER`	`string`	否	—	PersistentVolumeClaim name for user storage.
`K8S_PVC_AI4S_A2`	`string`	否	—	PersistentVolumeClaim name for AI4S A2 partition storage.
`K8S_MOUNT_USER`	`string`	否	—	Username for PVC mount path resolution.

安全说明¶

所有 API 密钥和令牌仅在服务器端使用，永远不会暴露给浏览器客户端。
请安全地存储您的 .env.local 文件，不要将其提交到版本控制系统。
.gitignore 文件已排除 .env* 文件（.env.example 除外）。