# Hermes Agent 工具使用教程


你是否曾经对着 AI 智能体说"帮我查个资料"，结果它只能干聊，既不能上网搜索，也不能帮你执行命令、操作文件？Hermes Agent 内置强大工具系统，将网络搜索、终端执行、浏览器自动化、媒体生成等能力封装为可调用工具与工具集。本文从工具概览、启用方式、核心工具实操、终端后端配置、工具网关集成及安全管理六方面，带你全面掌握工具使用，释放智能体全能力。

## 一、工具与工具集概览

Hermes 工具按功能划分为 **8 大核心类别、47 个独立工具**，并聚合为可一键启用的 **工具集（Toolsets）**，兼顾灵活性与易用性。

### 1.1 核心工具类别

|类别|核心工具|功能说明|
|---|---|---|
|🌐 网络工具|`web_search`、`web_extract`|全网搜索、网页正文提取（支持 Markdown 输出）|
|💻 终端与文件|`terminal`、`read_file`、`patch`|命令执行、文件读写、代码补丁编辑|
|🧭 浏览器|`browser_navigate`、`browser_vision`|无头浏览器控制、页面视觉分析|
|🎨 媒体工具|`image_generate`、`text_to_speech`|AI 绘图、文本转语音（支持多模型）|
|🧠 智能体编排|`todo`、`delegate_task`|任务管理、子任务并行委托|
|📜 记忆工具|`memory`、`session_search`|持久记忆读写、历史会话全文检索|
|⏰ 自动化|`cronjob`、`send_message`|定时任务、跨平台消息推送|
|🔗 集成工具|`mcp_*`、`ha_*`|MCP 外部工具、Home Assistant 智能家居控制|

**图1：Hermes Agent 工具系统总览**

```mermaid
flowchart LR
 A[Hermes 工具系统] --> B[网络工具 搜索与网页提取]
 A --> C[终端与文件 命令执行与读写]
 A --> D[浏览器 导航与视觉分析]
 A --> E[媒体工具 绘图与语音]
 A --> F[智能体编排 任务与委托]
 A --> G[记忆工具 持久记忆与检索]
 A --> H[自动化 定时与推送]
 A --> I[集成工具 MCP与智能家居]
```

### 1.2 工具集（一键启用）

工具集是功能聚合包，无需逐个启用，常用预设：

- `web`：网络搜索 + 网页提取

- `terminal`：终端命令执行

- `file`：文件读写与编辑

- `browser`：浏览器自动化全套

- `memory`：持久记忆与会话搜索

## 二、工具启用与管理

### 2.1 命令行临时启用

启动对话时通过 `--toolsets` 指定工具集，临时生效：

```bash
hermes chat --toolsets "web,terminal"

hermes chat --toolsets "web,terminal,file,browser,memory"

hermes chat --toolsets ""
```

### 2.2 交互式配置（永久生效）

通过 `hermes tools` 进入交互式面板，按需启用 / 禁用：

```bash
hermes tools
```

### 2.3 配置文件设置

编辑 `~/.hermes/config.yaml`，默认工具集：

```yaml
toolsets:
 - web
 - terminal
 - file
 - memory
```

## 三、核心工具实操指南

### 3.1 网络工具（web_search/web_extract）

**场景**：查资料、爬取文档、实时信息获取

```text
帮我搜索2026年大模型发展趋势，总结3个核心方向

提取https://example.com/ai-report的正文，输出Markdown格式
```

### 3.2 终端工具（terminal）

**场景**：系统操作、代码编译、命令行任务

```text
帮我查看当前磁盘占用，列出最大5个目录

在桌面创建test目录，生成5个Markdown笔记文件

编译当前目录下的Go项目，输出编译日志
```

### 3.3 文件工具（read_file/patch）

**场景**：代码编辑、文档修改、配置更新

```text
读取~/projects/config.yaml，高亮关键配置

给main.py添加日志模块，保留原有逻辑
```

### 3.4 媒体工具（image_generate/tts）

**场景**：AI 绘图、语音合成

```text
生成一张科技风AI助手海报，蓝色主调，高清

把“Hermes工具使用教程”转为中文女声语音
```

### 3.5 记忆工具（memory/session_search）

**场景**：跨会话记忆、历史内容检索

```text
记住：Hermes支持200+模型，可一键切换国产/海外模型

搜索之前讨论的“大模型部署方案”相关内容
```

## 四、终端后端配置（执行环境）

终端工具支持 **7 种执行后端**，决定命令运行位置，兼顾安全与灵活性。

### 4.1 后端类型与适用场景

|后端|说明|适用场景|
|---|---|---|
|`local`（默认）|本机直接执行|开发、可信任务|
|`docker`|隔离容器执行|安全沙箱、环境隔离|
|`ssh`|远程服务器执行|远程运维、高性能计算|
|`modal`|无服务器云|弹性扩展、临时任务|

**图2：终端后端选型决策流程**

```mermaid
flowchart TD
 A[选择终端后端] --> B{需要隔离执行？}
 B -->|是| C{需要远程执行？}
 B -->|否| D[local 本地执行]
 C -->|是| E{有固定服务器？}
 C -->|否| F[Docker 沙箱]
 D --> G[适合：开发/可信任务]
 E -->|是| H[SSH 远程执行]
 E -->|否| I[Modal 无服务器]
 F --> J[适合：安全沙箱/环境隔离]
 H --> K[适合：远程运维/高性能]
 I --> L[适合：弹性扩展/临时任务]
```

### 4.2 配置方式

#### （1）命令行设置

```bash
hermes config set terminal.backend docker
```

#### （2）配置文件（config.yaml）

```yaml
terminal:
 backend: docker # 或 local/ssh/modal
 timeout: 300 # 命令超时（秒）
 docker_image: python:3.11-slim
 docker_volumes: # 挂载本地目录
 - "~/projects:/workspace"
```

### 4.3 Docker 后端（安全推荐）

容器运行在 **安全强化模式**：

- 只读根文件系统、无权限提升

- PID 限制（最多 256 进程）

- 完全命名空间隔离，避免宿主机污染

## 五、Nous 工具网关（订阅集成）

**Nous 工具网关**是付费订阅专属能力，**无需单独注册 API 密钥**，一键启用网络搜索、图像生成、TTS、浏览器自动化。

### 5.1 网关包含能力

|工具|替代独立密钥|
|---|---|
|网络搜索 / 提取|`FIRECRAWL_API_KEY`|
|图像生成|`FAL_KEY`|
|文本转语音|`OPENAI_TTS_KEY`|
|浏览器自动化|`BROWSER_USE_API_KEY`|

### 5.2 启用方式

#### （1）模型配置时启用

运行 `hermes model` 选择 Nous Portal，自动提示启用网关：

```text
选择启用Nous Tool Gateway → 勾选工具 → 完成配置
```

#### （2）手动配置

编辑 `config.yaml`，启用网关：

```yaml
web:
 use_gateway: true # 网络工具走网关
image_gen:
 use_gateway: true # 图像生成走网关
```

### 5.3 网关优先级

- `use_gateway: true`：强制走网关，忽略本地密钥

- `use_gateway: false`：优先本地密钥，无密钥时回退网关

## 六、工具安全与权限管理

### 6.1 风险操作确认

高风险操作（删除文件、系统修改、网络请求）**自动触发确认**：

```text
帮我删除~/temp目录
→ 系统提示：确认删除？（输入y确认）
```

### 6.2 安全配置（config.yaml）

```yaml
security:
 credential_redaction: true
 website_blocklist:
 enabled: true
 domains: ["*.torrent", "192.168.0.0/16"]
```

### 6.3 容器安全（Docker 后端）

- 只读根文件系统、禁用权限提升

- 进程数量限制、资源隔离

## 七、常见问题排查

1. **工具调用失败（无权限）**

 - 本地执行：确认文件 / 命令权限

 - Docker 后端：检查容器挂载目录权限

2. **网关工具不可用**

 - 确认 Nous 订阅有效：`hermes status`

 - 重新启用网关：`hermes tools` → 勾选网关工具

3. **终端命令超时**

 - 延长超时时间：`hermes config set terminal.timeout 600`

4. **浏览器工具打不开页面**

 - 检查网络代理：关闭代理 / VPN

 - 确认浏览器镜像正常：`docker images | grep browser`

## 八、总结

Hermes 工具系统以 **分类清晰、灵活可控、安全隔离** 为核心，覆盖从日常操作到复杂自动化的全场景需求。新手可通过 `--toolsets` 快速启用常用组合，进阶用户可配置 Docker 沙箱、集成 Nous 网关或自定义 MCP 工具。掌握工具使用，才能充分释放 Hermes 自进化能力，打造全能 AI 助手。

你是否曾经对着 AI 智能体说"帮我查个资料"，结果它只能干聊，既不能上网搜索，也不能帮你执行命令、操作文件？Hermes Agent 内置强大工具系统，将网络搜索、终端执行、浏览器自动化、媒体生成等能力封装为可调用工具与工具集。本文从工具概览、启用方式、核心工具实操、终端后端配置、工具网关集成及安全管理六方面，带你全面掌握工具使用，释放智能体全能力。

别再让 AI 只会聊天了！Hermes Agent 自带 47 个实用工具，一键解锁智能体真正实力

Hermes Agent 内置 47 个实用工具，覆盖网络搜索、终端执行、浏览器自动化、AI 绘图等 8 大类别，可一键启用工具集。本文带你全面掌握智能体工具使用，释放 AI 全能力。

开发专家

人工智能

开发工具

客户端

HermesAgent工具系统提供47种核心功能，涵盖网络搜索、终端执行、浏览器自动化、AI绘图等8大类别。支持一键启用工具集，可配置Docker安全沙箱和Nous工具网关。教程详细讲解工具启用方式、终端后端配置及安全管理，帮助用户实现从资料查询到代码编辑的全场景AI自动化操作。

语音合成

容器安全

文件系统

服务器

智能体

容器

Docker

2026年中大促 | AI 领航 智绘未来

tclm

thpc

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

别再让 AI 只会聊天了！Hermes Agent 自带 47 个实用工具，一键解锁智能体真正实力-腾讯云开发者社区-腾讯云

别再让 AI 只会聊天了！Hermes Agent 自带 47 个实用工具，一键解锁智能体真正实力

别再让 AI 只会聊天了！Hermes Agent 自带 47 个实用工具，一键解锁智能体真正实力

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐