个性化配置

特性	最小化到托盘	轻量模式
UI 进程	保留在内存中	完全销毁
空闲资源占用	与正常运行相当	接近零
再次打开速度	瞬时（直接显示）	略慢（需要重建窗口）
托盘切换功能	可用	可用
深链接唤起	可用	可用（按需重建）

💡 使用场景：如果你 Olenro 长时间常驻后台，主要通过托盘菜单切换供应商，开启轻量模式能显著降低内存占用。

⚠️ 注意：轻量模式状态不持久 — 下次正常启动时会回到普通模式。需要长期使用可搭配开机自启。

Claude 插件集成

开启后，Olenro 在切换供应商时会自动同步配置到 VS Code 中的 Claude Code 插件（写入 ~/.claude/config.json 的 primaryApiKey）。

💡 使用场景：如果你同时使用 Claude Code CLI 和 VS Code 插件，开启此选项可以保持两者配置一致。

跳过 Claude 引导

开启后，跳过 Claude Code 的新手引导流程，适合已熟悉 Claude Code 的用户。

⚠️ 注意：此选项会写入 ~/.claude/settings.json 的 skipIntroduction 字段。

应用可见性

选择在应用切换器中显示哪些应用。每个应用可以独立开关，但至少保留一个。

可配置的应用：Claude、Claude Desktop、Codex、Gemini、OpenCode、OpenClaw、Hermes。

💡 使用场景：如果你只使用 Claude Code 和 Codex CLI，可以隐藏其他应用，保持界面简洁。

Skills 同步方式

设置技能安装到各应用目录时的同步方式：

方式	说明
软链接（Symlink）	创建符号链接指向技能源文件，占用空间小，更新实时同步
复制（Copy）	将技能文件完整复制到目标目录

💡 推荐：默认使用软链接方式。如果遇到权限问题，可切换为复制方式。

终端设置

选择 Olenro 打开终端时使用的终端应用程序。

支持的终端（按平台）：

平台	终端选项
macOS	Terminal、iTerm2、Alacritty、Kitty、Ghostty、WezTerm
Windows	CMD、PowerShell、Windows Terminal
Linux	GNOME Terminal、Konsole、Xfce4 Terminal、Alacritty、Kitty、Ghostty

目录配置

应用配置目录

Olenro 自身数据的存储位置，默认为 ~/.olenro/。

CLI 工具目录

可以自定义各 CLI 工具的配置目录：

配置	默认值	说明
Claude 目录	`~/.claude/`	Claude Code 配置目录
Codex 目录	`~/.codex/`	Codex 配置目录
Gemini 目录	`~/.gemini/`	Gemini CLI 配置目录
OpenCode 目录	`~/.opencode/`	OpenCode 配置目录
OpenClaw 目录	`~/.openclaw/`	OpenClaw 配置目录

⚠️ 注意：修改目录后需要重启应用，且对应的 CLI 工具也需要配置相同的目录。

数据管理

导出配置

点击「导出」按钮，保存包含以下内容的备份文件：

所有供应商配置
MCP 服务器配置
Prompts 预设
应用设置

备份文件格式为 JSON，可以用文本编辑器查看。

导入配置

点击「选择文件」
选择之前导出的备份文件
点击「导入」
确认覆盖现有配置

⚠️ 注意：导入会覆盖现有配置，建议先导出当前配置作为备份。

代理设置

设置 → 代理 Tab

代理 Tab 集中管理所有代理相关功能：

本地代理

启动/停止本地代理服务，配置监听地址和端口。详见 4.1 代理服务。

故障转移

按应用（Claude/Codex/Gemini）配置故障转移队列和自动切换策略。详见 4.3 故障转移。

定价矫正器

配置模型定价矫正规则，用于代理计费统计的校准。

全局出站代理

配置 Olenro 的出站 HTTP/HTTPS 代理，适用于需要通过代理访问外部 API 的场景。

高级设置

设置 → 高级 Tab

配置目录

自定义各应用的配置文件目录。详见下方「目录配置」章节。

数据管理

导入/导出配置备份。详见下方「数据管理」章节。

备份与恢复

备份管理面板提供对数据库备份的全面控制。

自动备份设置

配置	选项	默认值
备份间隔	禁用、6h、12h、24h、48h、7d	24 小时
保留数量	3、5、10、15、20、30、50	10 个备份

设置间隔后，Olenro 会按计划自动备份数据库。超出保留数量的旧备份会自动删除。

备份列表

面板显示所有现有备份，包含：

显示名称（根据时间戳自动生成，如 db_backup_20260315_143000）
创建时间
文件大小（如 "1.5 MB"）

备份操作

操作	说明
立即备份	立即创建一个备份
恢复	从选定的备份恢复数据库。恢复前会自动创建当前数据库的安全备份
重命名	修改备份的显示名称
删除	永久删除备份（需确认）

⚠️ 重要：恢复备份会覆盖当前数据库。恢复操作前始终会自动创建安全备份，以便在需要时恢复。

云同步（WebDAV）

通过 WebDAV 协议在多台设备间同步配置。使用 v2 协议，支持双层版本控制，提高可靠性。

配置项	说明
服务预设	坚果云 / Nextcloud / 群晖 / 自定义
服务地址	WebDAV 服务器 URL
用户名	登录用户名
密码	登录密码（应用专用密码；已保存的凭据在未修改时会被保留）
远程目录	远程存储路径（默认 `olenro-sync`）
配置名称	设备配置文件名（默认 `default`）
自动同步	开启后按配置的间隔自动同步

操作

操作	说明
测试连接	验证 WebDAV URL、用户名和密码是否有效
上传	将本地数据库上传到远程，显示进度指示器
下载	下载远程数据库。下载前显示远程快照信息（协议版本、数据库版本、时间戳、大小）供确认。覆盖本地数据库前会自动创建安全备份

自动同步

启用 自动同步 后：

首次激活时会显示确认对话框
Olenro 按配置的间隔自动将数据库同步到 WebDAV
面板中显示同步状态

远程快照信息

下载前，Olenro 会显示远程快照的详细信息：

协议版本（v2）
数据库兼容版本
远程备份的时间戳
文件大小
兼容性状态（不兼容时显示警告）

⚠️ 注意：上传会覆盖远程数据，下载会覆盖本地数据。下载前始终会自动创建安全备份。

日志配置

配置项	说明
启用日志	开启/关闭应用日志记录
日志级别	error / warn / info / debug / trace

日志级别说明：

error - 仅记录错误
warn - 记录警告和错误
info - 记录一般信息（推荐）
debug - 记录调试信息
trace - 记录所有详细信息

OAuth 认证中心（Beta）

设置 → OAuth 认证中心 Tab

v3.13.0 新增的 OAuth 认证中心（Beta）统一管理第三方 OAuth 凭据，目前支持两类账号：

账号类型	用途
GitHub Copilot	配合 Copilot 反向代理使用
ChatGPT (Codex OAuth)	配合 Codex OAuth 反向代理使用，管理 ChatGPT 账号

你可以在这里：

通过 Device Code 流程登录 ChatGPT / GitHub 账号
查看已登录账号列表和认证状态
为多账号设置默认账号
移除单个账号或一键注销所有账号

⚠️ 注意：这两项功能使用逆向 OAuth 流程，存在账号风险和服务条款风险。使用前请阅读 2.1 添加供应商 → Codex OAuth 反向代理的完整风险提示。

关于页面

设置 → 关于 Tab

版本信息

显示当前 Olenro 版本号，支持：

查看发布说明
检查更新
下载并安装新版本

本地环境检查

自动检测已安装的 CLI 工具版本：

工具	检测内容
Claude	当前版本、最新版本
Codex	当前版本、最新版本
Gemini	当前版本、最新版本
OpenCode	当前版本、最新版本
OpenClaw	当前版本、最新版本
Hermes	当前版本、最新版本

点击「刷新」按钮可重新检测；检测到新版时可单独升级，也可以点击「全部升级」。未检测到的工具会显示安装按钮。安装与升级在后台静默执行，按钮上会显示进度，完成后自动刷新版本。

手动安装命令

提供快速安装/升级 CLI 工具的命令（该区域默认折叠，点击标题展开）：

npm i -g @anthropic-ai/claude-code@latest
npm i -g @openai/codex@latest
npm i -g @google/gemini-cli@latest
npm i -g opencode-ai@latest
npm i -g openclaw@latest
python3 -m pip install --upgrade "hermes-agent[web]"

点击「复制」按钮可复制到剪贴板。

本页内容