open-webui v0.12.4リリース:コンテキスト圧縮の改善とスキル遅延読み込み

open-webui v0.12.4リリース:コンテキスト圧縮の改善とスキル遅延読み込み

基本情報

項目 内容
リポジトリ open-webui/open-webui
版 v0.12.4
公開日 2026-10-25
ライセンス NOASSERTION
出典の種類 公開元の一次情報(公式GitHubリポジトリのリリースノートが一次情報)

情報を集めた時点で、当サイトのコードが確定させた値です。日付はJSTで表示しています。

概要

LLM向けのWebユーザーインターフェースであるopen-webuiの最新バージョン「v0.12.4」が公開されました。open-webuiはOllamaやOpenAI互換APIなど多様なバックエンドに対応し、ローカル環境で直感的にLLMを操作できるPythonベースのWeb UIツールです。

今回の更新では、スキルのオンデマンド読み込み機能の追加や、コンテキスト圧縮(Compaction)の改善が行われました。特に大量のツール出力を含む短いやり取りでもコンテキスト圧縮が動作するようになり、コンテキスト長制限によるエラーで会話が中断する問題が解消されています。大量のプロンプト消費を抑えたい方や、ツール呼び出しを多用するユーザーにとって実用性の高いアップデートとなっています。

主な変更点

スキルのオンデマンド読み込みに対応

チャットで選択されたスキルやモデルに紐付けられたスキルの指示文を、毎回のメッセージ送信時に全文送信するのではなく、モデルが必要としたタイミングでのみ読み込む機能が追加されました。メッセージ内で直接メンションされたスキルはこれまで通り即座に読み込まれます。この機能はデフォルトでは無効になっており、利用するには組み込みのSkillsツールが必要です。スキルの指示文によってコンテキスト(トークン数)が圧迫されるのを防ぎたい管理者に影響します。利用する場合は、アップデート後に管理者設定の「Admin Settings」>「General」から「Load selected skills on demand」を有効化するか、環境変数「ENABLE_SKILL_LAZY_LOADING」を設定してください。

コンテキスト圧縮の可視化とエラー回避

チャット画面上でコンテキスト圧縮の状況が明確に把握できるようになりました。古いメッセージが要約された位置に「Context compacted」という表示が追加され、展開することで要約内容を確認できます。また、圧縮の進捗やエラーがポップアップではなくチャット内に直接表示されます。

あわせて、圧縮処理の適用対象が拡張されました。これまで設定値「Retained Messages」の保持件数を満たせない短い会話(質問1件に対してツール出力が大量に返ってきた場合など)や一時チャットでは圧縮がスキップされ、続くメッセージや再生成時にコンテキスト長エラーが発生していました。本バージョンからは最初のフォローアップメッセージの時点で適切に分割して圧縮が実行されるため、エラーによる中断を防ぐことができます。ツールを頻繁に利用するモデルを動かしているユーザーに大きな恩恵があります。設定変更や再変換の作業は不要です。

管理者によるUI項目の非表示設定と無効な項目の自動隠蔽

管理者が一般ユーザーに対して個別のUI要素を非表示にできる機能が実装されました。「Admin Settings」>「Interface」の「Visible controls」または環境変数「UI_VISIBILITY」から設定可能です。モデル機能、組み込みツール、「+」メニュー内の各種添付機能、/statusや/settingsなどのコマンド、使用量情報、サイドバー固定ボタンなど幅広い項目を対象に制御できます。非表示に設定された項目も内部的な値は保持され、機能自体は動作し続けます。

さらに、Vision非対応モデル選択時の画像キャプチャボタンや、権限のないユーザーに対するノート添付機能など、現在の状態では実行できない無効なオプションが画面上から自動的に隠されるようになりました。これにより、利用できないボタンを押して選択内容が消えてしまうといったUI上の混乱が防止されます。複数人でインスタンスを共有している管理者は、必要に応じて表示制御の設定を確認してください。

ナレッジベースのアップロード状況表示と管理の改善

ナレッジベースにファイルを追加した際のステータス表示が改善されました。サーバーへ到達した直後に「Uploading」から「Processing」表示へと切り替わり、テキスト抽出などの処理中も画面をリロードすることなく状態が自動更新されます。また、複数ファイルを同時に追加した際も即座にアップロード中として一覧に表示されるようになりました。あわせて、「Settings」>「Data Controls」の「Manage Files」において、複数ファイルの一括削除やZIP形式での一括ダウンロードに対応しました。ローカル文書をナレッジベースに登録してRAGを活用しているユーザーの作業効率が向上します。

MCPプロトコル最新版への対応と操作性の向上

Model Context Protocol(MCP)接続において、ステートレスな「2026-07-28」プロトコルバージョンに対応しました。従来のハンドシェイクを使用する古いMCPサーバーとの互換性も維持されています。また、サイドバーでShiftキーを押しながらチャットをクリックすることで複数の会話を一括選択し、まとめてアーカイブや削除が行えるようになったほか、モバイル端末でのチャット操作パネルのスワイプ開閉対応、左右ペインのスクロール位置がずれないテキスト比較画面の改良など、日常的な使い勝手を高める調整が多数盛り込まれています。

アップデート方法

open-webuiの導入環境に合わせて、Python環境(pip)またはDockerコンテナを使用して最新バージョンへ更新してください。

Python環境(pip)での更新手順

Python環境で直接実行している場合は、pipコマンドを用いてインストールや更新を行います。互換性の問題を避けるため、Python 3.12の使用が推奨されています。

端末で次のコマンドを実行してパッケージをインストールまたは更新します。

pip install open-webui

インストールの完了後、サーバーを起動するには以下のコマンドを実行します。

open-webui serve

サーバーが立ち上がると、ブラウザから http://localhost:8080 にアクセスして利用できます。

Docker環境での更新手順

Dockerを利用している場合は、用途や環境に応じたイメージを指定してコンテナを起動します。データベースの損失を防ぐため、-v open-webui:/app/backend/data オプションを指定してボリュームを適切にマウントすることが必須とされています。

ホスト端末上でOllamaを実行している場合は、次のコマンドでコンテナを起動します。

docker run -d -p 3000:8080 --add-host=host.docker.internal:host-gateway -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:main

別のサーバー上にあるOllamaへ接続する場合は、環境変数 OLLAMA_BASE_URL に接続先サーバーのURLを指定して起動します。

docker run -d -p 3000:8080 -e OLLAMA_BASE_URL=https://example.com -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:main

Nvidia GPUによるCUDAアクセラレーションを利用する場合は、LinuxまたはWSL環境にNvidia CUDA container toolkitを導入した上で、タグが :cuda となっている公式イメージを使用します。

docker run -d -p 3000:8080 --gpus all --add-host=host.docker.internal:host-gateway -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:cuda

OpenAI APIのみを利用する場合は、環境変数 OPENAI_API_KEY を指定して起動します。

docker run -d -p 3000:8080 -e OPENAI_API_KEY=your_secret_key -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:main

Open WebUIとOllamaが一体化されたバンドルイメージを利用する場合は、:ollama タグのイメージを使用します。GPUを利用する場合のコマンドは次の通りです。

docker run -d -p 3000:8080 --gpus=all -v ollama:/root/.ollama -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:ollama

CPUのみでバンドルイメージを実行する場合は、以下のコマンドを実行します。

docker run -d -p 3000:8080 -v ollama:/root/.ollama -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:ollama

Dockerコマンドで起動した後は、ブラウザから http://localhost:3000 にアクセスして操作画面を開くことができます。Docker Compose、Kustomize、Helmなどを用いた構成やアップデートの詳細な手順については、Open WebUI Documentationで案内されています。

関連記事

次に読むなら

出典