工具与工具集

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

可用工具

Hermes 提供了广泛的内置工具注册表，涵盖网络搜索、浏览器自动化、终端执行、文件编辑、记忆、委托、RL 训练、消息传递、Home Assistant 等。

NOTE

Honcho 跨会话记忆 作为记忆提供商插件（plugins/memory/honcho/）提供，而不是内置工具集。请参阅 插件 了解安装。

高级类别：

类别	示例	描述
Web	web_search, web_extract	搜索网页并提取页面内容。
终端与文件	terminal, process, read_file, patch	执行命令和操作文件。
浏览器	browser_navigate, browser_snapshot, browser_vision	具有文本和视觉支持的交互式浏览器自动化。
媒体	vision_analyze, image_generate, text_to_speech	多模态分析和生成。
智能体编排	todo, clarify, execute_code, delegate_task	规划、澄清、代码执行和子智能体委托。
记忆与回忆	memory, session_search	持久记忆和会话搜索。
自动化与传递	cronjob, send_message	具有创建/列表/更新/暂停/恢复/运行/删除操作的定时任务，以及出站消息传递。
集成	ha_*, MCP 服务器工具, rl_*	Home Assistant、MCP、RL 训练和其他集成。

有关权威的代码派生注册表，请参阅 内置工具参考 和 工具集参考。

使用工具集

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

# 查看所有可用工具
hermes tools

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

常见工具集包括 web, terminal, file, browser, vision, image_gen, moa, skills, tts, todo, memory, session_search, cronjob, code_execution, delegation, clarify, homeassistant, 和 rl。

有关完整集合，包括平台预设（如 hermes-cli, hermes-telegram）和动态 MCP 工具集（如 mcp-<server>），请参阅 工具集参考。

终端后端

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

后端	描述	使用场景
local	在您的机器上运行（默认）	开发、受信任的任务
docker	隔离容器	安全性、可重复性
ssh	远程服务器	沙盒化，让智能体远离其自身代码
singularity	HPC 容器	集群计算、无根
modal	云执行	无服务器、扩展
daytona	云沙盒工作区	持久的远程开发环境

配置

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

Docker 后端

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

SSH 后端

推荐用于安全 —— 智能体无法修改其自身代码：

terminal:
  backend: ssh

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

Singularity/Apptainer

# 为并行工作器预构建 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（无服务器云）

uv pip install modal
modal setup
hermes config set terminal.backend modal

容器资源

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

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

当 container_persistent: true 时，安装的软件包、文件和配置在会话之间保留。

容器安全性

所有容器后端都运行安全加固：

• 只读根文件系统（Docker）
• 丢弃所有 Linux 功能
• 无特权升级
• PID 限制（256 个进程）
• 完全命名空间隔离
• 通过卷持久化工作区，而非可写根层

Docker 可以通过 terminal.docker_forward_env 接收显式的 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）启用交互式 CLI 工具，如 Codex 和 Claude Code。

Sudo 支持

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

警告

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