配置说明
所有配置通过环境变量设置（从 .env 文件加载，支持热重载）。
必需
| 变量 | 说明 |
|---|---|
LLM_API_KEY | LLM 供应商 API 密钥 |
核心配置
| 变量 | 默认值 | 说明 |
|---|---|---|
HTTP_PORT | 9090 | HTTP 服务端口 |
API_KEY | (无) | API 认证密钥 (首次启动会引导设置) |
JWT_SECRET | (无) | JWT 签名密钥 |
LOG_LEVEL | info | 日志级别 (debug/info/warn/error) |
LLM 配置
| 变量 | 默认值 | 说明 |
|---|---|---|
LLM_BASE_URL | https://api.openai.com/v1 | LLM API 地址 |
LLM_MODEL | gpt-4o-mini | 默认模型 |
LLM_FAST_MODEL | (自动) | 快速模型 (简单任务) |
LLM_SMART_MODEL | (自动) | 智能模型 (一般任务) |
LLM_EXPERT_MODEL | (自动) | 专家模型 (复杂推理) |
支持通过 Web UI 动态注册多个 LLM 提供者 (OpenAI/Anthropic/Google/本地模型等)。
消息渠道
| 变量 | 说明 |
|---|---|
TELEGRAM_BOT_TOKEN | Telegram 机器人令牌 |
FEISHU_APP_ID / FEISHU_APP_SECRET | 飞书应用凭据 |
DISCORD_BOT_TOKEN | Discord 机器人令牌 |
SLACK_BOT_TOKEN | Slack 机器人令牌 |
WHATSAPP_TOKEN | WhatsApp 令牌 |
SIGNAL_CLI_PATH | Signal CLI 路径 |
EMAIL_IMAP_* / EMAIL_SMTP_* | 邮箱 IMAP/SMTP 配置 |
WECOM_CORPID / WECOM_AGENT_ID / WECOM_SECRET | 企业微信凭据 |
DINGTALK_CLIENT_ID / DINGTALK_CLIENT_SECRET | 钉钉凭据 |
WECHAT_OA_APPID / WECHAT_OA_SECRET | 微信公众号凭据 |
LINE_CHANNEL_SECRET / LINE_CHANNEL_TOKEN | LINE 凭据 |
KOOK_TOKEN | Kook 机器人令牌 |
QQ_APP_ID / QQ_APP_SECRET | QQ 官方 Bot 凭据 |
SATORI_ENDPOINT | Satori 协议端点 |
RAG 与嵌入
| 变量 | 说明 |
|---|---|
EMBEDDING_MODEL | 嵌入模型名称 |
JINA_API_KEY | Jina Reranker API 密钥 |
COHERE_API_KEY | Cohere Reranker API 密钥 |
沙箱
| 变量 | 说明 |
|---|---|
SANDBOX_BACKEND | 沙箱后端：process、docker、k8s、wasm |
SANDBOX_DOCKER_IMAGE | 沙箱 Docker 镜像 |
E2B_API_KEY | E2B Desktop 沙箱 API 密钥 |
其他
| 变量 | 说明 |
|---|---|
WEBSEARCH_ENGINE | 网页搜索引擎 (searxng/google/bing/duckduckgo) |
SPEECH_* | 语音合成/识别配置 |
MINERU_API_URL | MinerU 文档解析 API |
配置热重载
云雀支持配置文件热重载 — .env 文件修改后自动加载，无需重启服务。通过 ConfigLoader 实现，支持注册变更处理器。