Olenro
よくある質問

設定ファイルの説明

Olenro のデータストレージ

ストレージディレクトリ

デフォルトの場所:~/.olenro/

設定で場所をカスタマイズ可能です(クラウド同期用)。

ディレクトリ構造

~/.olenro/
├── olenro.db      # SQLite データベース(SSOT)
├── settings.json     # デバイスレベルの設定
├── skills/           # スキル SSOT ディレクトリ
├── skill-backups/    # スキルバックアップ(アンインストール時に作成)
└── db_backup_*.db    # データベースバックアップ

データベースの内容

olenro.db は SQLite データベースで、以下を保存しています:

テーブル内容
providersプロバイダー設定
provider_endpointsプロバイダーエンドポイント候補リスト
mcp_serversMCP サーバー設定
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_KEYAPI キー
env.ANTHROPIC_BASE_URLAPI エンドポイント(任意)
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-pro

settings.json

{
  "mcpServers": {
    "mcp-fetch": {
      "command": "uvx",
      "args": ["mcp-server-fetch"]
    }
  }
}
フィールド説明
mcpServersMCP サーバー設定

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.defaultsAgent デフォルトモデル設定
toolsツール設定
workspaceワークスペースファイル管理

設定の優先順位

Olenro が設定を変更する際の優先順位:

  1. Olenro データベース - 単一事実源 (SSOT)
  2. Live 設定ファイル - プロバイダー切り替え時に書き込み
  3. バックフィル機能 - 現在のプロバイダーの編集時に Live ファイルから読み取り

手動での設定編集

手動編集可能なもの

  • CLI ツールの設定ファイル(Olenro がバックフィルする)
  • Olenro の settings.json

手動編集を推奨しないもの

  • olenro.db データベースファイル
  • バックアップファイル

編集後の同期

CLI ツールの設定を手動で編集した場合:

  1. Olenro を開く
  2. 対応するプロバイダーを編集
  3. 手動変更の内容がバックフィルされていることを確認
  4. 保存してデータベースに同期

設定の移行

旧バージョンからの移行

Olenro v3.7.0 で JSON ファイルから SQLite に移行しました:

  • 初回起動時に自動的に移行
  • 移行成功後に通知を表示
  • 旧設定ファイルはバックアップとして保持

デバイス間の移行

  1. 移行元のデバイスで設定をエクスポート
  2. 移行先のデバイスで設定をインポート
  3. またはクラウド同期機能を使用

設定のバックアップに関するアドバイス

定期的なバックアップ

定期的に設定をエクスポートすることを推奨します:

  1. 設定 → 詳細 → データ管理
  2. 「エクスポート」をクリック
  3. 安全な場所に保存

バックアップに含まれる内容

エクスポートファイルには以下が含まれます:

  • すべてのプロバイダー設定
  • MCP サーバー設定
  • Prompts プリセット
  • アプリ設定

含まれない内容

  • 使用量ログ(データ量が大きいため)
  • デバイスレベルの設定(デバイス間の移動に適さないため)

目次