在 Hermes Agent 和 OpenClaw 裡使用 KwaFlux：MCP 設定教學

重點速覽

• Hermes Agent 只要一行 hermes mcp add 命令，或在 ~/.hermes/config.yaml 最上層的 mcp_servers 鍵底下加一筆 kwaflux 項目，就能加入 KwaFlux。
• OpenClaw 用 openclaw mcp set 加入 KwaFlux，這個命令會把它寫進 OpenClaw 設定裡的 mcp.servers。
• 兩個 Agent 都是以本機程式的方式啟動 KwaFlux 的伺服器，所以 Agent 必須和 KwaFlux 在同一台電腦上執行，不能放在遠端伺服器。
• 第一次正式下指令之前，先用各自的檢查命令確認：hermes mcp test 或 openclaw mcp show。

Hermes Agent 和 OpenClaw 都是能使用 MCP 工具的個人 AI Agent，兩者都可以透過隨 KwaFlux 一起安裝的本機 MCP 伺服器來操作 KwaFlux。KwaFlux 的設定會為兩者分別產生設定內容和安裝命令。最重要的一條規則是：Agent 必須在執行 KwaFlux 的那台電腦上執行。

本文會說明：如何把 KwaFlux 加進 Hermes 和 OpenClaw、如何檢查連線、大家通常在哪裡出錯，以及一開始可以先問什麼。

目錄

1. 為什麼 Agent 必須在同一台電腦上
2. 開始之前
3. Hermes Agent：加入 KwaFlux
4. Hermes Agent：檢查並限制工具
5. OpenClaw：加入 KwaFlux
6. OpenClaw：檢查設定項目
7. 先試這幾個指令
8. 問題排解
9. 常見問題

為什麼 Agent 必須在同一台電腦上

KwaFlux 的 MCP 伺服器是 stdio 伺服器：Agent 把它當成子處理程序啟動，並透過標準輸入與輸出和它溝通。這個處理程序再透過一條只在同一台電腦上才能運作的通道，連到 KwaFlux 應用程式。

很多人把 OpenClaw 或 Hermes 跑在一台不關機的伺服器上，例如 VPS 或家用伺服器，再用手機和它聊天。這種架構連不到你 PC 上的 KwaFlux。想使用 KwaFlux，就要把 Agent，或至少是負責啟動 MCP 伺服器的那一部分，放在已安裝並開啟 KwaFlux 的 PC 或 Mac 上執行。

開始之前

• KwaFlux 1.0.14 或更新版本，並保持開啟。
• Node.js 18 或更新版本，並在 PATH 中。 用 node --version 確認。KwaFlux 的設定卡片也會尋找 Node.js，並把它的完整路徑寫進設定，就像下面的範例那樣；如果找不到 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_<tool>，例如 mcp_kwaflux_kwaflux_get_app_status。
• 只想載入部分工具，就在該伺服器底下加一個 tools: 區塊，寫上 include: 或 exclude:。Hermes 只會註冊列入 include 的工具；兩者都設定時，以 include 為準。
• Hermes 有一個控制工具呼叫的 timeout 欄位。KwaFlux 的等待工具一次呼叫最多可以等 300 秒，所以如果長時間的等待被切斷，就把它設得比 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\"]}"

這些跳脫過的引號是照「命令提示字元」的規則寫的。如果你的 Shell 把它們弄亂了（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"
        ]
      }
    }
  }
}

請保留雙反斜線，JSON 需要這樣寫。有些第三方指南把伺服器放在 mcpServers 底下；OpenClaw 自己的 CLI 文件用的是 mcp.servers。

OpenClaw：檢查設定項目

• openclaw mcp list 和 openclaw mcp show kwaflux 會顯示已儲存的內容。
• OpenClaw 的文件特別說明，set 和 show 只會讀寫設定，「並不會真的連線到 MCP 伺服器」。所以設定項目存好了，不代表伺服器能啟動。要確認的話，請 Agent 呼叫一個 KwaFlux 工具。
• 如果 Agent 看不到新的工具，就重新載入 OpenClaw 的 MCP 伺服器，或重新啟動它的閘道（gateway）。

先試這幾個指令

先從這句開始：

用 KwaFlux 的工具確認 KwaFlux 有沒有在執行，再列出我最近的任務。

接著可以試試：

個人 Agent 很擅長把好幾個步驟串起來。像「每天晚上，把這個資料夾裡新增的片段轉成 YouTube 用的格式」這樣的要求也做得到，前提是 Agent 在同一台 PC 上執行，而且那個時間 KwaFlux 是開著的。

補幀，以及去背和替換類工具，都留在應用程式裡；遇到這些需求時，AI 助理會被告知請你回到應用程式操作。Agent 發起下載預設保持關閉，除非你在 Agent 授權 底下把 允許 Agent 發起下載 設為 每次確認。之後每次下載，KwaFlux 都會跳出視窗，AI 助理也會在對話裡請你確認自己有權下載該內容。

問題排解

各個宿主都可能遇到的問題，請見 KwaFlux MCP 問題排解指南。

結語

Hermes 的做法是執行 hermes mcp add 那一行，或在 mcp_servers 底下加一個 kwaflux 區塊，再執行 /reload-mcp。OpenClaw 的做法是在命令提示字元裡執行 openclaw mcp set，或編輯 openclaw.json 裡的 mcp.servers。無論哪一個，都要讓 Agent 和 KwaFlux 在同一台電腦上，並先從查詢狀態開始。

用你的個人 Agent 操作 KwaFlux

KwaFlux 內建本機 MCP 伺服器，支援 Hermes Agent、OpenClaw 和其他 MCP 應用程式。AI 處理在你自己的 GPU 上執行，媒體檔案不會為了處理而上傳。可在 Windows 10（64 位元，1809 或更新版本）、Windows 11，以及搭載 Apple Silicon 的 macOS 12 或更新版本上執行。匯入檔案和瀏覽應用程式都不需要帳號。僅在匯出、轉換、檔案修復和從連結下載檔案時需要登入並購買付費方案。

下載 KwaFlux · 查看方案