工具与工具集

Hermes Agent 工具概览——可用工具、工具集工作方式及终端后端

本页的 Python 依赖命令使用 PM 准备的源码环境。依赖变更后，请重新激活该 checkout 并重启 Hermes。

工具是扩展 Agent 能力的函数。它们被组织为逻辑上的工具集，可按平台启用或禁用。

可用工具

Hermes 内置了丰富的工具注册表，涵盖网页搜索、浏览器自动化、终端执行、文件编辑、记忆、委托、RL 训练、消息投递等功能。插件还可以提供更多工具，例如 Home Assistant 设备控制由插件目录中的 homeassistant 插件提供。

Honcho 跨会话记忆作为插件目录中的记忆提供者插件提供（hermes plugins install honcho），而非内置工具集。参见 Memory Providers。

高层分类：

分类	示例	描述
Web	`web_search`, `web_extract`	搜索网页并提取页面内容。
X 搜索	`x_search`	通过 xAI 内置的 `x_search` Responses 工具搜索 X（Twitter）帖子和话题——需要 xAI 凭据（SuperGrok OAuth 或 `XAI_API_KEY`）；默认关闭，可通过 `hermes tools` → 🐦 X (Twitter) Search 启用。
终端与文件	`terminal`, `process`, `read_file`, `patch`	执行命令并操作文件。
浏览器	`browser_navigate`, `browser_snapshot`, `browser_vision`	支持文本和视觉的交互式浏览器自动化。
媒体	`vision_analyze`, `image_generate`, `video_generate`, `video_analyze`, `text_to_speech`	多模态分析与生成。`video_generate` 和 `video_analyze` 需手动启用（通过 `hermes tools` 或 `--toolsets` 添加 `video_gen` / `video` 工具集）。
Agent 编排	`todo`, `clarify`, `execute_code`, `delegate_task`	规划、澄清、代码执行及子 Agent 委托。
记忆与召回	`memory`, `session_search`	持久化记忆与会话搜索。
自动化与投递	`cronjob`, `send_message`	支持创建/列出/更新/暂停/恢复/运行/删除操作的定时任务，以及出站消息投递。
集成	MCP server 工具、插件工具	MCP 及插件集成，例如 Home Assistant（`ha_*`，来自插件目录中的 `homeassistant` 插件）。

如需查看由代码派生的权威注册表，请参阅内置工具参考和工具集参考。

Nous Tool Gateway

付费 Nous Portal 订阅者可通过 Tool Gateway 使用网页搜索、图像生成、TTS 和浏览器自动化——无需单独配置 API 密钥。运行 hermes model 启用，或通过 hermes tools 配置各工具。

使用工具集

# 使用指定工具集
hermes chat --toolsets "web,terminal"

# 查看所有可用工具
hermes tools

# 按平台交互式配置工具
hermes tools

常用工具集包括 web、search、terminal、file、browser、vision、image_gen、moa、skills、tts、todo、memory、session_search、cronjob、code_execution、delegation、clarify、messaging、discord、discord_admin、debugging 和 safe。

完整列表（包括 hermes-cli、hermes-telegram 等平台预设以及 mcp-<server> 等动态 MCP 工具集）请参阅工具集参考。

终端后端

终端工具可在不同环境中执行命令：

后端	描述	适用场景
`local`	在本机运行（默认）	开发、可信任务
`docker`	隔离容器	安全性、可复现性
`ssh`	远程服务器	沙箱隔离，防止 Agent 修改自身代码
`singularity`	HPC 容器	集群计算、无 root 权限
`modal`	云端执行	无服务器、弹性扩展
`daytona`	云端沙箱工作区	持久化远程开发环境
`vercel_sandbox`	Vercel Sandbox 云微虚拟机	带快照文件系统持久化的云端执行

配置

# 在 ~/.hermes/config.yaml 中
terminal:
  backend: local    # 或：docker, ssh, singularity, modal, daytona, vercel_sandbox
  cwd: "."          # 工作目录
  timeout: 180      # 命令超时时间（秒）

Docker 后端

terminal:
  backend: docker
  docker_image: python:3.11-slim

单个持久容器，在整个进程生命周期内共享。 Hermes 在首次使用时启动一个长期运行的容器（docker run -d ... sleep 2h），并通过 docker exec 将所有终端、文件及 execute_code 调用路由到同一容器中。工作目录变更、已安装的包、环境调整以及写入 /workspace 的文件，在同一 Hermes 进程的整个生命周期内，跨 /new、/reset 和 delegate_task 子 Agent 均会保留。容器在关闭时停止并删除。

这意味着 Docker 后端的行为类似持久化沙箱虚拟机，而非每次命令都使用全新容器。如果你执行过一次 pip install foo，该包在本次会话的剩余时间内均可用。如果你执行了 cd /workspace/project，后续的 ls 调用将看到该目录。完整的生命周期详情及控制 /workspace 和 /root 是否跨 Hermes 重启保留的 container_persistent 标志，请参阅配置 → Docker 后端。

SSH 后端

推荐用于安全场景——Agent 无法修改自身代码：

terminal:
  backend: ssh

# 在 ~/.hermes/.env 中设置凭据
TERMINAL_SSH_HOST=my-server.example.com
TERMINAL_SSH_USER=myuser
TERMINAL_SSH_KEY=~/.ssh/id_rsa

Singularity/Apptainer

# 为并行 worker 预构建 SIF
apptainer build ~/python.sif docker://python:3.11-slim

# 配置
hermes config set terminal.backend singularity
hermes config set terminal.singularity_image ~/python.sif

Modal（无服务器云）

python -c "import pm; pm.sync_venv(['modal'], explicit=True)"
modal setup
hermes config set terminal.backend modal

Vercel Sandbox

python -c "import pm; pm.sync_venv(['vercel'], explicit=True)"
hermes config set terminal.backend vercel_sandbox
hermes config set terminal.vercel_runtime node24

需同时配置 VERCEL_TOKEN、VERCEL_PROJECT_ID 和 VERCEL_TEAM_ID 三个凭据。此访问令牌配置方式是在 Render、Railway、Docker 及类似平台上进行部署和正常长期运行 Hermes 进程的推荐路径。支持的运行时为 node24、node22 和 python3.13；Hermes 默认使用 /vercel/sandbox 作为远程工作区根目录。

对于本地一次性开发，Hermes 也接受短期 Vercel OIDC token：

VERCEL_OIDC_TOKEN="$(vc project token <project-name>)" hermes chat

在已关联的 Vercel 项目目录中：

VERCEL_OIDC_TOKEN="$(vc project token)" hermes chat

启用 container_persistent: true 后，Hermes 使用 Vercel 快照在同一任务的沙箱重建时保留文件系统状态，其中可包含沙箱内 Hermes 同步的凭据、技能和缓存文件。快照不保留活跃进程、PID 空间或相同的活跃沙箱标识。

后台终端命令使用 Hermes 通用的非本地进程流程：在沙箱存活期间，spawn、poll、wait、log 和 kill 均通过标准 process 工具运行，但 Hermes 不提供清理或重启后的原生 Vercel 后台进程恢复能力。

container_disk 保持未设置或使用共享默认值 51200；Vercel Sandbox 不支持自定义磁盘大小，设置后将导致诊断/后端创建失败。

容器资源

为所有容器后端配置 CPU、内存、磁盘和持久化：

terminal:
  backend: docker  # 或 singularity, modal, daytona, vercel_sandbox
  container_cpu: 1              # CPU 核心数（默认：1）
  container_memory: 5120        # 内存（MB，默认：5GB）
  container_disk: 51200         # 磁盘（MB，默认：50GB）
  container_persistent: true    # 跨会话持久化文件系统（默认：true）

启用 container_persistent: true 后，已安装的包、文件和配置将跨会话保留。

容器安全

所有容器后端均启用安全加固：

只读根文件系统（Docker）
丢弃所有 Linux capabilities
禁止权限提升
PID 限制（256 个进程）
完整命名空间隔离
通过卷挂载实现持久化工作区，而非可写根层

Docker 可通过 terminal.docker_forward_env 接受显式的环境变量白名单，但转发的变量对容器内的命令可见，应视为在该会话中已暴露。

后台进程管理

启动后台进程并进行管理：

terminal(command="pytest -v tests/", background=true)
# 返回：{"session_id": "proc_abc123", "pid": 12345}

# 然后使用 process 工具进行管理：
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")   # 终止进程
process(action="write", session_id="proc_abc123", data="y")  # 发送输入

PTY 模式（pty=true）可启用 Codex 和 Claude Code 等交互式 CLI 工具。

已完成后台进程的结果

后台命令完成后，其退出状态和捕获的输出会保留在当前配置档案中。无头父进程退出或 Hermes 重启后，请恢复启动该命令的会话（或其上下文压缩后的延续会话），再使用原始 session_id 调用 process(action="log") 读取输出、调用 process(action="poll") 查看退出状态。即使知道完整进程标识，其他会话或未绑定所属会话的请求也不能读取保留的结果。process(action="list") 也会列出当前任务或会话的保留结果。

每个配置档案在 logs/process-results/ 下最多保留最近 64 个已完成结果，自完成起保存不超过 7 天。每份记录最多包含滚动输出末尾的 200,000 个字符，始终使用终端的敏感信息脱敏规则，即使实时输出的脱敏功能已关闭。后续读取或写入结果时会清理过期记录。恢复结果不会重新运行命令，也不会重放完成通知。这仅保护父进程存活期间已经完成的工作，不保证未完成的子进程在超时或崩溃后继续运行。

Sudo 支持

如果命令需要 sudo，系统会提示你输入密码（在本次会话内缓存）。也可在 ~/.hermes/.env 中设置 SUDO_PASSWORD。

在消息平台上，如果 sudo 失败，输出中会提示将 SUDO_PASSWORD 添加到 ~/.hermes/.env。