工具系统与终端后端

Hermes 的工具是 agent 调用外部能力的接口。工具按 toolset 组织，可以按平台或会话启用、禁用，也可以通过 MCP 动态扩展。

内置工具分类

Hermes 内置工具覆盖这些方向：

• Web：web_search、web_extract。
• Terminal & Files：terminal、process、read_file、patch。
• Browser：browser_navigate、browser_snapshot、browser_vision。
• Media：vision_analyze、image_generate、text_to_speech。
• Agent orchestration：todo、clarify、execute_code、delegate_task。
• Memory & recall：memory、session_search。
• Automation & delivery：cronjob、send_message。
• Integrations：Home Assistant、MCP server tools、RL 训练相关工具。

Nous Portal 订阅用户可以通过 Nous Tool Gateway 使用 web search、image generation、TTS 和 browser automation，不需要分别配置每个工具的 API key。

使用 toolset

指定 toolset 启动会话：

hermes chat --toolsets "web,terminal"

查看和配置工具：

hermes tools

常见 toolset 包括 web、search、terminal、file、browser、vision、image_gen、skills、tts、todo、memory、cronjob、code_execution、delegation、homeassistant、messaging、safe 和 rl。

终端后端

terminal 工具可以在不同环境执行命令：

• local：本机执行，默认值。
• docker：容器隔离，适合不信任任务。
• ssh：远程服务器执行，适合把 agent 和宿主环境隔开。
• singularity：HPC / shared machine。
• modal、daytona、vercel_sandbox：云端沙箱。

配置示例：

terminal:
  backend: docker
  docker_image: python:3.11-slim
  cwd: "."
  timeout: 180

SSH 后端需要在 .env 中设置：

TERMINAL_SSH_HOST=my-server.example.com
TERMINAL_SSH_USER=myuser
TERMINAL_SSH_KEY=~/.ssh/id_rsa

容器后端支持 CPU、内存、磁盘和持久化：

terminal:
  backend: docker
  container_cpu: 1
  container_memory: 5120
  container_disk: 51200
  container_persistent: true

后台进程

长任务可以作为后台进程启动，然后用 process 管理：

terminal(command="pytest -v tests/", background=true)
process(action="list")
process(action="poll", session_id="proc_abc123")
process(action="wait", session_id="proc_abc123")
process(action="log", session_id="proc_abc123")
process(action="kill", session_id="proc_abc123")

pty=true 可用于需要交互式终端的工具。命令需要 sudo 时，Hermes 会提示输入密码并在 session 内缓存；也可以在 ~/.hermes/.env 里设置 SUDO_PASSWORD。