在 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 下。
• 两者都是把 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 或家里的服务器，再用手机和它聊天。这种部署连不到你电脑上的 KwaFlux。要用 KwaFlux，就得让 Agent，至少是负责启动 MCP 服务的那部分，跑在装着并开着 KwaFlux 的那台 PC 或 Mac 上。

开始之前

• KwaFlux 1.0.14 或更新版本，并且开着。
• Node.js 18 或更新版本，且在 PATH 中。 用 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_<工具名>，比如 mcp_kwaflux_kwaflux_get_app_status。
• 只想加载部分工具，就在这个服务下加一个 tools: 段，写 include: 或 exclude:。Hermes 只注册包含进来的工具；两者都写时，以 include 为准。
• Hermes 有一个工具调用的 timeout 字段。KwaFlux 的等待工具一次最多等 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\"]}"

这些转义引号是按“命令提示符”（cmd.exe）的规则写的。如果你的 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 自己的命令行文档用的是 mcp.servers。

OpenClaw：检查配置项

• openclaw mcp list 和 openclaw mcp show kwaflux 会显示保存了什么。
• OpenClaw 的文档提醒，set 和 show 只读写配置，“并不会真的连接 MCP 服务”。所以保存成功不代表服务能启动，让 Agent 调一次 KwaFlux 的工具才算数。
• 如果 Agent 看不到新工具，重新加载 OpenClaw 的 MCP 服务，或者重启它的网关。

第一批指令

先说：

用 KwaFlux 的工具查一下 KwaFlux 开着没有，再列出我最近的任务。

然后：

个人 Agent 擅长把好几步串起来。“每天晚上把这个文件夹里新增的片段按 YouTube 格式转一遍”是可行的，前提是 Agent 跑在同一台 PC 上，而且到时 KwaFlux 开着。

智能补帧，以及抠像和替换类工具，仍要在应用里做，助手会被告知把你引导过去。AI 发起下载默认关闭，要在 Agent 授权 里把 允许 Agent 发起下载 设为 每次确认。之后每次下载 KwaFlux 都会弹窗问你，助手也会在对话里请你确认有权下载那些内容。

问题排查

各个宿主都会遇到的问题，见 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 · 查看方案