配置参考

本页收集 Jarvis 的公开配置面。它是参考页，不是完整部署 runbook。

配置层

层级	真源	说明
Jarvis 服务设置	.env 与 JARVIS_* 变量	基础设施和功能开关
主聊天模型选择	模型池 UI	主会话模型选择的首选入口
运行时默认值	运行时本地 CLI 配置	Claude Code、Codex、OpenCode 保持自己的本地配置
工作会话汇报工具	Jarvis 托管注入	面向托管编码会话

主要环境变量

变量	类型	默认值	含义
JARVIS_API_KEY	string	未设置	认证 Jarvis 请求。本地生成并保存。
JARVIS_PORT	integer	8888	Jarvis HTTP 服务端口。
JARVIS_FORCE_HTTP	boolean-like string	未设置	设为 1 时，源码启动脚本跳过本地 TLS 自动检测，固定使用 HTTP。
JARVIS_AUTH_ALWAYS_REQUIRED	boolean-like string	0	设为 1 时，关闭 loopback 认证绕过，所有请求都必须带 API key。
JARVIS_DATA_DIR	path string	运行模式相关	覆盖 Jarvis 数据目录。无头或多实例运行时，用它隔离 DB、日志和备份。
JARVIS_DATABASE_PATH	path string	data/jarvis.db	SQLite 数据库路径。
JARVIS_DEFAULT_MODEL	string	未设置	模型池没有活跃选择时的回退聊天模型。

内置模型提供商凭证

Jarvis 为部分内置模型提供商提供可选凭证槽位。公开示例只写变量名，不写真实值。

变量	用途
JARVIS_OPENAI_API_KEY	启用内置 OpenAI 模型提供商槽位
JARVIS_YUNWU_API_KEY	启用内置 Yunwu 模型提供商槽位
JARVIS_DEEPSEEK_API_KEY	启用内置 DeepSeek 模型提供商槽位
JARVIS_GLM51_API_KEY	启用内置 GLM 模型提供商槽位

相关 base URL 变量也可能出现在 .env.example 中。大多数用户只有在使用非默认端点时才需要设置。

模型池与 .env

规则很简单：

• 基础设施和内置模型提供商凭证 放在 .env。
• 主聊天模型选择 放在模型池 UI。

模型池是选择和切换主 Jarvis 模型的首选公开入口。

运行时 CLI 配置

Jarvis 不重复维护以下运行时的本地配置：

• Claude Code
• Codex
• OpenCode

公开文档应描述为：运行时使用自己的本地 CLI 配置，Jarvis 在其周围启动、发现和管理会话。

运行时相关变量

变量	用途
CODING_AGENT_MODE	选择编码 Agent 执行后端。
OPENCODE_SERVER_URL	指向本地 OpenCode 边车服务端点。
OPENCODE_RUNTIME_MODE	选择本地 OpenCode 提供方式。

其他运行时变量可能存在于 .env.example，其中不少属于高级或调试场景。不要在不了解运行时的情况下修改。

本地模型变量

Jarvis 也可以指向本地 OpenAI-compatible 模型端点：

变量	用途
JARVIS_LOCAL_BASE_URL	本地模型 API 的 base URL
JARVIS_LOCAL_MODEL	本地端点使用的模型标识

留空即禁用本地模型路由。

权限和汇报工具

托管编码会话会获得面向工作会话的汇报工具，包括 report_progress、notify_blocked、ask_human 和 request_context。可选的 search_kb 在未配置知识库时应优雅降级。

脱敏要求

公开配置示例绝不能包含：

• 真实 API 密钥；
• 个人文件系统路径；
• 私有服务器地址；
• 原始私有日志；
• 私有知识库正文。

相关页面

• 配置总览
• 配置模型提供商
• 无头 Linux 后端
• 配置档
• 权限
• 工具