
确认工具是否已加载
启动 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:这里省略了其余 32 个工具名称,完整列表建议直接查阅官方文档
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", ...]
/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 的图像模型。这些问题排查起来并不复杂,但很容易被忽略。