ModelRouterModelRouter
利用ガイドインストールAPIリファレンスAIアプリケーションSkillsヘルプ&サポートビジネス協力

AQBot - ローカル優先のデスクトップ AI ワークベンチ

AQBot ガイド — ローカル優先のデスクトップ AI ワークベンチを ModelRouter に接続します。aqbot:// によるワンクリック導入と、OpenAI / Claude / Gemini プロトコルの手動設定に対応します。

チャット設定オプション

ModelRouter コンソールのシステム設定 -> チャット設定で、以下のショートカットオプションを追加できます。これにより、トークン管理ページから AQBot へワンクリックで入力できます:

{ "AQBot": "aqbot://providers?name=New%20API&baseurl={address}&apikey={key}&type=openai" }

AQBot はローカル優先のオープンソース デスクトップ AI ワークベンチ(AGPL-3.0)です。マルチプロバイダー対話、ACP Agent、ナレッジベース、MCP ツール、ローカル API ゲートウェイをひとつにまとめ、アプリデータとユーザーファイルは端末内に保持します。

AQBot

主な機能

  • マルチプロバイダー対話 — OpenAI、Claude、Gemini、DeepSeek、Qwen、および任意の OpenAI 互換エンドポイントに接続
  • プロバイダーのクイック導入 — aqbot:// リンクから確認後にプロバイダーを取り込みます
  • モデル管理 — リモートのモデル一覧、能力タグ、レイテンシテストを同期
  • Agent — 対話内 Agent(設定済みプロバイダー API を使用)と ACP Agent ワークベンチ
  • ローカルデータ — アプリ状態は ~/.aqbot/、ユーザーファイルは ~/Documents/aqbot/

全機能は AQBot 公式サイト を参照してください。このページでは ModelRouter との接続のみを扱います。

ModelRouter 接続方法

自己ホストした ModelRouter を使うか、正規の上流認可とコンプライアンス義務を備えた ModelRouter サービスであることを確認してください。出所不明の API アドレスやキーを本番環境に接続しないでください。

方法一:ワンクリック導入(推奨)

  1. AQBot デスクトップアプリをインストールし、一度は起動して aqbot:// プロトコルを登録します
  2. ModelRouter コンソールの「システム設定 → チャット設定」に上記 JSON を追加します
  3. 「トークン管理」を開き、対象トークンの操作から AQBot を選びます
  4. ブラウザが AQBot を起動します。確認ダイアログでプロバイダー名、APIホスト、タイプ openai、キーのプレフィックスを確認します
  5. 確認後、AQBot は 設定 → プロバイダー管理 を開きます。同じ APIホスト + タイプのプロバイダーがあれば再利用し、なければ新規作成します
  6. そのプロバイダーを開き、モデルを同期 をクリックしてから、対話画面でモデルを選んで使い始めます

{address} は ModelRouter のサイトルート(例:https://your-newapi.example)で、クエリ文字列は付けません。OpenAI タイプでは AQBot が自動で /v1 を補完します。導入時にキー検証やモデル同期は行われません。

方法二:手動設定

  1. ModelRouter のトークン管理ページで API キーをコピーします
  2. AQBot で 設定 → プロバイダー管理 → プロバイダーを追加 を開きます
  3. 次の項目を入力します:
項目入力内容
プロバイダー名例:ModelRouter
プロバイダータイプOpenAI(推奨)
APIホストModelRouter のサイトアドレス。例:https://your-newapi.example
API キーModelRouter のトークン
  1. モデルを同期 をクリックし、 ModelRouter が公開しているモデルを取得します
  2. 対話画面に戻り、同期したモデルを選択して使い始めます

モデルを切り替え

APIホストに関する注意

  • サイトルートだけを入力し、/v1 は AQBot に補完させることを推奨します
  • アドレスがすでに /v1 で終わっている場合、AQBot は追加しません
  • 自動補完を無効にする必要があるときだけ、末尾に ! を付けます

オプション:ネイティブプロトコル

ModelRouter が Claude / Gemini のネイティブ API も提供している場合は、プロバイダーを追加できます:

用途プロバイダータイプAPIホスト
Chat Completions(デフォルト)OpenAIサイトルート
Claude ネイティブ /v1/messagesAnthropicサイトルート
Gemini ネイティブGeminiサイトルート

ワンクリック用テンプレートの type を anthropic または gemini に変更します。同じ API キーを複数のプロバイダーで使えます。

よくある質問

  • AQBot をクリックしてもアプリが開かない:先にデスクトップアプリをインストールして起動してください。公式サイトや開発サーバーだけでは aqbot:// は登録されません
  • 導入は成功したが対話できない:先に「モデルを同期」をクリックし、モデル ID が ModelRouter が公開している名前と一致することを確認してください
  • macOS で「破損している」または「開発元を検証できない」と表示される:AQBot README と公式クイックスタート に従い、このアプリだけを許可してください。Gatekeeper 全体をオフにする必要はありません
  • ワンクリックリンクに API キーが含まれる:ログイン済みのトークンページでのみ生成し、実キーを含む URL を公開ページに載せないでください

関連リンク

このガイドはいかがですか?

最終更新