V3SP3R徹底解説｜Flipper ZeroをAIエージェントで音声操作するAndroidアプリ

この記事ではAIエージェントに特化して解説します。AIエージェント全般は AIエージェントフレームワーク比較2026年版 をご覧ください。

V3SP3Rが生まれた背景：Flipper ZeroとAIエージェントの交差点

Flipper Zeroは、SubGHz無線・赤外線・NFC・RFID・BadUSB・iButton・GPIOなど多彩な機能を1台に詰め込んだポータブルなハードウェアハッキングツールだ。セキュリティ研究者やハードウェア開発者の間で愛用されている一方で、メニュー階層が深くプロトコルごとの操作手順を暗記する必要があり、「多機能ゆえの敷居の高さ」が常について回っていた。

「確定申告を頼むとしたら、天才数学者に頼むか、経験豊富な税理士に頼むか？」

これはClaude Skillsの文脈でよく引用される比喩だが、Flipper Zeroの世界でも同じことが言える。汎用LLMは「天才数学者」だが、SubGHzのモジュレーションや国別の周波数規制、NFCのセクタ構造まではいちいち仕込まないと動けない。V3SP3Rが目指したのは、LLMに「Flipper Zero専門の税理士」として振る舞わせることだ。

V3SP3Rは、elder-plinius氏が公開したOSSで、GitHubで928スターを獲得している。AndroidアプリからFlipper Zeroに自然言語で指令を出し、LLMが解釈してBLE経由でコマンドを送る。ユーザーは「315MHzでキャプチャして」「NFCカードの内容を読み出して」と話しかけるだけで、複雑なメニュー操作をスキップできる。

OpenHandsのようなコーディングエージェントがソフトウェア開発の作業をLLMに委ねたのと同じ構造で、V3SP3Rは「物理デバイス制御」という新しい領域にAIエージェントを持ち込んだ。「自然言語 → ツール呼び出し → 実行」というLLMエージェントの基本パターンが、ハードウェアハッキングの世界にも降りてきた格好だ。

V3SP3Rの主要機能：8つのコア機能を俯瞰する

V3SP3Rは単なるリモコンアプリではない。公式READMEによれば、8つのコア機能が組み合わさって「AIで操作するFlipper Zero」を構成している。

アーキテクチャ全体像

V3SP3Rは典型的な3層アーキテクチャを採用している。UI層はJetpack Compose + Hiltで構築され、ドメイン層でAIオーケストレーションとリスク評価を行い、データ層がOpenRouter API・BLE通信・Roomデータベースを管理する。

重要なのは、LLMが直接Flipperを叩くのではなく、必ずRiskAssessorとCommandExecutorを経由する設計になっている点だ。LLMは「何をしたいか」をJSONで表現し、それをアプリ側が解釈・検証してからBLEに流す。プロンプトインジェクションや暴走した推論結果が直接ハードウェアに到達しないよう、ガードレールがアプリ側に埋め込まれている。

Browser Useのようなブラウザ自動化エージェントがWeb上のタスクを自動化するように、V3SP3Rは物理デバイスのタスクを自動化する。違いはただ1点、「操作対象が電波やICチップである」というところだ。

セットアップ手順：クローンからFlipper Zero接続まで

V3SP3Rの導入は、リポジトリのクローンからAndroid Studioでのビルド、Flipper Zeroとのペアリングまで数ステップで完了する。Android Studioを使わずCLIだけでビルドすることも可能で、JDK 17+があればローカルでAPKを生成できる。

前提条件

• Flipper Zero本体（Bluetoothペアリングを有効化済み）
• Android 8.0以上のデバイス（Kotlin 2.2ターゲット）
• OpenRouterアカウント（APIキーを取得済み）
• Android Studio または JDK 17+

ビルドとインストール

# リポジトリをクローン
git clone https://github.com/elder-plinius/V3SP3R.git
cd V3SP3R

# Android Studioなしでビルドする場合（JDK 17+必須）
./gradlew assembleDebug

# APK出力先
# app/build/outputs/apk/debug/app-debug.apk

# ADB経由でインストール
adb install app/build/outputs/apk/debug/app-debug.apk

インストールが完了したら、V3SP3Rを起動して初期設定に進む。ポイントはOpenRouter APIキーの登録と、Flipper ZeroのBLEスキャンの2つだけだ。

初回起動の設定フロー

// 設定手順（OpenRouterClient.kt・SettingsScreen.kt の流れに相当）

// 1. Settings > API Key を開く
// 2. OpenRouter で発行した sk-or-... 形式のキーを貼り付け
// 3. 推奨モデル: nousresearch/hermes-4
//    または anthropic/claude-sonnet-4
// 4. Device タブ > Scan をタップ
// 5. 近くのFlipper Zeroが表示されたら選択してペアリング
// 6. Chat タブから自然言語で操作開始

スマートグラス連携（オプション）

Mentraスマートグラスと組み合わせると、完全ハンズフリーで音声 + カメラを使える。ブリッジサーバーはNode.js製で、スマホとグラスの間の中継役を担う。

# mentra-bridgeサーバーのセットアップ
cd mentra-bridge
npm install
npm run build
npm start

# V3SP3R Settings > Smart Glasses を有効化
# ブリッジURL（例: http://192.168.1.10:3000）を入力
# Mentraグラス側でV3SP3Rチャンネルに接続

リスク分類システム：安全なAI制御を支える4層ゲート

V3SP3Rの最大の特徴は、全AIアクションに対して4段階のリスク分類を行い、操作ごとにゲートを設ける「リスクティア制」の導入だ。LLMが発行したツール呼び出しは、必ずRiskAssessorを通ってからFlipper Zeroに届く。

リスクレベル別の挙動

このティア設計は、ソフトウェア側でAIに外部ツールを操作させるときの安全設計と同じ考え方だ。MCPサーバー構築ガイドで解説したツール実行の権限制御と本質的に共通しており、「LLMがどれだけ賢くても、破壊的操作は必ず人間が最終確認する」という原則に基づいている。

自動承認とアンロックのカスタマイズ

Settings画面では、ティアごとに「自動承認する／しない」を切り替えられる。たとえば読み取り専用操作（Low）はすべて自動承認、IR送信のようなMedium操作は差分レビュー、SubGHzやBadUSBのようなHigh操作は常に二重確認、という形で段階的にセキュリティレベルを調整できる。

すべてのAIアクション結果をリスク分類し、破壊的操作には明示的な確認を要求する。システムパスはデフォルトでロックされている。

READMEに記された上記の設計思想は、「プロンプトインジェクションやLLMの暴走に対して、アプリケーション層で物理的なガードを設ける」という発想に根ざしている。仮にLLMが「重要なFlipper設定ファイルを全削除して」という悪意あるJSONを吐いても、システムパスのBlockedゲートがそれを遮断する。

監査ログ：全操作を追跡可能に

全AIアクションはAuditServiceを介してRoomデータベースに記録される。コマンド内容、実行結果、ユーザーの承認・却下履歴がタイムスタンプ付きで保存され、後からフィルタ・エクスポートできる。コンプライアンス要件がある現場でも操作履歴を提出できる。

推奨AIモデルの選び方：OpenRouter経由で何を使うか

V3SP3RはOpenRouter経由で任意のLLMを利用できる。ただしツール呼び出し（Function Calling）の精度はモデルごとに大きく差があるため、選択が実用性を左右する。

モデル別の推奨度

Flipper Zeroの操作コマンドはすべてJSON形式で構造化される。LLMが正しくJSONを吐けないとツール呼び出しが失敗する。V3SP3Rには自動JSON修復機能が組み込まれているが、Hermes 4やClaude Sonnet 4のような推奨モデルを使うほうがエラー率を最小化できる。

コスト感の目安

OpenRouterは従量課金制で、日常的なFlipper操作（短い音声コマンドと応答）であれば1日あたり数セント程度に収まる。一方、カメラで撮ったリモコンからIRコード一覧を推論させるようなマルチモーダル処理はトークン消費が増えるため、用途に応じて使い分けるのが良い。

// OpenRouterClient.kt 相当の呼び出しイメージ
val request = ChatRequest(
    model = "nousresearch/hermes-4",
    messages = listOf(
        SystemMessage(VesperPrompts.flipperAgent),
        UserMessage("315MHzでキャプチャして")
    ),
    tools = FlipperToolExecutor.availableTools,
    tool_choice = "auto"
)

val response = openRouter.chat(request)
response.toolCalls.forEach { call ->
    val risk = riskAssessor.classify(call)
    if (risk.requiresConfirmation) showDialog(call, risk)
    else commandExecutor.execute(call)
}

他のAIエージェントフレームワークとの比較

V3SP3Rの立ち位置を、ソフトウェア側のAIエージェントと比較して整理する。

ForgeCodeのようなコード生成ツールはソフトウェア開発を自動化するが、V3SP3Rは電波やICチップといった物理レイヤを扱う。共通するのは「AIエージェントが専門ツールを操作する」というパターンで、対象がコードか電波かの違いに過ぎない。

プロジェクト構造と技術スタック：Kotlin 2.2 + Jetpack Compose

V3SP3Rの実装はモダンなAndroidスタックで固められている。Kotlin 2.2・Jetpack Compose・Hilt・Roomといった2020年代後半の標準的な構成で、Flipper ZeroとのBLE通信にはFlipper独自のprotobufを実装している。

リポジトリ構造

V3SP3R/
├── app/src/main/java/com/vesper/flipper/
│   ├── ai/                     # AI統合
│   │   ├── OpenRouterClient.kt # LLM API、ツール呼び出し、JSON修復
│   │   ├── VesperAgent.kt      # 会話オーケストレーター
│   │   ├── VesperPrompts.kt    # システムプロンプト
│   │   ├── PayloadEngine.kt    # ペイロード生成
│   │   └── FlipperToolExecutor.kt
│   ├── ble/                    # Bluetooth通信
│   │   ├── FlipperBleService.kt
│   │   ├── FlipperProtobuf.kt
│   │   └── MarauderBridge.kt
│   ├── glasses/                # スマートグラス連携
│   ├── voice/                  # 音声入出力
│   ├── domain/                 # ドメインロジック
│   │   ├── executor/           # コマンド実行 & リスク評価
│   │   ├── model/              # データモデル
│   │   └── service/            # 監査、差分、権限
│   ├── security/               # 入力バリデーション
│   ├── ui/                     # Jetpack Compose画面
│   └── widget/                 # ホーム画面ウィジェット
├── mentra-bridge/              # スマートグラスブリッジ（Node.js）
└── docs/                       # アーキテクチャドキュメント

キーモジュールの役割

注目すべきは、VesperAgent → RiskAssessor → CommandExecutor → FlipperBleService という流れが明確な単方向パイプラインになっている点だ。依存性注入にHiltを使い、各層をモックに置き換えられる構造になっているため、BLE実機なしでもユニットテストが書ける。

技術選定の背景

Kotlin 2.2 + Jetpack Composeは、Androidのモダンスタックとしてはほぼ定番の組み合わせだ。Hiltで依存性注入、Roomでローカル永続化、Coroutines・Flowで非同期処理というのが、2025〜2026年のプロダクション品質Androidアプリの基本セットになっている。V3SP3Rはこのセットをそのまま採用することで、GitHubでのコントリビューションの敷居を下げている。

V3SP3Rなし vs あり：何が変わるのか

V3SP3Rを使わない場合と使う場合で、Flipper Zeroを扱うワークフローがどう変わるかを対比で整理する。

要するに、V3SP3Rは「Flipper Zeroの操作コスト」と「事故リスク」を同時に下げる。特に現場でヘルメットや手袋を着けたまま作業するハードウェアエンジニアにとって、音声 + スマートグラスで完全ハンズフリーに操作できる価値は大きい。

使い分けの判断軸

V3SP3Rを導入すべきケース：
  ✅ Flipper Zeroを毎日のように使う
  ✅ 複数プロトコル（SubGHz・IR・NFC等）をまたいで操作する
  ✅ 監査ログ・履歴保全が必要な研究・業務環境
  ✅ ハンズフリー操作が必要な現場作業

V3SP3Rが不要なケース：
  ❌ ごく単純な操作（リモコン記録1本だけ等）を年数回するだけ
  ❌ LLM API利用コストを一切かけたくない
  ❌ iOS専用環境（現状Android専用）

コントリビューションと今後のロードマップ

V3SP3RはGPL-3.0ライセンスで公開されており、928スターが示すように活発なコミュニティが形成されつつある。READMEに記載されたコントリビューション募集領域は明確で、参加しやすい設計になっている。

募集されている領域

• iOS版の開発（SwiftUI）：現状Android専用で、iOS対応は最も要望が多い
• 新プロトコルパーサー：対応する無線プロトコルの拡充（Zigbee・LoRa等）
• 追加ペイロードテンプレート：BadUSB・SubGHz・IR・NFCの事前定義テンプレート
• テストカバレッジ向上：特にBLE通信周りの安定性改善
• i18n対応：多言語化（現状は英語のみ、日本語含む他言語対応は未実装）

セキュリティツールとしての立ち位置

V3SP3Rのリポジトリには、「教育および正当なセキュリティ研究のためのツール」であることが明記されている。所有または明示的な許可を得たデバイスのみを対象とし、適用法令の遵守はユーザーの責任、という典型的なDual-Use Toolの線引きだ。

この情報ツールは、教育および正当なセキュリティ研究を目的としています。所有しているデバイス、または明示的な許可を得たデバイスに対してのみ使用し、適用される法律に準拠してください。

日本の電波法では、技適を取得していない無線機器による電波発射が原則禁止されている。Flipper Zero自体の技適状況とあわせて、国内で運用する場合は「受信（キャプチャ）のみに留める」「送信はシールドボックス内で行う」などの配慮が不可欠だ。V3SP3Rが4段階リスク分類を持っているのは技術的な理由だけでなく、こうした法的・倫理的なガードレールを組み込むための設計でもある。

今後の方向性

公式READMEとIssueトラッカーから見える方向性として、次の3点が挙げられる。

1. スマートグラス連携の拡充：Mentra以外のグラスへの対応
2. マルチモーダル精度の向上：写真からのIR学習、RF波形の視覚解析
3. ローカルLLM対応：OpenRouter依存を減らし、オンデバイスモデルでも動作可能に

特にローカルLLM対応が進めば、ネットワーク遮断環境（現場や検査室）でもAIエージェントをそのまま運用できるようになる。「AIエージェント × 物理デバイス」の本格普及には避けて通れない方向性だ。

📌 まとめ

V3SP3Rは、「AIエージェント × ハードウェア制御」という新カテゴリを切り拓くOSSだ。Flipper Zeroという多機能ハードウェアハッキングツールを、自然言語・写真・音声で操作できるようにし、4段階のリスク分類で安全性も担保している。

本記事のポイントを再整理する。

1. 思想：LLMに「Flipper Zero専門の税理士」として振る舞わせ、メニュー暗記から解放する
2. 構造：Jetpack Compose + Hilt + OpenRouter + BLE の3層アーキテクチャ
3. 機能：自然言語制御・マルチモーダル入力・Alchemy Lab・Payload Lab・FapHub・スマートグラス連携
4. 安全性：Low/Medium/High/Blockedの4段階ティア + 監査ログで事故と追跡性を両立
5. モデル選び：Hermes 4 / Claude Sonnet 4が実運用の第一候補、JSONツール呼び出し精度が鍵
6. ライセンス：GPL-3.0、教育・正当なセキュリティ研究専用、日本では電波法に注意

AIエージェントはソフトウェアの世界から物理デバイスの世界へと染み出している。V3SP3Rはその最前線に立つOSSの1つだ。

「Flipper Zeroは持っているけど、メニュー階層が深くて結局埃をかぶっている」——そんな人こそV3SP3Rの最初のユーザー層だ。OpenRouterアカウントとAndroid端末を用意して、今日からフォルダ1つ分の設定で「話しかけるFlipper Zero」を体験してみてほしい。

参照ソース

• elder-plinius/V3SP3R - GitHub公式リポジトリ
• OpenRouter - AI Model Marketplace
• Flipper Zero 公式サイト
• Mentra Smart Glasses 公式サイト
• Flipper Zero プロトコルドキュメント（公式）