如何一键启用Hermes Agent内置的47个实用工具速查

想让 Hermes Agent 真正执行任务、而不只是进行对话交流，必须事先开启其内置的 47 个工具——包括网络搜索、终端执行、浏览器控制、AI 绘图等能力，全部依赖这些工具才能正常运转。但具体如何操作，很多朋友一开始就容易卡住。下面这份速查流程，能帮你一次性顺利完成配置。

确认工具是否已加载

启动 Hermes Agent 后，先不要急着执行任务。在 CLI 中输入 hermes tools list，查看输出列表中每个工具当前的启用状态。如果某个工具后面显示的是 disabled，说明它尚未被激活，后续调用该工具时要么直接失败，要么被系统自动忽略。这一点需要特别留意：工具状态并非永久保留，每次重启 Agent 后都必须重新验证。尤其是在修改过配置文件却忘记重启的情况下，很容易误判为“已经启用了”。

启用单个工具（按需启用）

如果你只需要临时启用个别工具，有两种方式可供选择。 **方法一：命令行临时启用（仅当前会话有效）**
在 CLI 中执行：hermes tools enable web_search，将 web_search 替换为你需要的工具名称（例如 terminal、image_generate 等）。这种操作仅在当前会话中生效，一旦 Agent 重启，配置就会丢失。 **方法二：永久启用（推荐做法）**
进入配置目录：cd ~/.hermes/config → 编辑 tools.yaml 文件 → 找到目标工具条目，将其 enabled 字段设为 true。例如： web_search: {enabled: true} **【必须保存文件后重启 hermes 进程，修改才能生效】——这是很多人容易忽略的细节。**

一键启用全部47个工具（工具集模式）

如果觉得逐个开启太麻烦，可以直接使用工具集进行批量激活。 **第一步：确认当前 Profile 下是否已有预置工具集**
运行 hermes toolsets list，查看是否存在现成的 all_tools 或 full 这类工具集。官方 v0.13.0 默认提供的是 default、web、dev、media 四个预设集，并没有一个能一次性启用全部 47 个工具的 all 集。 **第二步：手动创建全量工具集**
在 ~/.hermes/config/toolsets.yaml 文件中，新增如下配置块（如果文件不存在就直接新建）：

all_tools:
  enabled: true
  tools: ["web_search", "web_extract", "terminal", "read_file", "patch", "browser_na vigate", "browser_vision", "image_generate", "text_to_speech", "todo", "delegate_task", "memory", "session_search", "cronjob", "send_message", "mcp_query", "ha_light_toggle", ...]

这里省略了其余 32 个工具名称，完整列表建议直接查阅官方文档 /docs/reference/tools-reference，避免遗漏。这一步很直观：将所有工具名称填入数组，然后启用即可。但要特别留意工具名的拼写——大小写、下划线、连字符，一个都不能错，否则该工具不会被系统识别。 **第三步：启用该工具集**
执行 hermes toolsets enable all_tools。所有列出的工具会一次性批量注册并标记为 enabled，省去了逐个操作的麻烦。

验证启用结果

重启 Hermes Agent 进程（按 Ctrl+C 退出后重新运行 hermes），再次执行 hermes tools list。理想情况下，所有目标工具都应显示为 enabled，且没有红色报错提示。 如果仍有工具显示 disabled，就需要检查其依赖是否都已满足。举个例子：browser_na vigate 需要系统已安装 Chromium 或 Chrome，image_generate 需要配置好 Stable Diffusion API 端点，或者接入了 OpenRouter 的图像模型。这些问题排查起来并不复杂，但很容易被忽略。