docker/env.example 为参考；如果已经进入 docker/ 目录，执行 cp env.example .env 并按需修改即可。
部分参数说明如下：
组织初始化与模板
以下变量主要在“创建新组织”时生效，用于初始化组织默认工作区、分析模型和模板 xpert：
示例配置：
ORG_DEFAULT_XPERT_TEMPLATE_KEYS使用模板 ID，而不是模板名称。上面的两个示例模板分别对应ChatBI with Sales Analysis Expert和Text2SQL-ChatDB。ORG_ANALYTICS_BOOTSTRAP_MODE=semantic-only只初始化语义模型运行所需数据；full-demo会额外导入 demo indicators 和 demo story。XPERT_TEMPLATE_DIR未设置时会回退到默认数据目录；在 Docker 环境下通常对应/var/lib/xpert/data/xpert-template。- 这组配置不会回溯修改已有组织，只影响后续新创建的组织。
权限与 Handoff 路由
示例配置：
docker/handoff-routing.example.yaml，最小示例如下：
ALLOW_SUPER_ADMIN_ROLE不会删除或创建角色，它控制的是SUPER_ADMIN是否自动跳过部分租户/组织权限检查。HANDOFF_ROUTING_CONFIG_PATH未设置时，系统会记录告警并回退到内置默认路由。- handoff 路由配置在模块初始化时加载一次，修改 YAML 文件后需要重启 API 服务。
插件与默认技能仓库
示例配置：
PLUGINS在服务启动阶段读取，修改后需要重启 API 服务。AI_DEFAULT_SKILL_REPOSITORIES也支持直接传 JSON 数组，但推荐与docker/env.example一样使用repositories包装结构，便于扩展。AI_DEFAULT_SKILL_REPOSITORIES中的provider需要填写系统支持的技能仓库提供方，例如github或clawhub。- 如果 JSON 格式不合法，系统会记录告警并忽略该配置。
- 这组默认技能仓库仅在“新租户创建”时自动注册；已有租户如需补充，请通过技能仓库接口手动注册并同步。