想让 Hermes Agent 真正投入实际工作,而不仅仅是陪你闲聊,就必须先将它自带的全部 47 个工具逐一激活——网络搜索、终端执行、浏览器控制、AI 绘图,这些核心功能全赖这些工具驱动,缺一不可。
先聊一个实际困扰:很多用户启动 Agent 后,要求它“帮我搜个资料”或“运行一条命令”,结果却发现它要么毫无反应,要么直接报错。根源很简单——工具未开启。Hermes Agent 默认并不会把所有工具都摆在明面上,你必须手动将它们逐个唤醒。

确认工具是否已加载
启动 Hermes Agent 后,在 CLI 中输入:hermes tools list,查看输出列表中每个工具的状态。如果显示 disabled,说明该工具尚未激活,后续调用它将直接失败,或被系统忽略。
这里需要特别警惕:工具状态并非永久有效。每次重启 Agent 后都必须重新验证,尤其是在修改配置文件后未重启时,很容易误以为“已经启用”。这是一个常见陷阱,不少人在配置完成后忘记重启,结果排查半天才找到问题。
启用单个工具(按需启用)
方法一:命令行临时启用
在 CLI 中执行:hermes tools enable web_search,将 web_search 替换为你需要的工具名(例如 terminal、image_generate)。但该方法有一个限制:仅对当前会话生效,重启后会失效。适合临时测试使用。
方法二:永久启用(推荐)
进入配置目录: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_navigate", "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_navigate 需要系统中安装了 Chromium 或 Chrome;image_generate 需要配置好 Stable Diffusion API endpoint 或接入 OpenRouter 图像模型。缺少这些底层依赖,仅在配置中启用是无效的——Agent 会直接拒绝执行。
