工具集参考

工具集是命名的工具组合，用于控制代理可执行的操作。它是按平台、会话或任务来管理工具可用性的主要机制。

工具集的工作原理

每个工具都只属于一个工具集。启用某个工具集后，该集合中的所有工具都会对代理可用。工具集大致分为三类：

• 核心工具集 — 一组逻辑上相关的工具（例如，file 包含 read_file、write_file、patch、search_files）
• 复合工具集 — 将多个核心工具集组合起来，以支持常见场景（例如，debugging 包含文件、终端和网络工具）
• 平台工具集 — 针对特定部署环境的完整工具配置（例如，hermes-cli 是交互式 CLI 会话的默认设置）

配置工具集

按会话（CLI）

hermes chat --toolsets web,file,terminal
hermes chat --toolsets debugging        # 复合工具集，会展开为 file + terminal + web
hermes chat --toolsets all              # 启用全部工具集

按平台（config.yaml）

toolsets:
  - hermes-cli          # CLI 默认工具集
  # - hermes-telegram   # Telegram 网关的覆盖配置

交互式管理

hermes tools                            # 基于 curses 的交互界面，可按平台启用或禁用工具

或在会话中：

/tools list
/tools disable browser
/tools enable rl

核心工具集

工具集	工具	用途
browser	browser_back, browser_click, browser_console, browser_get_images, browser_navigate, browser_press, browser_scroll, browser_snapshot, browser_type, browser_vision, web_search	完整的浏览器自动化功能。包含 web_search 作为快速查询的备用方案。
clarify	clarify	当代理需要澄清时，向用户提问。
code_execution	execute_code	通过 Python 脚本程序化调用 Hermes 工具。
cronjob	cronjob	安排并管理重复性任务。
delegation	delegate_task	启动隔离的子代理实例，实现并行工作。
file	patch, read_file, search_files, write_file	文件读取、写入、搜索与编辑。
homeassistant	ha_call_service, ha_get_state, ha_list_entities, ha_list_services	通过 Home Assistant 控制智能家居。仅在设置 HASS_TOKEN 时可用。
image_gen	image_generate	通过 FAL.ai 进行文生图生成。
memory	memory	持久化的跨会话记忆管理。
messaging	send_message	在会话内向其他平台（Telegram、Discord 等）发送消息。
moa	mixture_of_agents	通过多代理混合模型（Mixture of Agents）实现多模型共识。
rl	rl_check_status, rl_edit_config, rl_get_current_config, rl_get_results, rl_list_environments, rl_list_runs, rl_select_environment, rl_start_training, rl_stop_training, rl_test_inference	强化学习训练环境管理（Atropos）。
search	web_search	仅限网络搜索（不包含内容提取）。
session_search	session_search	搜索过往对话会话记录。
skills	skill_manage, skill_view, skills_list	技能的创建、读取、更新与浏览。
terminal	process, terminal	Shell 命令执行及后台进程管理。
todo	todo	会话内的任务列表管理。
tts	text_to_speech	文本转语音音频生成。
vision	vision_analyze	通过具备视觉能力的模型进行图像分析。
web	web_extract, web_search	网络搜索与网页内容提取。

复合工具集

这些工具集会扩展为多个核心工具集，为常见场景提供便捷的简写方式：

工具集	扩展为	使用场景
debugging	patch, process, read_file, search_files, terminal, web_extract, web_search, write_file	调试会话 — 支持文件访问、终端操作和网络研究，无需浏览器或委托开销。
safe	image_generate, vision_analyze, web_extract, web_search	只读研究与媒体生成。禁止文件写入、终端访问和代码执行。适用于不受信任或受限环境。

平台工具集

平台工具集定义了针对特定部署目标的完整工具配置。大多数即时通讯平台使用与 hermes-cli 相同的工具集：

工具集	与 hermes-cli 的差异
hermes-cli	完整默认工具集，包含交互式 CLI 会话所需的全部核心能力，也是 CLI 的默认设置。
hermes-acp	移除 clarify、cronjob、image_generate、send_message、text_to_speech 和 homeassistant 工具。专注于 IDE 上的编码任务。
hermes-api-server	移除 clarify、send_message 和 text_to_speech。其余全部保留 — 适用于无法进行用户交互的程序化访问场景。
hermes-telegram	与 hermes-cli 相同。
hermes-discord	与 hermes-cli 相同。
hermes-slack	与 hermes-cli 相同。
hermes-whatsapp	与 hermes-cli 相同。
hermes-signal	与 hermes-cli 相同。
hermes-matrix	与 hermes-cli 相同。
hermes-mattermost	与 hermes-cli 相同。
hermes-email	与 hermes-cli 相同。
hermes-sms	与 hermes-cli 相同。
hermes-dingtalk	与 hermes-cli 相同。
hermes-feishu	与 hermes-cli 相同。
hermes-wecom	与 hermes-cli 相同。
hermes-wecom-callback	WeCom 回调工具集 — 企业自建应用消息通信（完全访问权限）。
hermes-weixin	与 hermes-cli 相同。
hermes-bluebubbles	与 hermes-cli 相同。
hermes-qqbot	与 hermes-cli 相同。
hermes-homeassistant	与 hermes-cli 相同。
hermes-webhook	与 hermes-cli 相同。
hermes-gateway	所有消息平台工具集的集合。当网关需要最广泛的工具集时内部使用。

动态工具集

MCP 服务器工具集

每个配置的 MCP 服务器会在运行时生成一个 mcp-<server> 工具集。例如，若配置了一个 github MCP 服务器，则会创建一个名为 mcp-github 的工具集，其中包含该服务器暴露的所有工具。

# config.yaml
mcp_servers:
  github:
    command: npx
    args: ["-y", "@modelcontextprotocol/server-github"]

这将创建一个 mcp-github 工具集，你可以在 --toolsets 或平台配置中引用它。

插件工具集

插件可在初始化阶段通过 ctx.register_tool() 注册自己的工具集。这些工具集会与内置工具集并列显示，并可像其他工具集一样启用或禁用。

自定义工具集

在 config.yaml 中定义自定义工具集，以创建项目特定的工具组合：

toolsets:
  - hermes-cli
custom_toolsets:
  data-science:
    - file
    - terminal
    - code_execution
    - web
    - vision

通配符

• all 或 * — 展开为所有已注册的工具集（内置 + 动态 + 插件）

与 hermes tools 的关系

hermes tools 命令提供了一个基于 curses 的交互界面，允许你按平台逐个开启或关闭单个工具。它的粒度比工具集更细，且会持久化保存到 config.yaml。即使某个工具集已启用，被单独禁用的工具仍会被过滤掉。

另见：工具参考，获取完整的工具列表及其参数说明。