What is DramaClaw?

DramaClaw is a source-available AI video engine that transforms scripts into finished films through an integrated production pipeline. It provides two interfaces: an infinite node-based canvas (XiaHua) with 18 node types for images, video, audio, and 3D, plus a structured pipeline (Series/XiaJi) for novel-to-drama work including script writing, storyboarding, voice synthesis, and video assembly. The built-in Xia Director agent coordinates workflows across both interfaces using natural-language prompts. All AI inference is handled via an OpenAI-compatible gateway — the official RelayClaw service or a bundled self-hosted gateway — keeping local hardware requirements low. The Elastic License 2.0 permits free commercial use for standalone deployments but prohibits running it as a managed service for other parties.

Should you self-host DramaClaw?

DramaClaw scores 61/100 on selfhost.directory (how scoring works) and ranks #5 of 12 in Video. It has 6 543 GitHub stars.

It shipped 10 stable releases in the past year. The latest, v2.1.0, came out on 28 October 2026. New versions land roughly every 8 days.

Setup is advanced: plan for several services and some ongoing maintenance. An official Docker image is available. It is Other-licensed and written mostly in Python.

Its closest alternative on selfhost.directory is cap (79/100, 24 000 stars). It scores higher overall, so compare the two before you pick. See DramaClaw vs cap side by side.

Features

3D director stage (Previz)In closed beta
Built-in AI agent (Xia Director)
Interactive storiesIn closed beta

How to configure DramaClaw

BRAINCLAW_CAPABILITY_KEYRING_FILEBrainClaw evidence plane — the issuing end. Trusted mode needs no shared signing keys. DramaClaw creates one persistent, local-only grouping key under STATE_DIR/brainclaw/grouping.key so raw project and trajectory ids never leave this process. The two K1 variables below are optional and used only when the selected Gateway channel is in verified mode.
BrainClaw evidence plane — the issuing end. Trusted mode needs no shared signing keys. DramaClaw creates one persistent, local-only grouping key under STATE_DIR/brainclaw/grouping.key so raw project and trajectory ids never leave this process. The two K1 variables below are optional and used only when the selected Gateway channel is in verified mode.
BRAINCLAW_CAPABILITY_SIGNING_KEY_ID
BRAINCLAW_CONTROL_CONTEXT_GROUPING_KEY_EPOCH
BRAINCLAW_CONTROL_CONTEXT_GROUPING_KEY_FILE
BRAINCLAW_CONTROL_CONTEXT_KEYRING_FILEOptional legacy direct-HTTP Control Context signing. This is not the normal Hermes -> Claymore evidence path below. All four are required together; leaving them empty disables only this direct transport. The keyring is the same owner-only JSON file the BrainClaw Gateway loads, so the two ends cannot drift on encoding. The grouping key must be a *separate* file with a longer lifetime: rotating it s
Optional legacy direct-HTTP Control Context signing. This is not the normal Hermes -> Claymore evidence path below. All four are required together; leaving them empty disables only this direct transport. The keyring is the same owner-only JSON file the BrainClaw Gateway loads, so the two ends cannot drift on encoding. The grouping key must be a *separate* file with a longer lifetime: rotating it s
BRAINCLAW_CONTROL_CONTEXT_SIGNING_KEY_ID
BRAINCLAW_OUTCOME_KEY_FILE
BRAINCLAW_OUTCOME_STATE_DIRstate/brainclaw
BRAINCLAW_OUTCOME_URLOptional BrainClaw request-transport Outcome feedback. Both values are required; delivery is durable and asynchronous, so model responses never wait for it.
Optional BrainClaw request-transport Outcome feedback. Both values are required; delivery is durable and asynchronous, so model responses never wait for it.
BROWSER_MODEL_ASSET_BASE浏览器端推理（画布抠图、深度动作捕捉）的模型权重与 onnxruntime wasm 自托管前缀。不配时浏览器直接从 Hugging Face Hub 和 jsDelivr 下载，国内网络基本不可达。用 scripts/fetch_browser_models.py 生成目录后整体上传到对象存储/CDN，再把前缀填到这里；该域名需允许跨域 GET（CORS）。
浏览器端推理（画布抠图、深度动作捕捉）的模型权重与 onnxruntime wasm 自托管前缀。不配时浏览器直接从 Hugging Face Hub 和 jsDelivr 下载，国内网络基本不可达。用 scripts/fetch_browser_models.py 生成目录后整体上传到对象存储/CDN，再把前缀填到这里；该域名需允许跨域 GET（CORS）。
BROWSER_MODEL_HF_ENDPOINT不想自托管时可以直接指向公共镜像，两项各自优先于上面的 ASSET_BASE：权重源要与 Hugging Face Hub 路径规则一致；wasm 源里的 {version} 由前端替换成 onnxruntime-web 版本。公共镜像没有可用性承诺，生产 CSP 的 connect-src / script-src 也要放行对应域名。
不想自托管时可以直接指向公共镜像，两项各自优先于上面的 ASSET_BASE：权重源要与 Hugging Face Hub 路径规则一致；wasm 源里的 {version} 由前端替换成 onnxruntime-web 版本。公共镜像没有可用性承诺，生产 CSP 的 connect-src / script-src 也要放行对应域名。
BROWSER_ORT_WASM_BASE
CHARACTER_BUILD_MODELDC-character-builder-LLM角色库 / 从原文构建 / structured_v1 逐片段角色抽取与证据引用。
角色库 / 从原文构建 / structured_v1 逐片段角色抽取与证据引用。
CLOUDINARY_RELAY_API_KEY
CLOUDINARY_RELAY_API_SECRET
CLOUDINARY_RELAY_CLOUD_NAME可选：使用 Cloudinary 作为参考媒体 relay。将 MEDIA_RELAY_PROVIDER 设为 cloudinary 后生效。
可选：使用 Cloudinary 作为参考媒体 relay。将 MEDIA_RELAY_PROVIDER 设为 cloudinary 后生效。
CLOUDINARY_RELAY_FOLDER
CODEX_MODELDC-codex-agent-LLMCodex / 虾导聊天模型。同样走当前选中的 NewAPI 模型网关；网关负责把 DC-codex-agent-LLM 路由到实际的上游模型。带安全补丁 Runtime 的 CE Docker 默认使用 Codex App Server；源码启动脚本默认使用其安装的 Hermes。源码环境如需使用 Codex，须同时设置 DRAMACLAW_CHAT_BACKEND=codex 和有效的 CODEX_BIN。
Codex / 虾导聊天模型。同样走当前选中的 NewAPI 模型网关；网关负责把 DC-codex-agent-LLM 路由到实际的上游模型。带安全补丁 Runtime 的 CE Docker 默认使用 Codex App Server；源码启动脚本默认使用其安装的 Hermes。源码环境如需使用 Codex，须同时设置 DRAMACLAW_CHAT_BACKEND=codex 和有效的 CODEX_BIN。
CODEX_REASONING_EFFORTmediumCodex Agent 默认启用中等推理。若 NewAPI 路由的实际模型要求其它等级，可设置 none/minimal/low/medium/high/xhigh/max/ultra；推理模型不要设为 none。
Codex Agent 默认启用中等推理。若 NewAPI 路由的实际模型要求其它等级，可设置 none/minimal/low/medium/high/xhigh/max/ultra；推理模型不要设为 none。
COGNEE_EMBEDDING_BATCH_CONCURRENCY4Embedding 并发限制当前仅适用于经 newAPI/custom LiteLLM 发出的请求；其他 provider 会记录绕过日志。
Embedding 并发限制当前仅适用于经 newAPI/custom LiteLLM 发出的请求；其他 provider 会记录绕过日志。
COGNEE_EMBEDDING_DIM1024Cognee 启动和无项目上下文旧路径的默认维度。项目实际维度由 project_config.json 的 cognee_embedding_dimension 决定。
Cognee 启动和无项目上下文旧路径的默认维度。项目实际维度由 project_config.json 的 cognee_embedding_dimension 决定。
COGNEE_EMBEDDING_MODELDC-cognee-embeddingCognee 启动和旧路径使用的默认模型名。项目实际请求模型由各自 project_config.json 的 cognee_embedding_model 决定：官方历史项目使用 v1，官方新项目使用 v2，CE 自定义 newAPI 项目使用无后缀兼容模型名。
Cognee 启动和旧路径使用的默认模型名。项目实际请求模型由各自 project_config.json 的 cognee_embedding_model 决定：官方历史项目使用 v1，官方新项目使用 v2，CE 自定义 newAPI 项目使用无后缀兼容模型名。
COGNEE_LLM_CONCURRENCY2每次小说导入 pipeline 的上游在途请求上限。多个同时导入的 pipeline 会分别计算。 LLM 的实体/关系抽取与摘要共享同一个并发额度。
每次小说导入 pipeline 的上游在途请求上限。多个同时导入的 pipeline 会分别计算。 LLM 的实体/关系抽取与摘要共享同一个并发额度。
COGNEE_LLM_MODELDC-cognee-LLM导入小说 / cognify / memify 使用的 LLM。
导入小说 / cognify / memify 使用的 LLM。
COGNEE_SKIP_CONNECTION_TESTtrue跳过 Cognee 启动连接预检，真实请求仍会走 newAPI。
跳过 Cognee 启动连接预检，真实请求仍会走 newAPI。
CONTENT_REWRITER_MODELDC-content-rewriter-LLM内容改写 / 原文转短视频口播逐行文本。
内容改写 / 原文转短视频口播逐行文本。
DEFAULT_CHARACTER_IMAGE_SELECTIONnewapi_gpt_image2角色图默认模型。
角色图默认模型。
DEFAULT_RENDER_IMAGE_SELECTIONnewapi_gpt_image2镜头 render 默认模型。
镜头 render 默认模型。
DEFAULT_SKETCH_IMAGE_SELECTIONnewapi_gpt_image2镜头草图默认模型。
镜头草图默认模型。
DEFAULT_VIDEO_MODELseedance-1.0-pro-fast默认视频模型。
默认视频模型。
DIRECTOR_VIEWER_URLhttp://127.0.0.1:9024BuilderGPT Director viewer 对浏览器可访问的地址。局域网协作时改为本机 LAN IP，例如 http://192.168.2.206:9024。
BuilderGPT Director viewer 对浏览器可访问的地址。局域网协作时改为本机 LAN IP，例如 http://192.168.2.206:9024。
DRAMACLAW_CODEX_HOMECodex App Server 在每个 home node 内共享一个进程；未配置时使用 NOVELVIDEO_STATE_DIR/.codex-app-server，项目只保存自己的 thread 映射和工作区。
Codex App Server 在每个 home node 内共享一个进程；未配置时使用 NOVELVIDEO_STATE_DIR/.codex-app-server，项目只保存自己的 thread 映射和工作区。
DRAMACLAW_CODEX_MODEL_CATALOG_FILE完整的 Codex model catalog 已随仓库和镜像提供。只有当 Gateway alias 能力不同时，才用绝对路径覆盖。
完整的 Codex model catalog 已随仓库和镜像提供。只有当 Gateway alias 能力不同时，才用绝对路径覆盖。
DRAMACLAW_GATEWAY_SRC源码构建（docker compose up -d --build）默认用与本仓并排的 ../dramaclaw-gateway checkout 构建网关（先 git clone 它）； clone 放在别处、或不想 clone 而让 Docker 直接从 git 拉时改这里：
源码构建（docker compose up -d --build）默认用与本仓并排的 ../dramaclaw-gateway checkout 构建网关（先 git clone 它）； clone 放在别处、或不想 clone 而让 Docker 直接从 git 拉时改这里：
DRAMACLAW_GATEWAY_VERSION
DRAMACLAW_IMAGE_PREFIX镜像来源与版本（仅镜像模式 docker-compose.release.yml 生效）。默认拉 Docker Hub 上 claymorelab/* 的固定版本（见文件内默认值，每次发行包打包后由打包 workflow 开 PR 抬，不是 latest）。国内拉取慢可切到阿里云 ACR 公开仓；ACR 只有发行包钉过的 tag，没有 latest，三行要一起填：
镜像来源与版本（仅镜像模式 docker-compose.release.yml 生效）。默认拉 Docker Hub 上 claymorelab/* 的固定版本（见文件内默认值，每次发行包打包后由打包 workflow 开 PR 抬，不是 latest）。国内拉取慢可切到阿里云 ACR 公开仓；ACR 只有发行包钉过的 tag，没有 latest，三行要一起填：
DRAMACLAW_LOCAL_AGENT_TRUST仅限本机开发：允许直连 loopback 的 Agent 在无 Token 时使用本场 owner 身份。切勿在任何可被外部访问或经过反向代理的部署中开启。
仅限本机开发：允许直连 loopback 的 Agent 在无 Token 时使用本场 owner 身份。切勿在任何可被外部访问或经过反向代理的部署中开启。
DRAMACLAW_VERSION
EMBEDDING_BATCH_SIZE10Cognee embedding 单次请求文本条数。官方默认使用 10，兼容 Qwen / 阿里等低 input 上限模型。如果上游 embedding 模型支持更大批量，可以按需调高。
Cognee embedding 单次请求文本条数。官方默认使用 10，兼容 Qwen / 阿里等低 input 上限模型。如果上游 embedding 模型支持更大批量，可以按需调高。
EPISODE_PROP_PLANNER_MODELDC-episode-prop-planner-LLM剧集详情 / 规划道具。
剧集详情 / 规划道具。
EPISODE_SCENE_PLANNER_MODELDC-episode-scene-planner-LLM剧集详情 / 规划场景。
剧集详情 / 规划场景。
EPISODE_SCENE_RECONCILE_MODELDC-episode-scene-reconciler-LLM2.0 资产编译 / 基础场景资产校对。
2.0 资产编译 / 基础场景资产校对。
FREEZONE_CANVAS_PAYLOAD_LIMIT_BYTES5242880Freezone 画布 payload 上限，单位字节。
Freezone 画布 payload 上限，单位字节。
FREEZONE_RECIPE_COMPILER_BATCH_CONCURRENCY3同批 Recipe 提示词的最大并发编译数（范围 1-8）。
同批 Recipe 提示词的最大并发编译数（范围 1-8）。
FREEZONE_RECIPE_COMPILER_MODELDC-freezone-recipe-compiler-LLMFreezone / Recipe 编译为可执行提示词。
Freezone / Recipe 编译为可执行提示词。
FREEZONE_RECIPE_COMPILER_REASONING_EFFORTlowRecipe 编译模型始终启用推理；可选 low/high/max，默认 low。
Recipe 编译模型始终启用推理；可选 low/high/max，默认 low。
FREEZONE_RECIPE_COMPILER_TIMEOUT_SECONDS30单节点编译等待上限；超时后使用确定性 fallback，不阻断工作流。
单节点编译等待上限；超时后使用确定性 fallback，不阻断工作流。
FREEZONE_RECIPE_TEXT_TIMEOUT_SECONDS540Recipe 文本节点可能输出完整剧本等长内容；预留 60 秒给前端同步最终结果。
Recipe 文本节点可能输出完整剧本等长内容；预留 60 秒给前端同步最终结果。
FREEZONE_STORY_SCRIPT_MODELDC-freezone-story-script-writer-LLMFreezone / 故事脚本生成。
Freezone / 故事脚本生成。
FREEZONE_TEXT_WRITER_MODELDC-freezone-text-writer-LLMFreezone / AI 文本创作。
Freezone / AI 文本创作。
FREEZONE_TRANSLATION_MODELDC-freezone-translator-LLMFreezone / 文本提示词中英互译。
Freezone / 文本提示词中英互译。
FREEZONE_VISION_MODELDC-freezone-vision-LLMFreezone / 图片反推、视频参考生分镜和局部元素识别；必须支持图片输入。
Freezone / 图片反推、视频参考生分镜和局部元素识别；必须支持图片输入。
GLOBAL_VIDEO_IDENTITY_DETECTOR_MODELDC-video-identity-detector-LLM草图 / AI 检测身份与道具颜色标记。
草图 / AI 检测身份与道具颜色标记。
GLOBAL_VIDEO_OPTIMIZER_MODELDC-video-prompt-optimizer-LLM镜头页 / AI 优化提示词。
镜头页 / AI 优化提示词。
HERMES_MODELDC-hermes-LLMHermes / 虾导聊天模型。地址和密钥始终跟随当前选中的模型网关。
Hermes / 虾导聊天模型。地址和密钥始终跟随当前选中的模型网关。
HERMES_MODEL_API_MODEchat_completions
HERMES_MODEL_CONTEXT_LENGTH131072
HERMES_TOOL_SEARCH_MODEautoFreezone defaults to progressive tool disclosure. Set "off" only as a compatibility rollback; "on" forces the same bridge behavior as "auto".
Freezone defaults to progressive tool disclosure. Set "off" only as a compatibility rollback; "on" forces the same bridge behavior as "auto".
IDENTITY_PLANNER_ANALYSIS_MODELDC-identity-analysis-planner-LLM剧集详情 / AI 规划身份 / 默认身份与其他身份分析。
剧集详情 / AI 规划身份 / 默认身份与其他身份分析。
IDENTITY_PLANNER_APPEARANCE_MODELDC-identity-appearance-writer-LLM剧集详情 / AI 规划身份 / 新身份服装造型描述。
剧集详情 / AI 规划身份 / 新身份服装造型描述。
IDENTITY_PLANNER_CAST_MODELDC-identity-cast-planner-LLM剧集详情 / AI 规划身份 / 出场角色筛选。
剧集详情 / AI 规划身份 / 出场角色筛选。
IMAGE_DEFAULT_HEIGHT2560
IMAGE_DEFAULT_STYLEchinese_period_drama
IMAGE_DEFAULT_WIDTH1440
INDEXTTS2_NEWAPI_MODELindex-tts-2
INDEXTTS2_PROVIDERnewapibeat 音频生成使用 IndexTTS2；参考声线按 v2.0 逻辑传入。
beat 音频生成使用 IndexTTS2；参考声线按 v2.0 逻辑传入。
INDEXTTS2_TIMEOUT_SECONDS1800音频生成 HTTP 超时时间，单位秒。
音频生成 HTTP 超时时间，单位秒。
KEYFRAME_PROMPT_MODEL首尾帧 / 过渡提示词生成。
首尾帧 / 过渡提示词生成。
LITERAL_BEAT_META_MODELDC-literal-beat-meta-LLM剧集详情 / 逐行生成。
剧集详情 / 逐行生成。
MEDIA_RELAY_PROVIDERaliyun_oss本地参考图需要先上传到 OSS relay，再把短期签名 URL 传给 newAPI/上游。 CE 前端保存 OSS relay 配置后，本地 SQLite 配置优先生效。
本地参考图需要先上传到 OSS relay，再把短期签名 URL 传给 newAPI/上游。 CE 前端保存 OSS relay 配置后，本地 SQLite 配置优先生效。
MEDIA_RELAY_TTL_SECONDS1800签名 URL 默认有效期，单位秒。CE 前端保存后，本地 SQLite 配置优先生效。
签名 URL 默认有效期，单位秒。CE 前端保存后，本地 SQLite 配置优先生效。
NARRATED_SCENE_ASSET_MODELDC-narrated-scene-asset-planner-LLM2.0 资产编译 / 解说剧场景资产规划。
2.0 资产编译 / 解说剧场景资产规划。
NEWAPI_ADMIN_BASE_URLNewAPI 管理地址，不带 /v1；用于 /api/channel/ 和 /api/token/ 管理接口。
NewAPI 管理地址，不带 /v1；用于 /api/channel/ 和 /api/token/ 管理接口。
NEWAPI_BASE_URLThe gateway origin. Under the per-turn latch this is also the only host a worker may reach: a request to anything else is refused before it is sent, because an unauthenticated call has still carried the prompt off the machine.
The gateway origin. Under the per-turn latch this is also the only host a worker may reach: a request to anything else is refused before it is sent, because an unauthenticated call has still carried the prompt off the machine.
NEWAPI_IMAGE_EDIT_REFERENCE_FORMATdc-media图片编辑参考图格式：默认 dc-media，发送 image: [URL]。本地网关转发到 Cockpit Tools 时设为 images，发送 images: [{image_url: URL}]。只影响带参考图的 /images/edits；无参考图生成保持原协议。
图片编辑参考图格式：默认 dc-media，发送 image: [URL]。本地网关转发到 Cockpit Tools 时设为 images，发送 images: [{image_url: URL}]。只影响带参考图的 /images/edits；无参考图生成保持原协议。
NEWAPI_IMAGE_MODELLingShan-G2LingShan-G2 逻辑模型；image2 类模型会按场景透传 quality。
LingShan-G2 逻辑模型；image2 类模型会按场景透传 quality。
NEWAPI_NANOBANANA2_MODELLingShan-NB-2LingShan-NB-2 逻辑模型；nano-banana/nb 类模型不透传 quality。
LingShan-NB-2 逻辑模型；nano-banana/nb 类模型不透传 quality。
NEWAPI_PROVISIONER_ENABLEDtrueCE 本地 NewAPI 配置向导。数据库固定使用本机 SQLite，无需填写 DSN 或路径。
CE 本地 NewAPI 配置向导。数据库固定使用本机 SQLite，无需填写 DSN 或路径。
NEWAPI_PROVISIONER_INIT_TIMEOUT_MS120000
NEWAPI_RELAY_TOKEN_NAME
NEWAPI_TEXT_CONTEXT_TOKENS可选文本请求预算：按实际网关模型的上下文窗口设置，未配置时不启用本地预算校验。仅计算文本，不包含视觉 token；原文不会被截断。上下文预算必须大于输出预算 + 1024。
可选文本请求预算：按实际网关模型的上下文窗口设置，未配置时不启用本地预算校验。仅计算文本，不包含视觉 token；原文不会被截断。上下文预算必须大于输出预算 + 1024。
NEWAPI_TEXT_OUTPUT_TOKENS默认输出 token 预算；仅在启用上下文预算校验时生效。
默认输出 token 预算；仅在启用上下文预算校验时生效。
NEWAPI_TEXT_TIMEOUT_SECONDS300newAPI 文本模型 HTTP 超时时间，单位秒。
newAPI 文本模型 HTTP 超时时间，单位秒。
NEWAPI_TEXT_TRUST_ENV是否让 newAPI 文本模型客户端读取系统代理。默认 true。本地 Surge 系统代理影响内网 newAPI 时可设为 false。
是否让 newAPI 文本模型客户端读取系统代理。默认 true。本地 Surge 系统代理影响内网 newAPI 时可设为 false。
NEWAPI_VIDEO_AUDIO_MODELS支持 generate_audio 的视频模型。
支持 generate_audio 的视频模型。
NEWAPI_VIDEO_DURATION_BOUNDSseedance-1.0-pro-fast:2-12,seedance-1.5-pro:4-12,seedance-2.0:4-15,seedance-2.0-fast:4-15,seedance-2.0-value:4-15,seedance-2.0-fast-value:4-15,happyhorse-1.0:3-15,seedance-2.0-mini:4-15各视频模型允许的 duration 范围，单位秒。
各视频模型允许的 duration 范围，单位秒。
NEWAPI_VIDEO_GENERATE_AUDIOauto 表示按模型和 beat 类型决定是否生成同步音频。
auto 表示按模型和 beat 类型决定是否生成同步音频。
NEWAPI_VIDEO_MODELseedance-1.0-pro-fast
NEWAPI_VIDEO_MODELSseedance-1.0-pro-fast,seedance-1.5-pro,seedance-2.0,seedance-2.0-fast,seedance-2.0-value,seedance-2.0-fast-value,happyhorse-1.0,seedance-2.0-mini页面可选的 newAPI 视频模型。
页面可选的 newAPI 视频模型。
NEWAPI_VIDEO_RESOLUTION720p默认视频分辨率。
默认视频分辨率。
NOVELVIDEO_DATA_ROOToutput、state、runtime 默认都从 NOVELVIDEO_DATA_ROOT 派生。本地默认使用当前目录；Docker Compose 固定使用持久化卷 /data。如需整体迁移数据目录，请配置一个绝对路径。
output、state、runtime 默认都从 NOVELVIDEO_DATA_ROOT 派生。本地默认使用当前目录；Docker Compose 固定使用持久化卷 /data。如需整体迁移数据目录，请配置一个绝对路径。
NOVELVIDEO_OUTPUT_DIR高级覆盖：通常无需单独配置；Docker Compose 会强制使用 /data/output。
高级覆盖：通常无需单独配置；Docker Compose 会强制使用 /data/output。
OFFICIAL_MEDIA_CATALOG_MANIFEST_URL官方目录默认从 dramaclaw-dl OSS 读取；内容文件使用 SHA256 不可变路径。
官方目录默认从 dramaclaw-dl OSS 读取；内容文件使用 SHA256 不可变路径。
OFFICIAL_MEDIA_CATALOG_POLL_SECONDS后端自动更新轮询间隔，最低 60 秒，默认 300 秒。
后端自动更新轮询间隔，最低 60 秒，默认 300 秒。
OFFICIAL_MEDIA_CATALOG_URL兼容旧部署：直接返回目录 JSON 的地址。未配置 manifest 时才使用。默认读取 DramaClaw GitHub main 分支中的目录文件。
兼容旧部署：直接返回目录 JSON 的地址。未配置 manifest 时才使用。默认读取 DramaClaw GitHub main 分支中的目录文件。
OSS_RELAY_AK
OSS_RELAY_BUCKETclaymore-llm-relay
OSS_RELAY_ENDPOINToss-cn-chengdu.aliyuncs.comrelay bucket 固定给 newAPI 参考媒体使用。CE 前端保存后，本地 SQLite 配置优先生效。
relay bucket 固定给 newAPI 参考媒体使用。CE 前端保存后，本地 SQLite 配置优先生效。
OSS_RELAY_SK
PROMPT_EXPORT_PASSWORDoperator 操作口令：护「导出提示词」与「图像生成防护闸」。必须设为你自己的非默认值；留空 = 这些受护动作一律拒绝(无公开默认口令)。
operator 操作口令：护「导出提示词」与「图像生成防护闸」。必须设为你自己的非默认值；留空 = 这些受护动作一律拒绝(无公开默认口令)。
PROP_REF_IMAGE_MODELLingShan-G2
PROP_REF_IMAGE_PROVIDERnewapi项目资产 / 道具三视图参考图 reference_3view.png。
项目资产 / 道具三视图参考图 reference_3view.png。
RELEASE_NOTIFICATIONS_ENABLEDtrue版本/功能更新通知。false = 完全关闭 release feed,不读包内 notes、不访问 GitHub。
版本/功能更新通知。false = 完全关闭 release feed,不读包内 notes、不访问 GitHub。
RELEASE_NOTIFICATIONS_GITHUB_TOKEN可选 GitHub token,用于提高 GitHub releases/latest 查询限流额度；留空走匿名请求。
可选 GitHub token,用于提高 GitHub releases/latest 查询限流额度；留空走匿名请求。
SCENE_360_IMAGE_MODELLingShan-G2
SCENE_360_IMAGE_PROVIDERnewapi项目资产 / pano_360.png，使用 master/reverse 参考图，2:1 全景。
项目资产 / pano_360.png，使用 master/reverse 参考图，2:1 全景。
SCENE_BUILD_MODELDC-scene-builder-LLM场景库 / 从图谱构建 / 场景解析、规范化与 environment_prompt 生成。
场景库 / 从图谱构建 / 场景解析、规范化与 environment_prompt 生成。
SCENE_MASTER_IMAGE_MODELLingShan-NB-2
SCENE_MASTER_IMAGE_PROVIDERnewapi项目资产 / 源图 master.png，纯文本生成。
项目资产 / 源图 master.png，纯文本生成。
SCENE_OVERLAP_ANALYSIS_MODELDC-scene-overlap-analyzer-LLMOptional master/reverse reference analysis uses the configured LLM gateway. Map both business aliases to a vision-capable upstream (e.g. openai/gpt-5.6-luna). CE Official/Hybrid mode keeps its normal BrainClaw routing.
Optional master/reverse reference analysis uses the configured LLM gateway. Map both business aliases to a vision-capable upstream (e.g. openai/gpt-5.6-luna). CE Official/Hybrid mode keeps its normal BrainClaw routing.
SCENE_REVERSE_MASTER_IMAGE_MODELLingShan-NB-2
SCENE_REVERSE_MASTER_IMAGE_PROVIDERnewapi项目资产 / reverse_master.png，使用 master.png 作为参考图。
项目资产 / reverse_master.png，使用 master.png 作为参考图。
SCENE_SPATIAL_CONTRACT_MODELDC-scene-spatial-contract-LLM
SCREENPLAY_NORMALIZER_MODELDC-screenplay-normalizer-LLM剧本规范化。
剧本规范化。
SEEDANCE2_PROMPT_COMPOSER_MODELDC-seedance2-prompt-composer-LLM镜头页 / Seedance 2.0 面板 / AI 优化。
镜头页 / Seedance 2.0 面板 / AI 优化。
STAGING_PROP_MODELDC-staging-prop-planner-LLMDirectorWorld / Freezone AI 临时道具规划。
DirectorWorld / Freezone AI 临时道具规划。
STAGING_PROP_TIMEOUT_SECONDS120
ST_CE_ENABLE_ASSISTANT_SURFACESCE 默认打开外围虾导和虾画内虾导。该兼容开关无需再手动设置。
CE 默认打开外围虾导和虾画内虾导。该兼容开关无需再手动设置。
ST_NEWAPI_BIND网关后台端口默认只绑本机回环；要从别的机器访问网关后台时放开：
网关后台端口默认只绑本机回环；要从别的机器访问网关后台时放开：
ST_NEWAPI_PORT内置 newapi 后台宿主端口（仅 docker compose 生效）。容器内固定 3000，这里只改宿主映射。默认 3000；端口冲突时改成别的（例如 30000）。
内置 newapi 后台宿主端口（仅 docker compose 生效）。容器内固定 3000，这里只改宿主映射。默认 3000；端口冲突时改成别的（例如 30000）。
STRUCTURED_LLM_CONCURRENCY2structured_v1 逐片段抽取的并发槽位（角色抽取、场次规范化、场景描述生成）。
structured_v1 逐片段抽取的并发槽位（角色抽取、场次规范化、场景描述生成）。
ST_TASK_ENVELOPE_ACTIVE_KEY_ID任务信封用 HMAC 签名，防止任务在投递途中被改写身份。单机部署无需配置：首次启动自动生成一把本机密钥，存放于 <NOVELVIDEO_STATE_DIR>/task_envelope_keyring.json （权限 0600），此后重启复用。只有多主机共跑同一套任务时才需要显式配置——此时所有进程必须用同一份 keyring，否则一端签的另一端验不过。生成一把 key： python3 -c "import base64,os;print(base64.b64encode(os.urandom(32)).decode())" active key ID 须匹配 ^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$ 且存在于 keyring 中； keyring 可同时保留退役 key，供轮换窗口内验签。真实值只放本机或密钥管理系统。
任务信封用 HMAC 签名，防止任务在投递途中被改写身份。单机部署无需配置：首次启动自动生成一把本机密钥，存放于 <NOVELVIDEO_STATE_DIR>/task_envelope_keyring.json （权限 0600），此后重启复用。只有多主机共跑同一套任务时才需要显式配置——此时所有进程必须用同一份 keyring，否则一端签的另一端验不过。生成一把 key： python3 -c "import base64,os;print(base64.b64encode(os.urandom(32)).decode())" active key ID 须匹配 ^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$ 且存在于 keyring 中； keyring 可同时保留退役 key，供轮换窗口内验签。真实值只放本机或密钥管理系统。
ST_TASK_ENVELOPE_KEYRING_B64_JSON
ST_WORKFLOW_RUN_STALE_SECONDS60Freezone 工作流运行记录多久未更新后视为可恢复/中断的陈旧运行，单位秒。
Freezone 工作流运行记录多久未更新后视为可恢复/中断的陈旧运行，单位秒。
STYLE_ANALYZER_MODELDC-style-analyzer-LLM风格页 / 上传参考图创建自定义风格。
风格页 / 上传参考图创建自定义风格。
STYLE_GALLERY_ASSET_BASE画布风格图墙。清单随包发布（src/novelvideo/freezone/style_templates.json），但 45 套风格的封面和示例图不随仓库发布 —— ASSET_BASE 必须指向一个 OSS/CDN 前缀，前端按 `<base>/<清单里的相对路径>` 拼绝对地址。留空则图墙只显示占位块，风格名/提示词/筛选都照常可用（后端启动后首次下发清单时会 WARNING 提示）。图片可用 scripts/build_style_gallery.py 自行构建。注意：下面那行是占位示例，不能直接照抄。自建部署换成自己的域名后，还要把该域名加进前端 CSP 的 img-src 白名单（frontend/docker/nginx.conf.template），否则浏览器会拦掉所有封面，表现和没配一样是一墙占位块。想换一套风格库而不重新发版：图片传新前缀后改 ASSE
画布风格图墙。清单随包发布（src/novelvideo/freezone/style_templates.json），但 45 套风格的封面和示例图不随仓库发布 —— ASSET_BASE 必须指向一个 OSS/CDN 前缀，前端按 `<base>/<清单里的相对路径>` 拼绝对地址。留空则图墙只显示占位块，风格名/提示词/筛选都照常可用（后端启动后首次下发清单时会 WARNING 提示）。图片可用 scripts/build_style_gallery.py 自行构建。注意：下面那行是占位示例，不能直接照抄。自建部署换成自己的域名后，还要把该域名加进前端 CSP 的 img-src 白名单（frontend/docker/nginx.conf.template），否则浏览器会拦掉所有封面，表现和没配一样是一墙占位块。想换一套风格库而不重新发版：图片传新前缀后改 ASSE
STYLE_GALLERY_MANIFEST
SUPERTALE_ALLOW_UNSANDBOXEDLinux 源码运行 Hermes：沙箱缺失、不可用或未激活时，默认拒绝聊天。仅限单机本地开发：确认接受无沙箱运行后再取消下一行注释；运行时仍会告警。此开关不能绕过 EE（ST_CONTROL_PLANE_DSN 非空）或生产环境的沙箱要求。 Codex 不使用此 Hermes 开关。配置说明见 docs/zh/getting-started/installation.md。
Linux 源码运行 Hermes：沙箱缺失、不可用或未激活时，默认拒绝聊天。仅限单机本地开发：确认接受无沙箱运行后再取消下一行注释；运行时仍会告警。此开关不能绕过 EE（ST_CONTROL_PLANE_DSN 非空）或生产环境的沙箱要求。 Codex 不使用此 Hermes 开关。配置说明见 docs/zh/getting-started/installation.md。
VIDEO_AUDIO_CODECaac
VIDEO_BACKENDnewapi_seedance-1.0-pro-fast默认视频生成后端。
默认视频生成后端。
VIDEO_BITRATE4M
VIDEO_CODEClibx264
VIDEO_FPS30
VIDEO_HEIGHT1920
VIDEO_WIDTH1080