Hermes-Agent 本地化部署与详细交互式配置实战指南 [LM Studio + QQ ]

Hermes-Agent 本地化部署与详细交互式配置实战指南 [LM Studio + QQ ]

• NousResearch / hermes-agent

本指南记录了将 Hermes-Agent 部署在本地 Windows 工作站，并将其底层逻辑与本地大语言模型（LM Studio）及 QQ 机器人进行对接的完整流程。核心配置思路为：大模型完全本地化运行、剥离所有付费云端 API 请求、严格隔离命令行与远程聊天界面的工具权限。

•         前置部署教程

创建环境：

2026年终极防坑指南：基于 EPGF 架构彻底“本地化” UV 环境与工具

从源代码构建：

拒绝 C 盘漂红：2026 终极版 Hermes-Agent 源码部署与 EPGF 闭环实战

阶段一：环境初始化与配置迁移

在虚拟环境（如 .venv）下激活终端后，运行配置向导：

Bash

hermes setup

阶段二：核心模型与算力节点配置

此阶段我们将 LLM 的推理核心从默认的云端切换至本地的 LM Studio。

阶段三：消息网关与 QQ 机器人接入

这一步将 Hermes 与外部世界连接，我们选择 QQ Bot 作为 AI 人格的交互载体。

阶段四：工具链（Tools）安全隔离配置

Hermes 支持丰富的拓展工具，但为了安全与专注，我们需要对 CLI（命令行界面） 和 QQBot（聊天界面） 制定两套不同的工具权限。

1. 命令行 (CLI) 端工具配置

CLI 端是你亲自操作的最高权限接口，保留基础运维能力，剔除无用云服务。

• 剔除不兼容工具： 输入 25 回车，取消勾选 🖱️ Computer Use (macOS)，因为当前为 Windows 平台 。连续回车确认。

• 浏览器提供商： 选择 1 (Local Browser)，使用本地 Chromium，零 API 开销 。

• 智能家居： 直接回车跳过 Token 绑定 。

• 图片生成： 输入 7 回车，跳过（Skip）所有云端计费接口 。

• 流媒体 (Spotify)： 直接回车，放弃填写 Client ID，保持系统轻量纯净 。

• 语音合成 (TTS)： 输入 1 回车，使用免费且高效的 Microsoft Edge TTS 作为默认发声引擎 。

• 视频生成与搜索： 在对应的云服务提供商选单中，分别输入 4（跳过视频）、11（跳过 Web Search 并使用免费内置 DuckDuckGo）、3（跳过 X 搜索）并回车 。  

  

2. 聊天 (QQBot) 端工具配置

在远程文本交互界面，必须收回底层读写与代码执行权限，防止 AI 理解错误造成系统文件损坏。

• 工具裁剪： 依次输入 3 (Terminal)、4 (File Operations)、5 (Code Execution)、25 (macOS Computer Use) 并分别回车，取消这四项勾选 。再次回车确认配置 。

• 配置提供商（保持与 CLI 纯净路线一致）：

  • 浏览器：输入 1 回车 (Local Browser) 。

  • 生图：输入 7 回车 (Skip) 。

  • TTS：输入 1 回车 (Edge TTS) 。

  • 网页搜索：输入 11 回车 (Skip，默认使用自带的 DuckDuckGo) 。  

    

启动与验收

配置全部完成后，所有的配置文件均安全存放在 C:\\Users\\love\\AppData\\Local\\hermes\\ 目录下 。

你可以通过以下命令立即验证你的部署成果：

• hermes doctor：运行全面的系统健康检查，确保所有本地依赖状态正常 。  

  hermes doctor

  

• hermes：直接在当前终端内与模型开启对话 。  

  hermes

  

• hermes gateway：启动消息网关，让部署好的 QQ 机器人正式上线接收指令 。  

  hermes gateway

  

• 平滑重启（推荐）：

  Bash

  hermes gateway restart

• 强制替换（直接干掉旧进程并启动新的）：

  Bash

  hermes gateway run –replace

• 先停止，后手动启动：

  Bash

  hermes gateway stop

• QQ 聊天机器人测试
  • 输入简单消息进行测试联通情况
    • hi

翻译：