Hermes Agent と OpenClaw から KwaFlux を使う方法（MCP の設定）

要点

• Hermes Agent に KwaFlux を追加するには、hermes mcp add コマンドを 1 回実行するか、~/.hermes/config.yaml の最上位の mcp_servers キーの下に kwaflux の項目を書きます。
• OpenClaw では openclaw mcp set で KwaFlux を追加します。このコマンドは、OpenClaw の設定の mcp.servers の下に項目を書き込みます。
• どちらのエージェントも KwaFlux のサーバーをローカルのプログラムとして起動するため、エージェントはリモートのサーバーではなく、KwaFlux と同じパソコンで動かす必要があります。
• 最初の本番の依頼の前に、それぞれのエージェントの確認コマンド（hermes mcp test または openclaw mcp show）を使いましょう。

Hermes Agent と OpenClaw は、MCP ツールを使えるパーソナル AI エージェントです。どちらも、アプリと一緒にインストールされるローカル MCP サーバーを通じて KwaFlux を操作できます。設定とインストールコマンドは、KwaFlux の設定でそれぞれ生成できます。いちばん大事なルールは 1 つだけで、エージェントを KwaFlux が動いているパソコンで動かすことです。

この記事では、Hermes と OpenClaw に KwaFlux を追加する方法、接続の確認方法、つまずきやすいポイント、最初に頼むとよいことを解説します。

目次

1. エージェントを同じパソコンで動かす必要がある理由
2. 始める前に
3. Hermes Agent：KwaFlux を追加する
4. Hermes Agent：確認とツールの絞り込み
5. OpenClaw：KwaFlux を追加する
6. OpenClaw：登録内容を確認する
7. 最初の依頼
8. トラブルシューティング
9. よくある質問

エージェントを同じパソコンで動かす必要がある理由

KwaFlux の MCP サーバーは stdio サーバーです。エージェントがそれを子プロセスとして起動し、標準入出力でやり取りします。そのプロセスはさらに、同じパソコンの中でしか使えない経路で KwaFlux アプリに接続します。

OpenClaw や Hermes を VPS や自宅サーバーのような常時稼働のサーバーで動かし、スマートフォンからチャットしている人は少なくありません。その構成では、あなたの PC 上の KwaFlux には接続できません。KwaFlux を使うには、エージェントを、少なくとも MCP サーバーを起動する部分を、KwaFlux をインストールして開いている PC か Mac で動かしてください。

始める前に

• KwaFlux 1.0.14 以降を起動しておく。
• PATH の通った Node.js 18 以降。 node --version で確認します。KwaFlux の設定カードも Node.js を探し、下の例のようにそのフルパスを設定に書き込みます。見つからない場合はその旨を表示し、代わりに node と書き込みます。
• KwaFlux では： 設定 › Agent（MCP） を開き、MCP ホスト で Hermes または OpenClaw を選びます。

Hermes Agent：KwaFlux を追加する

コマンドで追加する場合。 インストールコマンドをコピー をクリックして実行します。Windows に既定の場所でインストールした場合は次のとおりです。

hermes mcp add kwaflux --command "C:\Program Files\nodejs\node.exe" --args "C:\Program Files\KwaFlux\Tools\kwaflux-mcp\kwaflux_mcp.mjs"

Hermes がサーバーに接続し、ツールの選択画面を表示するので、使いたいものを残します。

設定ファイルを編集する場合。 設定をコピー をクリックし、~/.hermes/config.yaml に追加します。

mcp_servers:
  kwaflux:
    command: 'C:\Program Files\nodejs\node.exe'
    args:
      - 'C:\Program Files\KwaFlux\Tools\kwaflux-mcp\kwaflux_mcp.mjs'

ファイルにすでに mcp_servers: キーがある場合は、その下に kwaflux: のブロックだけを追加します。mcp: › servers: のように入れ子にしないでください。Hermes が読み込むのは最上位の mcp_servers キーです。追加したら、セッションで /reload-mcp を実行します。

Hermes Agent：確認とツールの絞り込み

• hermes mcp test kwaflux で、サーバーが実際に何を返したかを確認できます。
• チャットでは、Hermes は KwaFlux のツールを mcp_kwaflux_kwaflux_get_app_status のように mcp_kwaflux_<tool> という名前で扱います。
• 一部のツールだけを読み込むには、サーバーの下に include: か exclude: を含む tools: ブロックを追加します。Hermes は含めたツールだけを登録し、両方を設定した場合は include が優先されます。
• Hermes には、ツール呼び出し用の timeout フィールドがあります。KwaFlux の待機ツールは 1 回の呼び出しで最大 300 秒待つことがあるので、長い待機が打ち切られる場合はそれより長く設定してください。

OpenClaw：KwaFlux を追加する

コマンドで追加する場合。 インストールコマンドをコピー をクリックします。Windows では、KwaFlux は次の形式でコマンドを用意します。

openclaw mcp set kwaflux "{\"command\":\"C:\\Program Files\\nodejs\\node.exe\",\"args\":[\"C:\\Program Files\\KwaFlux\\Tools\\kwaflux-mcp\\kwaflux_mcp.mjs\"]}"

エスケープした引用符は、コマンドプロンプト向けの書き方です。PowerShell などで引用符が崩れる場合は、設定ファイルを直接編集してください。Mac では、KwaFlux は JSON をシングルクォートで囲みます。

設定ファイルを編集する場合。 設定をコピー をクリックし、~/.openclaw/openclaw.json にマージします。

{
  "mcp": {
    "servers": {
      "kwaflux": {
        "command": "C:\\Program Files\\nodejs\\node.exe",
        "args": [
          "C:\\Program Files\\KwaFlux\\Tools\\kwaflux-mcp\\kwaflux_mcp.mjs"
        ]
      }
    }
  }
}

バックスラッシュは 2 つ重ねたままにしてください。JSON ではそれが必要です。サードパーティのガイドの中には、サーバーを mcpServers の下に書くものもありますが、OpenClaw 自身の CLI ドキュメントは mcp.servers を使っています。

OpenClaw：登録内容を確認する

• openclaw mcp list と openclaw mcp show kwaflux で、保存された内容を確認できます。
• OpenClaw のドキュメントによると、set と show は設定を読み書きするだけで、「実際には MCP サーバーに接続しない」とのことです。つまり、項目が保存されていても、サーバーが起動する証拠にはなりません。確実を期すなら、エージェントに KwaFlux のツールを呼び出させてください。
• エージェントに新しいツールが見えない場合は、OpenClaw の MCP サーバーを再読み込みするか、ゲートウェイを再起動します。

最初の依頼

まずはこう頼みます。

KwaFlux のツールを使って、KwaFlux が起動しているか確認して、最近のタスクを一覧にして。

続けて、次のように頼めます。

パーソナルエージェントは、手順をつなげて進めるのが得意です。「毎晩、このフォルダーの新しいクリップを YouTube 用に変換して」といった依頼も、エージェントが同じ PC で動いていて、その時間に KwaFlux が開いていれば実現できます。

フレーム補間と、切り抜き・置き換え系のツールはアプリに残してあり、これらを頼まれたアシスタントはあなたをアプリへ案内するよう指示されています。エージェントによるダウンロードは、エージェント許可 の エージェントによるダウンロードを許可 を 毎回確認 にしない限りオフのままです。その設定にすると、KwaFlux はダウンロードのたびにポップアップを表示し、アシスタントもチャットで、そのコンテンツをダウンロードする権利があるかをあなたに確認します。

トラブルシューティング

どのホストにも共通する問題は、KwaFlux MCP のトラブルシューティングガイドをご覧ください。

まとめ

Hermes では、hermes mcp add の行を実行するか、mcp_servers の下に kwaflux ブロックを追加してから /reload-mcp を実行します。OpenClaw では、コマンドプロンプトで openclaw mcp set を実行するか、openclaw.json の mcp.servers を編集します。どちらの場合も、エージェントと KwaFlux は同じパソコンに置き、まずは状態の確認から始めましょう。

パーソナルエージェントから KwaFlux を操作する

KwaFlux には、Hermes Agent、OpenClaw などの MCP アプリ向けのローカル MCP サーバーが入っています。AI 処理はご自身の GPU 上で実行され、メディアファイルが処理のためにアップロードされることはありません。Windows 10（64 ビット、バージョン 1809 以降）、Windows 11、Apple Silicon 搭載の macOS 12 以降で動きます。ファイルの読み込みやアプリの操作にアカウントは不要です。ログインと有料プランが必要なのは、書き出し、変換、ファイル修復、リンクからのファイルダウンロードだけです。

KwaFlux を入手 · プランを見る