业务配置
FinClaw 的业务配置通过 .env 与 deploy/config/ 下的 YAML 完成。本页按业务侧（客户运维/管理员会改的）分组；运维侧（部署工程师/SRE 会改的）见 运维配置；开箱必改项见 基础配置。
LLM 与多模型
支持 provider 清单
原生 provider（内置默认 base URL）：
| provider key | 默认 base_url |
|---|---|
openai | https://api.openai.com/v1 |
deepseek | https://api.deepseek.com/v1 |
anthropic / claude | https://api.anthropic.com |
litellm | http://localhost:4000/v1 |
ollama | http://localhost:11434/v1 |
volcengine / doubao | https://ark.cn-beijing.volces.com/api/v3 |
kimi / moonshot | https://api.moonshot.cn/v1 |
qwen / dashscope / alibaba | https://dashscope.aliyuncs.com/compatible-mode/v1 |
minimax | https://api.minimax.io/v1 |
glm / zhipu / bigmodel | https://open.bigmodel.cn/api/paas/v4 |
openrouter | https://openrouter.ai/api/v1 |
OpenAI 兼容别名：gemini、lmstudio（默认 http://localhost:1234/v1）、custom（走 OpenAI 兼容默认）；未知 provider 一律按 OpenAI 兼容协议 fallback。mock 仅供测试。
多模型 / 多租户
模型选择需 middleware、chatkit-web、ai-infra-rs 版本对齐；用户模型列表接口 GET /users/me/llm-models。多租户场景下，每个租户可在 Admin -> Tenant -> Models 页面单独配置模型与配额。
渠道连接器
FinClaw 提供三个渠道连接器：
| 服务 | 端口 | 凭据来源 |
|---|---|---|
| feishu-connector | 26460 | Admin -> Tenant -> Channels 页面 / .env fallback |
| wecom-connector | 26550 | 同上 |
| dingtalk-connector | 26462 | 同上 |
凭据优先级
- Admin -> Tenant -> Channels 页面配置（持久化到 identity-service，推荐）
.envfallback（仅用于初始化或测试）
渠道绑定相关 URL 仅通过页面配置；不要使用 FEISHU_BIND_* / WECOM_BIND_* / DINGTALK_BIND_* env 变量。
env fallback 变量
| 变量 | 服务 |
|---|---|
FEISHU_APP_ID / FEISHU_APP_SECRET / FEISHU_DOMAIN / FEISHU_ACCOUNTS | feishu-connector |
WECOM_BOT_ID / WECOM_SECRET / WECOM_CORP_ID / WECOM_WEBSOCKET_URL | wecom-connector |
DINGTALK_* | dingtalk-connector |
警告：不要使用
FEISHU_BIND_*/WECOM_BIND_*/DINGTALK_BIND_*env 变量。INTERNAL_SERVICE_TOKEN在连接器侧仅用于校验内部调用，不参与渠道鉴权。
渠道接入外网地址
| 渠道 | 外网域名 |
|---|---|
| 飞书 | open.feishu.cn、open.larksuite.com、附件 CDN |
| 企业微信 | qyapi.weixin.qq.com、*.work.weixin.qq.com、腾讯 CDN |
| 钉钉 | oapi.dingtalk.com、*.dingtalk.com |
Persona 模板
config/persona-templates/ 下提供多种角色模板：
finclaw-lobster、research-partner、wiki-agent、writing-partner等- 每个模板包含
SOUL.md/IDENTITY.md/AGENT.md等定义文件 persona-templates.json为索引文件
模板可在 Admin -> Tenant -> Personas 页面绑定到具体租户；新模板需重启 persona-service 才能加载。
技能服务
config/skill-service.yaml 配置技能服务；config/mcp-servers.yaml.example 为 MCP 服务器配置模板。
| 变量 | 默认值 | 说明 |
|---|---|---|
AI_INFRA_RS_SKILLS_ENABLED | true | 是否启用技能运行时 |
AI_INFRA_RS_SKILLS_CUSTOM_DIRS | - | 自定义技能目录（逗号分隔） |
AI_INFRA_RS_SKILLS_USE_STANDARD_LOCATIONS | true | 是否使用标准技能目录 |
AI_INFRA_RS_SKILLS_INCLUDE_WORKSPACE_SKILLS | true | 是否包含工作区技能 |
MCP 服务器配置路径通过 AI_INFRA_RS_MCP_SERVERS_CONFIG_PATH 指定，默认读取 config/mcp-servers.yaml。
管理员与会话
| 变量 | 说明 |
|---|---|
ADMIN_EMAILS | 管理员邮箱（逗号分隔），决定管理员权限，修改后需重启 |
AUTH_MODE | 认证模式：mixed / local / oidc |
IDP_PUBLIC_KEY | IdP 公钥（OIDC 模式必填） |
LOGINSERVER_URL | 登录服务 URL |
APP_URL | 应用 URL（如 http://localhost:26100） |
OIDC_STATE_COOKIE_SECRET | OIDC state cookie 密钥 |
SESSION_COOKIE_NAME / SESSION_COOKIE_SECRET | 会话 cookie 名/密钥 |
SESSION_IDLE_TIMEOUT_DAYS | 会话空闲超时（默认 7） |
SESSION_ABSOLUTE_TIMEOUT_DAYS | 会话绝对超时（默认 30） |
IFRAME_PARENT_ORIGINS | iframe 父源（CSP frame-ancestors；嵌入 iframe 时必填） |
存储与上传
| 变量 | 默认值 | 说明 |
|---|---|---|
MAX_FILE_SIZE | 52428800 (50MiB) | 上传文件大小上限 |
WORKSPACE_FILES_BASE_PATH | - | 工作区文件基路径（容器内通常为 /app/data/workspaces） |
MEMORY_FILES_BASE_PATH | - | 记忆文件基路径 |
AI_INFRA_RS_MEMORY_FILES_BASE_PATH | - | claw 侧记忆文件基路径 |
AI_INFRA_RS_MEMORY_SESSIONS_BASE_PATH | - | claw 侧记忆会话基路径 |
AI_INFRA_RS_MEMORY_INDEX_PATH | - | SQLite 索引路径（向量检索） |
AI_INFRA_RS_MEMORY_VECTOR_ENABLED | - | 是否启用向量检索 |
AI_INFRA_RS_AUDIT_PATH | - | 审计日志路径 |
AG-UI
| 变量 | 默认值 | 说明 |
|---|---|---|
RUN_RESUME_ENABLED | true | AG-UI resume 是否启用（设 0 / false 关闭） |