配置工具系统和终端后端

Hermes 的 tools 是 Agent 调用外部能力的接口，toolsets 是把这些能力按场景打包的开关。新手不要先记工具列表，先理解：每开一个 toolset，Agent 就多了一类可行动作。

先理解工具的风险边界

只会聊天的 Agent，最多给你建议。打开工具后，Agent 可能搜索网页、读写文件、运行命令、操作浏览器、调用记忆、发消息或启动后台任务。

这就是为什么 toolset 要按需开启。不是每个会话都需要 terminal、browser、messaging 或 cronjob。

常见工具类型

官方文档把 Hermes 内置工具大致分成这些方向：

• Web：搜索和抽取网页内容。
• Terminal & Files：运行命令、管理进程、读文件、打补丁。
• Browser：浏览器导航、快照和视觉自动化。
• Media：视觉分析、图片生成、TTS。
• Agent orchestration：计划、澄清、代码执行、任务委派。
• Memory & recall：持久记忆和 session search。
• Automation & delivery：定时任务和消息发送。
• Integrations：Home Assistant、MCP server tools、RL 训练等。

这张分类的用途是帮你判断“当前任务需要哪类动作”，不是要求你一次性全开。

什么时候开哪个 toolset

可以按任务选择：

• 查资料：优先 web 或 search。
• 改本地文件：需要 file，复杂验证才加 terminal。
• 跑测试或脚本：需要 terminal。
• 操作网页：需要 browser。
• 沉淀流程：需要 skills。
• 处理长期上下文：需要 memory 或 session_search。
• 自动提醒或周期任务：需要 cronjob。
• 从聊天平台发出结果：需要 messaging。

如果你说不清为什么要开某个 toolset，先不要开。

终端后端怎么理解

terminal 工具最需要谨慎，因为它决定 Agent 的命令在哪里执行。

新手选择顺序：

• 可信个人项目：先用 local 跑通。
• 不信任脚本或需要复现环境：用 docker。
• 想隔离主机或用远程硬件：用 ssh。
• 云端执行或临时算力：用 modal、daytona、vercel_sandbox。
• HPC 或共享机器：用 singularity。

官方也提醒：local 默认没有隔离，Agent 拥有和你当前用户相同的文件系统访问能力。安全边界不清楚时，不要把 terminal 当成普通聊天能力。

后台进程和 sudo

Hermes 支持把长任务放到后台，再用 process 工具查看、等待、看日志或终止。适合测试、训练、长时间构建这类任务。

新手要注意两点：

• 后台进程仍然占用资源，必须知道如何停止。
• 云端或远程沙箱的持久化不等于进程永久存在，快照通常保留文件系统，不保留 live PID。

如果命令需要 sudo，Hermes 会提示输入密码并在 session 内缓存。消息平台上不要直接发送密码；需要长期自动化时，按官方方式把 SUDO_PASSWORD 放到本地 .env，并理解它暴露给该 session 的风险。

新手常见坑

• 任务只需要读文件，却打开 terminal 和 browser。
• 不知道命令是在本机、容器还是远程服务器执行。
• Docker 转发了不必要的 token。
• 后台进程跑起来后忘记查看或 kill。
• 在消息平台里处理 sudo 或密钥。
• 把 Nous Tool Gateway 和本地 API key 配置混在一起排错。

---

怎么判断工具配置正确

成功标准：

• 当前会话只启用了任务需要的 toolset。
• Hermes 能列出可用工具。
• terminal backend 能跑最小命令。
• 文件改动、命令输出和后台进程日志都能追踪。
• 不需要的 toolset 可以被关闭。
• 含密钥的环境变量没有被无差别转发到容器或远程环境。

工具系统的目标不是“开得多”，而是让 Agent 只获得完成任务所需的最小行动能力。

官方资料

• Hermes Agent: Tools & Toolsets
• Hermes Agent: Configuration
• Hermes Agent: Toolsets Reference
• Hermes Agent: Tools Reference

最近更新：2026年5月4日