Olenro
はじめに

個人設定

このセクションでは、個人の好みに合わせて Olenro を設定する方法を説明します。

設定を開く

  • 左上の ⚙️ ボタンをクリック
  • またはショートカット Cmd/Ctrl + ,

言語設定

Olenro は 3 つの言語に対応しています:

言語説明
簡体中文デフォルト言語
English英語インターフェース
日本語日本語インターフェース

言語を切り替えると即座に反映され、再起動は不要です。

テーマ設定

オプション説明
システムに合わせるシステムのダーク/ライトモードに自動的に合わせる
ライト常にライトテーマを使用
ダーク常にダークテーマを使用

ウィンドウ動作

起動時に自動実行

有効にすると、システム起動時に Olenro が自動的に起動します。

  • Windows:レジストリを使用
  • macOS:LaunchAgent を使用
  • Linux:XDG autostart を使用

閉じる動作

オプション説明
トレイへ最小化閉じるボタンをクリックするとシステムトレイに隠す
直接終了閉じるボタンをクリックするとアプリを完全に終了

トレイからプロバイダーを素早く切り替えられるため、「トレイへ最小化」の使用を推奨します。

軽量モード

v3.13.0 より、Olenro に 軽量モード が追加されました — アイドル時のデスクトップ占有を最小限に抑える トレイのみ実行状態 です。

開始方法:トレイアイコンを右クリック → 軽量モード をクリック。メインウィンドウは 破棄(単に非表示ではなく)され、UI リソースとメモリが解放されます。

終了方法:トレイメニューから メインウィンドウを開く をクリック、またはディープリンク / 再起動で Olenro を呼び出します。ウィンドウは 必要に応じて再構築 され、状態は保持されます。

項目トレイへ最小化軽量モード
UI プロセスメモリに保持完全に破棄
アイドル時リソース通常実行と同じほぼゼロ
再表示速度瞬時(直接表示)やや遅い(ウィンドウ再構築)
トレイ切り替え利用可能利用可能
ディープリンク起動利用可能利用可能(必要時再構築)

使用シーン:Olenro を長時間バックグラウンドに常駐させ、主にトレイメニューからプロバイダーを切り替える場合、軽量モードを有効にするとメモリ使用量を大幅に削減できます。

注意:軽量モードの状態は永続化されません — 次回の通常起動では通常モードに戻ります。長期的に使用する場合は「起動時に自動実行」と組み合わせてください。

Claude プラグイン連携

有効にすると、Olenro はプロバイダー切り替え時に VS Code の Claude Code 拡張に設定を自動同期します(~/.claude/config.jsonprimaryApiKey に書き込み)。

使用シーン:Claude Code CLI と VS Code プラグインを同時に使用する場合、このオプションを有効にすると両方の設定を一致させることができます。

Claude 初回ガイドのスキップ

有効にすると、Claude Code の初回ガイドフローをスキップします。Claude Code に慣れているユーザー向けです。

注意:このオプションは ~/.claude/settings.jsonskipIntroduction フィールドに書き込まれます。

アプリの表示設定

アプリ切り替えに表示するアプリを選択します。各アプリを個別にオン/オフできますが、少なくとも 1 つは有効にする必要があります。

設定可能なアプリ:Claude、Claude Desktop、Codex、Gemini、OpenCode、OpenClaw、Hermes。

使用シーン:Claude Code と Codex CLI のみを使用する場合、他のアプリを非表示にしてインターフェースをシンプルに保てます。

Skills 同期方式

スキルを各アプリディレクトリにインストールする際の同期方式を設定します:

方式説明
シンボリックリンクスキルのソースファイルへのシンボリックリンクを作成、容量が少なく、リアルタイム同期
ファイルコピースキルファイルをターゲットディレクトリに完全コピー

推奨:デフォルトではシンボリックリンク方式を使用します。権限の問題が発生する場合は、コピー方式に切り替えてください。

ターミナル設定

Olenro がターミナルを開く際に使用するターミナルアプリケーションを選択します。

対応ターミナル(プラットフォーム別):

プラットフォームターミナル選択肢
macOSTerminal、iTerm2、Alacritty、Kitty、Ghostty、WezTerm
WindowsCMD、PowerShell、Windows Terminal
LinuxGNOME 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 形式で、テキストエディタで確認できます。

設定のインポート

  1. 「ファイルを選択」をクリック
  2. 以前にエクスポートしたバックアップファイルを選択
  3. 「インポート」をクリック
  4. 既存の設定の上書きを確認

注意:インポートは既存の設定を上書きするため、事前に現在の設定をエクスポートしてバックアップすることをお勧めします。

プロキシ設定

設定 → プロキシ タブ

プロキシ タブではすべてのプロキシ関連機能を集中管理します:

ローカルプロキシ

ローカルプロキシサービスの起動/停止、リスニングアドレスとポートの設定。詳しくは 4.1 プロキシサービス をご覧ください。

フェイルオーバー

アプリ(Claude/Codex/Gemini)ごとにフェイルオーバーキューと自動切り替え戦略を設定。詳しくは 4.3 フェイルオーバー をご覧ください。

料金補正器

モデル料金補正ルールを設定し、プロキシの課金統計を調整します。

グローバル送信プロキシ

Olenro の送信 HTTP/HTTPS プロキシを設定します。外部 API にプロキシ経由でアクセスする必要がある場合に使用します。

詳細設定

設定 → 詳細 タブ

設定ディレクトリ

各アプリの設定ファイルディレクトリをカスタマイズ。下記の「ディレクトリ設定」セクションを参照してください。

データ管理

設定バックアップのインポート/エクスポート。下記の「データ管理」セクションを参照してください。

バックアップと復元

バックアップ管理パネルでは、データベースバックアップを完全に管理できます。

自動バックアップ設定

設定オプションデフォルト
バックアップ間隔無効、6時間、12時間、24時間、48時間、7日24時間
保持数3、5、10、15、20、30、5010件

間隔を設定すると、Olenro はスケジュールに従って自動的にデータベースをバックアップします。保持数を超えた古いバックアップは自動的に削除されます。

バックアップリスト

パネルには既存のすべてのバックアップが以下の情報とともに表示されます:

  • 表示名(タイムスタンプから自動生成、例:db_backup_20260315_143000
  • 作成日時
  • ファイルサイズ(例:「1.5 MB」)

バックアップ操作

操作説明
今すぐバックアップ即座にバックアップを作成
復元選択したバックアップからデータベースを復元。復元前に現在のデータベースの安全バックアップが自動的に作成される
名前変更バックアップの表示名を変更
削除バックアップを完全に削除(確認あり)

重要:バックアップの復元は現在のデータベースを上書きします。復元前に安全バックアップが自動作成されるため、必要に応じて元に戻すことができます。

クラウド同期(WebDAV)

WebDAV プロトコルを使用して複数のデバイス間で設定を同期します。信頼性の向上のため、デュアルレイヤーバージョニングを備えた v2 プロトコル を使用しています。

設定項目説明
サービスプリセット坚果云 / Nextcloud / Synology / カスタム
サーバー URLWebDAV サーバー URL
ユーザー名ログインユーザー名
パスワードログインパスワード(アプリ専用パスワード、保存済みの場合は未変更で保持)
リモートディレクトリリモート保存パス(デフォルト olenro-sync
プロファイル名デバイスプロファイル名(デフォルト default
自動同期設定可能な間隔で自動同期を有効化

操作

操作説明
接続テストWebDAV の URL、ユーザー名、パスワードが有効か確認
アップロードローカルデータベースをリモートにアップロード。進捗スピナーを表示
ダウンロードリモートデータベースをダウンロード。確認前にリモートスナップショット情報(プロトコルバージョン、DB バージョン、タイムスタンプ、サイズ)を表示。上書き前にローカルデータベースの安全バックアップを自動作成

自動同期

自動同期 を有効にすると:

  • 初回有効化時に確認ダイアログが表示される
  • Olenro は設定された間隔で自動的にデータベースを WebDAV に同期
  • 同期ステータスがパネルに表示される

リモートスナップショット情報

ダウンロード前に、Olenro はリモートスナップショットの詳細を表示します:

  • プロトコルバージョン(v2)
  • データベース互換バージョン
  • リモートバックアップのタイムスタンプ
  • ファイルサイズ
  • 互換性ステータス(非互換の場合は警告)

注意:アップロードはリモートデータを、ダウンロードはローカルデータを上書きします。ダウンロード前に安全バックアップが自動作成されます。

ログ設定

設定項目説明
ログを有効化アプリのログ記録のオン/オフ
ログレベルerror / warn / info / debug / trace

ログレベルの説明:

  • error - エラーのみ記録
  • warn - 警告とエラーを記録
  • info - 一般情報を記録(推奨)
  • debug - デバッグ情報を記録
  • trace - すべての詳細情報を記録

OAuth 認証センター(Beta)

設定 → OAuth 認証センター タブ

v3.13.0 で追加された OAuth 認証センター(Beta)は、サードパーティの OAuth 認証情報を一元管理します。現在、以下の 2 種類のアカウントタイプをサポートしています:

アカウントタイプ用途
GitHub CopilotCopilot リバースプロキシと組み合わせて使用
ChatGPT (Codex OAuth)Codex OAuth リバースプロキシと組み合わせて使用、ChatGPT アカウントを管理

ここでできること

  • Device Code フローで ChatGPT / GitHub アカウントにログイン
  • ログイン済みアカウント一覧と認証状態の確認
  • マルチアカウント時のデフォルトアカウント設定
  • 個別アカウントの削除や全アカウントの一括ログアウト

注意:これら 2 つの機能はリバースエンジニアリングされた OAuth フローを使用するため、アカウントリスクおよび利用規約リスクが存在します。ご利用前に 2.1 プロバイダーの追加 → Codex OAuth リバースプロキシ の完全なリスク通知をお読みください。

バージョン情報ページ

設定 → バージョン情報 タブ

バージョン情報

現在の 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]"

「コピー」ボタンでクリップボードにコピーできます。

目次