基础配置

FinClaw 的运行配置集中在部署目录的 .env 文件（由 init-env.sh 从 .env.example 生成）。首次部署时以下关键配置由离线包内置、开箱即可启动。

变量	说明	来源
DEPLOYMENT_LICENSE_KEY	License 密钥	第一次部署时 init-env.sh 自动生成（离线包 .env.example 内置凡泰签发值，无需手工配置）；更新流程见 更新 License
DEPLOYMENT_LICENSE_CIPHER	License 加密密钥	同上

LLM 模型（后台配置，env 仅引导）

模型配置（提供商、模型名称、API Key、Base URL）优先走管理后台（Admin）配置，持久化在数据库，支持多模型。.env 的 LLM_PROVIDER / LLM_MODEL / LLM_API_KEY / LLM_BASE_URL 仅作首次启动引导与 fallback（默认引导值 LLM_PROVIDER=deepseek、LLM_MODEL=deepseek-v4-flash），无需手工配置。

详见 业务配置。

自定义对外端口

FinClaw 默认通过 API Gateway 容器把宿主机 26100 端口对外暴露（docker-compose.yml 中 api-gateway 服务的 26100:26100）。如果该端口被占用、或需统一规划运维端口，可按以下方式改为其他端口（以下示例改为 28100）。

使用 docker-compose.override.yml

不修改原 docker-compose.yml，升级后不会被覆盖。

cd /data/chatkit-offline-release-<version>-linux-amd64/deploy

cat > docker-compose.override.yml <<'EOF'
services:
  api-gateway:
    ports:
      - "28100:26100"   # 左边 = 宿主机端口，右边 = 容器内端口（不要改）
EOF

# 重启使配置生效
./scripts/fleet.sh down
./scripts/fleet.sh up -d

下一步配置指引

要配置什么	去哪页
LLM 多模型、渠道（飞书/企业微信/钉钉）、Persona 模板、技能服务、管理员与会话、存储与上传	业务配置
并发配额、Agent loop、执行 posture 与 FinSAFE/Hermes、认证 token、claw-fleet-manager、可观测性	运维配置