第18篇：工具与工具集——AI 的“手脚”

第18篇：工具与工具集——AI 的“手脚”

如果说大模型是 AI 的“大脑”，那工具就是它的“手脚”。没有工具，Hermes 只能跟你聊天；有了工具，它才能帮你搜索网页、操作文件、跑代码、管定时任务——真正动手干活。

下面我们分步拆解 Hermes 的工具系统，让你快速上手。

第1步：认识工具与工具集

工具（Tool）：一个具体函数，比如 web_search（搜索网页）、terminal（执行命令）。
工具集（Toolset）：一组工具的集合，按场景打包，比如 web 工具集包含搜索和抓取，terminal 工具集包含命令执行和进程管理。

Hermes 自带一套覆盖面很广的内置工具注册表，涵盖网页搜索、浏览器自动化、终端执行、文件编辑、记忆、任务委派、定时任务等等。插件还能再加更多工具——比如 Home Assistant 设备控制就来自 homeassistant 这个目录插件（catalog plugin）。

你不需要记住每个工具，只需知道“想干什么，就启用哪个工具集”。

第2步：查看和启用工具集

打开终端，用两个命令搞定：

# 查看所有可用工具
hermes tools

# 聊天时指定使用哪些工具集
hermes chat --toolsets "web,terminal"

hermes tools 是交互式配置界面，你可以按平台（比如 CLI、Telegram）分别勾选要启用的工具集。常用工具集有：web、search、terminal、file、browser、vision、image_gen、skills、tts、todo、memory、session_search、cronjob、code_execution、delegation、clarify、messaging、discord、discord_admin、debugging、safe 等。

第3步：了解工具分类（挑重点）

类别	代表工具	干什么用
网页	`web_search`, `web_extract`	搜索并提取网页内容
终端与文件	`terminal`, `read_file`, `patch`	执行命令、读写文件
浏览器	`browser_exec`, `browser_cdp`, `browser_dialog`, `browser_vault`	自动化操作浏览器：`browser_exec` 通过 CDP 用 Python 驱动 Chromium（含截图）；Camofox 浏览器是独立的目录插件（`hermes plugins install camofox`）
媒体	`image_generate`, `text_to_speech`	生成图片、语音
记忆	`memory`, `session_search`	跨会话记住信息
自动化	`cronjob`	定时任务（创建/暂停/恢复）
集成	MCP 工具、插件工具	接入 MCP 与插件服务，例如 Home Assistant（`ha_*`，来自 `homeassistant` 目录插件）

注意：X（Twitter）搜索工具默认关闭，需要 xAI 凭证后通过 hermes tools 手动开启。跨会话记忆（Honcho）是记忆提供方插件，不是内置工具集，用 hermes plugins install honcho 从插件目录安装，详见记忆提供方文档。

第4步：配置终端后端（重要）

终端工具支持多种执行环境，默认在本地跑：

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

local：本机执行，适合开发。
docker：隔离容器，更安全。
ssh：远程服务器，避免影响本机。
singularity：HPC 容器，现已改为官方插件（hermes plugins install singularity），hermes update 会为已在使用的配置自动安装。

如果你用 Vercel 沙箱跑终端，先同步依赖，再指定镜像：

python -c "import pm; pm.sync_venv(['vercel'], explicit=True)"
hermes config set terminal.backend vercel_sandbox
hermes config set terminal.vercel_image vercel/sandbox/universal:latest

使用 Vercel 沙箱需要同时配置 VERCEL_TOKEN、VERCEL_PROJECT_ID、VERCEL_TEAM_ID 三个凭证。这种访问令牌方式也是 Render、Railway、Docker 等主机上长期运行 Hermes 的推荐做法。新沙箱会从 terminal.vercel_image 启动（默认 vercel/sandbox/universal:latest，旧的 vercel_runtime 预设已被 Vercel 弃用）；Hermes 默认把 /vercel/sandbox 作为远程工作目录。

第5步：避开 Shell 初始化陷阱

Hermes 执行命令时是非交互式的，没有 TTY。如果你在 .bashrc 里加载了 nvm、版本管理器等重型初始化，每个命令都会变慢甚至卡死。建议为 agent 单独配置一个干净的 shell 环境，去掉不必要的启动脚本。

总结：工具集是 Hermes 的能力开关，按需启用；终端后端决定命令跑在哪里；注意 shell 初始化性能。现在你的 AI 不再是“嘴强王者”，而是能动手干活的助手了。

下一篇预告：第19篇将深入讲解 MCP（模型上下文协议）——如何把任意第三方服务接入 Hermes，敬请期待！