【個人開発】 OpenWrt専用AIアシスタントツール Oasisの導入と使い方

OpenWrt 個人開発 oasis

【個人開発】OpenWrt専用AIアシスタントツール Oasisの導入と使い方

post: 2025-01-13 update: 2025-04-08

この記事で紹介するOasisがサポートするOpenWrtバージョンは最新の24.10です。開発中のOpenWrt（24.10+x以降）では、パッケージマネージャーソフトがOPKGからAPKに移行した影響でOasisの依存モジュールがAPK対応中となっています。そのため、2025年2月時点ではOasisのAPKパッケージを使用したインストールは100%失敗しますのでご注意ください。

今回は私が個人開発したOpenWrt専用AIアシスタントツール Oasisの導入と使い方について紹介します。

Oasisはユーザーの依頼に従ってAIがOpenWrtの設定を変更することができるアプリケーションです。

Oasisをインストールすることで、ユーザーはOpenWrtデバイスのLuCI(UI)やコンソールを介してAIと会話できるようになります。

これにより、ユーザーは日本語や英語などの自然言語でAIにネットワークやWI-Fiなどの設定変更を依頼することができます。

AIはOpenWrtの仕様に基づいた詳細な設定変更をユーザーに代わって実施します。

今回は、そんなOasisの導入と使い方について紹介します。

AIとの会話
使い方その１：AIによる設定提案と変更
使い方その２：設定変更の確定またはロールバック（重要）
使い方その３：システムメッセージの登録と使用
使い方その４：外部システムメッセージのダウンロード
使い方その５：AIアイコンの変更

インストール方法

その１：LuCIで配布パッケージをインストールする
その２：コンソールを使用して配布パッケージをインストールする
インストールQAリスト

Oasisの基本設定

Ollamaを使用する方法

PCにOllamaをインストールして必要な設定変更を実施する
OasisとOllamaが連携できるネットワーク構成パターン
OasisがOllamaと連携するための設定

OpenAIを使用する方法

OpenAIのAPIキーを作成する（※課金が必要）
OasisとOpenAIが連携できるネットワーク構成パターン
OasisがOpenAIと連携するための設定

Oasisの使い方（その他）

チャットタイトルの変更
チャットデータのダウンロード

おわりに

Oasisとは？

ここでは、Oasisが出来る事を簡単に説明します。

AIとの会話

OasisはOpenAIやOllamaなどのAIサービスをOpenWrtに連携させることができるアプリケーションです。

OasisをインストールしたOpenWrtデバイスは、コンソール（CUI）とWebUIの両方からAIと会話することができるようになります。

Oasisのアプリケーションパッケージはoasisとluci-app-oasisの２つから構成されます。

[WebUIを利用したAIとの会話]
oasisとluci-app-oasisパッケージの両方をインストールすると、OpenWrtのLuCIにOasis用のUIページが追加されます。このページの「Chat with AI」タブのチャットインタフェースからAIと会話することができます。

※この動画ではOllamaを使用しています。

[コンソール（CUI）を利用したAIとの会話]
oasisパッケージをインストールするとコンソールからAIと会話できるようになります。このパッケージはluci-app-oasisの依存パッケージにもなっており、AIとの会話制御はこのソフトウェアが担当しています。

※この動画ではOllamaを使用しています。

このように、OasisはOpenWrtのLuCI(WebUI)とコンソールの両方から利用することができるAIアシスタントツールです。

補足

現在、コンソール上から会話してもAIから提供されたOpenWrtの設定変更の提案をOasisは認識しません。 AIの提案を認識するには追加でluci-app-oasisをインストールする必要があります。

使い方その１：AIによる設定提案と変更

OasisではAIとチャットを始めるときにトピック選択をします。

Oasisをインストールした直後の状態ではOpenWrtの設定関連のトピックのみが選択できる状態です。（トピックは後からSystem Messageタブから追加・削除が可能です。）

OpenWrtの設定に関するトピックを選択した場合、AIはOpenWrtについて回答するようになります。

OpenWrtの設定変更に関する提案がAIから提示された場合、Oasisはその内容を分析します。

そして、Oasisはユーザーに対してAIの提案を基に設定変更を実施するか否かをポップアップで通知します。

ユーザーは設定変更の提案を確認し、承認する場合はApplyボタンを押します。

これにより、OpenWrtはAIの提案内容に基づいた設定変更を実施してネットワーク・Wi-Fi の再起動を実施します。

以上より、OpenWrtの設定が一時的に変更されます（※）

※次節で説明する「設定変更を最終確定するか取り消す（ロールバックする）か」を決めることで、AIによる設定変更の一連の操作が完了します。

使い方その２：設定変更の確定またはロールバック（重要）

注意

次の説明の操作はAIによる設定変更が適用されてから５分以内に実施してください。

５分を超える場合は自動でロールバック処理が実行され、AIによる設定変更は取り消されます。これはAIによる設定変更によってOpenWrtデバイスが文鎮化(Brick)するのを防ぐ措置です。

※文鎮化(Brick)とは
端末へのアクセス手段が全て絶たれた結果、もう文鎮（置物）としての役割しかない状態のことを指します。

前節までの操作でOpenWrtの設定が変更されると通信断が発生します。

このとき、設定変更がネットワークに影響を与えない場合はOasisによるページ更新機能またはユーザーによるWebページの更新ボタン押下などで再びLuCI内のAIチャットページに戻ることができます。

しかし、ネットワークに影響を与える設定変更をした結果、OpenWrtデバイスのIPアドレスが変わるなどした場合は自動でAIチャットページに戻ることはできません。

その場合はOpenWrtデバイスの新しいIPアドレスを特定して手動でアクセスしてください。この間に電源断を実施し、システムを再起動しても構いません。再起動後にロールバック機能の監視時間である５分が再設定されます。

OasisのAIチャットページが表示されると、以下のポップアップで設定変更を最終確定するか聞かれます。

このとき、ポップアップに表示された「Finalize」ボタンを押すことで設定変更を最終確定することができます。逆に「Rollback」ボタンを押した場合は以前の設定に戻ります。

※Rollbackによって設定を戻す場合、OpenWrtはシステム再起動（reboot）を実行します。

Oasisを利用してAIによるOpenWrtの設定を変更した場合は、必ず上記の操作を実施する必要があります。上記の操作を実施しない場合は設定適用から５分後に自動でロールバックが実行されます。

使い方その３：システムメッセージの登録と使用

Oasisでは、AIの回答を調整する機能としてシステムメッセージの登録があります。

これはOasisのUIに存在するSystem Messageタブをクリックすることで利用できます。

Create System Message項目のテキストエリアにAIへの指示や特定の情報（例えばOpenWrtに関する事とか）を入力してAddボタンを押すことで OpenWrtデバイスに新たなシステムメッセージを登録することができます。

上図の例では、新たなシステムメッセージとして「ユーザーの日本語メッセージを英語に翻訳する」指示を書いています。

システムメッセージの登録処理が成功すると、System Message List項目にユーザーが入力したシステムメッセージが表示されます。

後はChat with AIタブをクリックしてAIと新たなチャットを始めます。すると、トピック選択覧に先ほどのシステムメッセージのタイトル「通訳者」が表示されますのでこれをクリックします。

これにより、「通訳者」と名前の付いたシステムメッセージをAIが解釈した上でユーザーのメッセージに対して回答します。結果として今回の場合では、ユーザーの日本語メッセージを英語に翻訳してAIが回答するようになります。

このように、システムメッセージを利用すればOpenWrt関連以外の質問や相談に対してAIの回答を調整することができます。

現在のOasisでは、OpenWrtに関する回答の調整もシステムメッセージだけでやっています。

そのため、既存または新規のシステムメッセージにOpenWrtの設定に関する情報をナレッジとして記憶させていくことで OpenWrtの設定変更に特化していくようになります。

特に、OasisはAIの回答の中でOpenWrtの設定を変更に関する内容(UCIコマンドシーケンス)を見つけるとその内容が実行できるか分析します。そして、ユーザーにポップアップで通知します。

このような振る舞いはOpenWrtに関する設定をしたときだけ発生します。通常、「日本語メッセージを英語に翻訳して」のようなシステムメッセージでは Oasisによるポップアップ通知は実施されません。

使い方その４：外部システムメッセージのダウンロード

Oasisでは外部サーバーで保管しているテキストデータをシステムメッセージとしてダウンロードすることもできます。

「System Message」タブのページに存在する「Load Extra System Message」のURL覧にGitHubなどの外部サーバーが保管するテキストデータのURLパスを打ち込み、「Load」ボタンを押すことで対象データをダウンロードすることが出来ます。

ここでは例として、GitHubのOasisリポジトリの中で保管されているMITライセンスのテキストファイルをシステムメッセージとしてダウンロードしてみます。

Step1:ファイルパスの取得
GitHubのリモートリポジトリで管理しているテキストファイルをダウンロードするためにURLパスを確認します。

先ず、ダウンロード対象のテキストファイルを管理しているリポジトリのトップページにアクセスして、テキストファイル（今回はMITライセンスファイル[赤線部分]）をクリックします。

すると、次のようなページが表示されるので右上の「Raw」ボタンをクリックします。

これによって、テキストファイルのRAWデータが表示されます。このときにWebブラウザのURL覧に表示されるRAWデータのフルパスをコピーします。

これでダウンロード対象のテキストファイルのフルパスを入手することができました。

Step2:ダウンロード
OasisのUIページの「System Message」を表示します。

この中にある「Load Extra System Message」のURL入力覧に先ほど入手したGitHubリポジトリのテキストファイルのパスを入れます。

後は「Load」ボタンを押すことでテキストデータのロードが開始されます。処理が正常に完了するとテキストエリアにその内容が表示され、「Add」ボタンが出現します。

後は前節のシステムメッセージで紹介した使い方と同様です。内容に問題なければシステムメッセージにタイトルを付けた上で「Add」ボタンを押してください。

これでシステムメッセージとして外部サーバーからダウンロードしたテキストデータが追加されます。このように、外部サーバーが保管するテキストデータをナレッジとして友人同士でシェアできます。

PrivateリポジトリやInternalリポジトリを利用する際の注意

上記の手順（Step1）でPrivateリポジトリやInternalリポジトリのファイルパスを取得すると「ファイルパス＋認証トークン」の形式になっていることが確認できます。

認証トークンを含むファイルパスをOasisのLoad Extra System MessageのURLに入力してLoadボタンを押すことで、 PrivateリポジトリやInternalリポジトリの特定ファイルもダウンロードすることが出来ます。

これは便利ですが、一方で「ファイルパス＋認証トークン」が第三者に漏洩すると不正アクセスの原因になります。

取り扱いには注意してください。

使い方その５：AIアイコンの変更

サブ機能になりますが、OasisではAIのアイコンも変更できます。

これはOasisのUIに存在するIconタブをクリックすることで利用できます。

初期状態ではOpenWrtと女の子（通称：オペ子）のアイコンの2種類が存在します。

ここでは例として初期設定のOpenWrtアイコンからオペ子のアイコンに変更してみます。アイコンを変更するには画像をクリックした後にSelectボタンを押します。

後はChat with AIタブに行きチャット覧を見ると、AIのアイコンがOpenWrtからオペ子になっていることが確認できます。

好きなアイコン(png形式など)を新たに追加したい場合は、Upload Icon項目下で画像ファイルをドラッグ＆ドロップするかクリックすると追加することができます。

Webブラウザに認識されると、上図の確認画面が表示されますので問題なければUploadボタンを押します。

OpenWrtデバイス側にアイコン画像がアップロードされると、Select AI Icon項目にアイコンが追加されます。

このように、AIのアイコンも変更することで自分用のAIアシスタントとしてカスタマイズできます。

色々アップロードしていると容量不足などで失敗することがあるかもしれません。そのときはDeleteボタンで不要なアイコンを削除してください。

インストール方法

インストール方法はいくつかありますので、簡単な方法から掲載します。

Oasisインストール時のトラブルについて

Oasisのインストールが出来ない場合は、QAを参照してみてください。

その１：LuCIで配布パッケージをインストールする

前提条件：OpenWrtデバイスをインターネットに接続できるようにする
OpenWrtをデバイスにインストールした直後の初期設定ではインターネットに接続できません。

そのため、まずは以下の記事などを参考にOpenWrtデバイスをAPまたはルーター設定にした上でインターネットにアクセスできるようにしてください。

１：Oasisパッケージのダウンロード
お使いのPCでOasisのGitHubにアクセスし、Releasesにある最新版のOasisバージョンをクリックします。（現在の最新はv1.5.0です。）

以下の画面はv1.0のものです。最新版の場合、バージョン番号が異なっていますので置き換えて考えてください。

この中で拡張子が「ipk」のパッケージをクリックしてダウンロードします。

２：LuCI経由でOpenWrtデバイスにOasisをアップロードしてインストールする
次はLuCIにアクセスしてメニューバーのSystemからプルダウンメニューのSoftwareをクリックします。

そして「Update lists...」をクリックします。

これにより、リポジトリ情報を更新します。

次に「Upload Package...」をクリックします。

続いて「Browse...」をクリックして先ほどダウンロードしたoasis_1.5.0-r1_all.ipkを選択します。

すると、以下のようにUploadボタンが出現するのでこれをクリックします。

パッケージが認識されると以下の表示がでますので、「Install」を押します。

正常にインストールが完了すると以下の画面になります。

このインストール操作をluci-app-oasisに対しても実施すればインストール完了です。

最後にOpenWrtデバイスを再起動することでOasisが利用できるようになります。

再起動は次のUI画面から実施してください。

各AIサービスの具体的な使用方法は次の節を参照してください。

Ollamaを使用する方法
OpenAIを使用する方法

その２：コンソールを使用して配布パッケージをインストールする

そのため、まずは以下の記事などを参考にOpenWrtデバイスをAPまたはルーター設定にした上でインターネットにアクセスできるようにしてください。

１：OasisパッケージのダウンロードとOpenWrtデバイスへのアップロード
お使いのPCでOasisのGitHubにアクセスして、Releaseをクリックします。

この中で拡張子が「ipk」のパッケージをクリックしてダウンロードします。

ダウンロードしたパッケージをSCPコマンドでOpenWrtデバイスにアップロードします。（以下はWindowsのコマンドプロンプトから SCPコマンドを利用してOpenWrtデバイスにパッケージをアップロードした際のコンソール画面の結果です。）

C:\Users\xxxx\Downloads>scp -O ./oasis_1.5.0-r1_all.ipk root@192.168.1.1:/root
root@192.168.1.1's password:
oasis_1.5.0-r1_all.ipk          100%   13KB  12.8MB/s   00:00

C:\Users\xxxx\Downloads>scp -O ./luci-app-oasis_1.5.0-r1_all.ipk root@192.168.1.1:/root
root@192.168.1.1's password:
luci-app-oasis_1.5.0-r1_all.ipk 100%  111KB 111.2KB/s   00:00

２：OpenWrtのコンソールにアクセスしてパッケージをインストール】
OpenWrtデバイスにパッケージをアップロードできたらSSH接続をしてコンソールにアクセスします。（以下はWindowsのコマンドプロンプトからOpenWrtデバイスに対してSSH接続をした際の結果です。）

C:\Users\xxxx>ssh root@192.168.1.1
root@192.168.1.1's password:


BusyBox v1.36.1 (2025-01-29 21:37:05 UTC) built-in shell (ash)

    _______                     ________        __
    |       |.-----.-----.-----.|  |  |  |.----.|  |_
    |   -   ||  _  |  -__|     ||  |  |  ||   _||   _|
    |_______||   __|_____|__|__||________||__|  |____|
            |__| W I R E L E S S   F R E E D O M
    -----------------------------------------------------
    OpenWrt 24.10-SNAPSHOT, r28421-1a75172721
    -----------------------------------------------------
root@OpenWrt:~#

そして次のコマンドを実行して先ほどアップロードしたパッケージをインストールします。

root@OpenWrt:~# opkg update
root@OpenWrt:~# opkg install oasis_1.5.0-r1_all.ipk
root@OpenWrt:~# opkg install luci-app-oasis_1.5.0-r1_all.ipk
root@OpenWrt:~# service rpcd reload   # Oasisを利用するために必要な制御モジュール(rpcd)の情報を更新します。（デバイスの再起動でもOK）

これでOasisのインストールが完了しました。

各AIサービスの具体的な使用方法は次の節を参照してください。

Ollamaを使用する方法
OpenAIを使用する方法

インストールQAリスト

QA1：oasisパッケージのインストールが失敗する場合

恐らく、依存パッケージのluci-compatまたはlua-curl-v3が予めインストールされていないことが原因である可能性が高いです。

そのため、OpenWrtデバイスをインターネットにアクセスできるようにする必要があります。

インターネットにアクセスできれば、上記のインストールコマンドの実行後に必要な依存パッケージをリポジトリから探し出して問題を解決できるようになります。

OpenWrtデバイスがインターネットにアクセスするための設定例は以下の記事を参考にしてください。

Ollamaを使用する方法

この節では、Ollamaを使用する際の設定やネットワーク構成について説明します。

PCにOllamaをインストールして必要な設定変更を実施する

まず、OpenWrtデバイスと連携するPCにOllamaをインストールして必要な設定変更を実施します。

Ollamaのインストールと設定については以下のリンクを参考に実施してください。

なお、この記事で紹介する使用例ではLLMモデルとしてgemma2:2bを使用しますので、 Ollamaのインストール後はこのLLMをダウンロードしてください。（上記の記事でもgemma2:2bを例にしています。）

OasisとOllamaが連携できるネットワーク構成パターン

OllamaをインストールしたPCをどのように配置すればOasisと連携できるかをネットワーク構成パターン別に紹介します。

以下のように列挙しましたが、基本的にはどんなネットワーク構成でも連携可能です。

その１: P2P接続 (OpenWrt初期状態)
OpenWrtの初期状態のときのネットワーク構成です。OpenWrtデバイスは有線LANでPCと接続することで通信が可能です。このとき、PC側にOllamaがインストールされていればOasisと連携できます。

その２：OpenWrtをメインルーターとして利用しているとき
OpenWrtを既にメインルーターとして使用している場合は、OllamaをインストールしたPCを同じLANセグメント所属させればOKです。そのため、以下の図のようにユーザーが使用するPCにOllamaをインストールしても良いですし、AIサーバー用のPCを用意してそこに Ollamaを入れても良いです。

その３：OpenWrtをAPとして利用しているとき
OpenWrtをアクセスポイント(AP)として使用している場合は、OpenWrtが所属するLANセグメントにOllamaをインストールしたPC を所属させればOKです。そのため、以下の図のようにユーザーが使用するPCにOllamaをインストールしても良いですし、AIサーバー用のPCを用意してそこに Ollamaを入れても良いです。

その４：OpenWrtをサブルーター（二重ルーター）として利用しているとき
OpenWrtをサブルーターとして使用している場合は、メインルーターのLANセグメントまたはサブルーターのLANセグメントに OllamaをインストールしたPCを所属させればOKです。そのため、以下の図のようにユーザーが使用するPCにOllamaをインストールしても良いですし、 AIサーバ用のPCを用意してそこにOllamaを入れても良いです。

OasisがOllamaと連携するための設定

上記で説明した準備を全て実施した後は、Oasisの設定にOllamaの情報を保存することで連携ができます。

次はOpenWrtデバイス（192.168.1.1/24）とOllamaをインストールしたPC（192.168.1.245/24）が接続された状態（つまり、上記のネットワーク構成パターンその１の状態）のときに OpenWrtのOasisとOllamaを連携させるときの設定例です。（この例では使用するLLMモデルをgemma2:2bとしています。）

Oasisの設定はLuCIのメニューバーの「Network」のプルダウンにある「Oasis」をクリックして表示される「General Setting」で実施できます。 (上記の場合、OpenWrtデバイスのLuCIには「http://192.168.1.1」でアクセス可能です。)

以下の「General Setting」タブが表示されたら「Add」ボタンをクリックしてください。

するとAIサービスを使用すために必要な設定項目が出てきますので必要な情報を入力します。

通常、Ollamaとチャットをするにはhttp://<ip address>:11434/api/chatという形式のURLパスをエンドポイントとして指定する必要があります。そのため、ここではエンドポイントがhttp://192.168.1.245:11434/api/chatと設定しました。

また、APYキーは設定されていませんので無し（未入力）として、LLMモデルをgemma2:2bとしています。

必要な設定を入力したら「Apply」ボタンを押して設定を更新し、「Chat with AI」タブに表示を切り替えてAIに話掛けて見てください。

ここまでの設定が正しければ、AIからの応答が返ってきます。これでOasisを利用してAIが利用できるようになりました。

OpenAIを使用する方法

OpenAIのAPIキーを作成する（※課金が必要）

OpenAIとOasisを連携するにはOpenAIのAPIキーが必要です。そのため、課金をしてOpenAIのサービスプランに加入する必要があります。試用プランを利用できる場合は一定期間、OpenAIが提供するAIサービスを無料で使用することができます。しかし、基本的にはお金が掛かるということにご注意ください。

サービスプランに加入したら次のOpenAIのページにアクセスしてユーザーログインをします。

次に左上のSearchで「API Keys」で検索して一番先頭に出てきたページをクリックします。

すると、次の画面が表示されますので「Create new secret key」をクリックします。

これでAPIキーの設定画面が表示されますので、APIキーの名前を決めた上で「Create secret key」ボタンを押します。

ここまでの操作が完了すると、APIキーが発行されますので「Copy」ボタンをクリックしてクリップボードにコピーします。このAPIキーは忘れないように管理してください。忘れたら再発行が必要です。

最後に「Done」ボタンをクリックするとAPIキーを管理するダッシュボードが表示されます。これでOpenAIのAPIキーの作成は一通り完了です。

OasisとOpenAIが連携できるネットワーク構成パターン

OpenAIはインターネットを介して利用できるAIサービスなのでOpenWrtデバイスはインターネット通信ができる状態である必要があります。

以下はOpenAIを利用する際のネットワーク構成パターンです。一応以下のように列挙していますが、基本的にはインターネットに疎通できるように配置できればOKです。

その１：OpenWrtをメインルーターとして利用しているとき
OpenWrtデバイスをメインルーターとして利用している場合は、その状態でインターネットにアクセス出来れば良いです。つまり、その状態でスマホやPCがOpenWrtデバイスが管理するネットワークを経由してネットサーフィンできる状態であればOKです。