常见问题
配置文件说明
Olenro 数据存储
存储目录
默认位置:~/.olenro/
可在设置中自定义位置(用于云同步)。
目录结构
~/.olenro/
├── olenro.db # SQLite 数据库(SSOT)
├── settings.json # 设备级设置
├── skills/ # 技能 SSOT 目录
├── skill-backups/ # 技能备份(卸载时创建)
└── db_backup_*.db # 数据库备份数据库内容
olenro.db 是 SQLite 数据库,存储:
| 表 | 内容 |
|---|---|
| providers | 供应商配置 |
| provider_endpoints | 供应商端点候选列表 |
| mcp_servers | MCP 服务器配置 |
| prompts | 提示词预设 |
| skills | 技能安装状态 |
| skill_repos | 技能仓库配置 |
| proxy_config | 代理配置 |
| proxy_request_logs | 代理请求日志 |
| provider_health | 供应商健康状态 |
| model_pricing | 模型定价 |
| settings | 应用设置 |
设备设置
settings.json 存储设备级设置:
{
"language": "zh",
"theme": "system",
"windowBehavior": "minimize",
"autoStart": false,
"claudeConfigDir": null,
"codexConfigDir": null,
"geminiConfigDir": null,
"opencodeConfigDir": null,
"openclawConfigDir": null
}这些设置不会跨设备同步。
自动备份
backups/ 目录存储自动备份:
- 每次导入配置前自动创建
- 保留最近 10 个备份
- 文件名包含时间戳
Claude Code 配置
配置目录
默认:~/.claude/
主要文件
~/.claude/
├── settings.json # 主配置文件
├── CLAUDE.md # 系统提示词
└── skills/ # 技能目录
└── ...settings.json
{
"env": {
"ANTHROPIC_API_KEY": "sk-xxx",
"ANTHROPIC_BASE_URL": "https://api.anthropic.com"
},
"permissions": {
"allow_file_access": true
}
}| 字段 | 说明 |
|---|---|
env.ANTHROPIC_API_KEY | API 密钥 |
env.ANTHROPIC_BASE_URL | API 端点(可选) |
env.ANTHROPIC_AUTH_TOKEN | 替代认证方式 |
MCP 配置
MCP 服务器配置在 ~/.claude.json:
{
"mcpServers": {
"mcp-fetch": {
"command": "uvx",
"args": ["mcp-server-fetch"]
}
}
}Codex 配置
配置目录
默认:~/.codex/
主要文件
~/.codex/
├── auth.json # 认证配置
├── config.toml # 主配置 + MCP
└── AGENTS.md # 系统提示词auth.json
{
"OPENAI_API_KEY": "sk-xxx"
}config.toml
# 基础配置
base_url = "https://api.openai.com/v1"
model = "gpt-4"
# MCP 服务器
[mcp_servers.mcp-fetch]
command = "uvx"
args = ["mcp-server-fetch"]Gemini CLI 配置
配置目录
默认:~/.gemini/
主要文件
~/.gemini/
├── .env # 环境变量(API Key)
├── settings.json # 主配置 + MCP
└── GEMINI.md # 系统提示词.env
GEMINI_API_KEY=xxx
GOOGLE_GEMINI_BASE_URL=https://generativelanguage.googleapis.com
GEMINI_MODEL=gemini-prosettings.json
{
"mcpServers": {
"mcp-fetch": {
"command": "uvx",
"args": ["mcp-server-fetch"]
}
}
}| 字段 | 说明 |
|---|---|
mcpServers | MCP 服务器配置 |
OpenCode 配置
配置目录
默认:~/.opencode/
主要文件
~/.opencode/
├── config.json # 主配置文件
├── AGENTS.md # 系统提示词
└── skills/ # 技能目录
└── ...OpenClaw 配置
配置目录
默认:~/.openclaw/
主要文件
~/.openclaw/
├── openclaw.json # 主配置文件(JSON5 格式)
├── AGENTS.md # 系统提示词
└── skills/ # 技能目录
└── ...openclaw.json
OpenClaw 使用 JSON5 格式配置文件,主要包含以下部分:
{
// 模型供应商配置
models: {
mode: "merge",
providers: {
"custom-provider": {
baseUrl: "https://api.example.com/v1",
apiKey: "your-api-key",
api: "openai-completions",
models: [{ id: "model-id", name: "Model Name" }]
}
}
},
// 环境变量
env: {
ANTHROPIC_API_KEY: "sk-..."
},
// Agent 默认模型配置
agents: {
defaults: {
model: {
primary: "provider/model"
}
}
},
// 工具配置
tools: {},
// 工作区文件配置
workspace: {}
}| 字段 | 说明 |
|---|---|
models.providers | 供应商配置(映射为 Olenro 的"供应商") |
env | 环境变量配置 |
agents.defaults | Agent 默认模型设置 |
tools | 工具配置 |
workspace | 工作区文件管理 |
配置优先级
Olenro 修改配置时的优先级:
- Olenro 数据库 - 单一事实源 (SSOT)
- Live 配置文件 - 切换供应商时写入
- 回填机制 - 编辑当前供应商时从 Live 文件读取
手动编辑配置
可以手动编辑
- CLI 工具的配置文件(会被 Olenro 回填)
- Olenro 的
settings.json
不建议手动编辑
olenro.db数据库文件- 备份文件
编辑后同步
如果手动编辑了 CLI 工具的配置:
- 打开 Olenro
- 编辑对应的供应商
- 会看到手动修改的内容已回填
- 保存以同步到数据库
配置迁移
从旧版本迁移
Olenro v3.7.0 从 JSON 文件迁移到 SQLite:
- 首次启动自动迁移
- 迁移成功后显示提示
- 旧配置文件保留作为备份
跨设备迁移
- 在源设备导出配置
- 在目标设备导入配置
- 或使用云同步功能
配置备份建议
定期备份
建议定期导出配置:
- 设置 → 高级 → 数据管理
- 点击「导出」
- 保存到安全位置
备份内容
导出文件包含:
- 所有供应商配置
- MCP 服务器配置
- Prompts 预设
- 应用设置
不包含的内容
- 用量日志(数据量大)
- 设备级设置(不适合跨设备)