Hermes智能体使用指南

Hermes智能体使用指南

Hermes智能体是由Nous Research研发的开源自主AI智能体，区别于普通聊天机器人和代码助手，它具备自我进化、持久记忆、多平台适配等核心优势，可运行在多种基础设施上，通过40+内置工具完成各类自动化任务，是开发者、研究者及普通用户的高效辅助工具。本文将从核心认知、安装部署、基础操作、高级功能、场景应用、故障排查及日常维护七个维度，详细讲解其使用方法，严格控制3000字，兼顾易懂性和实用性，帮助不同需求的用户快速上手。

一、Hermes智能体核心认知

Hermes智能体的核心定位是"自我进化的持久化AI助手"，其核心优势在于闭环学习系统和多场景适配能力，与传统AI工具相比，它具备三大显著特点。一是持久记忆，通过FTS5全文检索与LLM摘要技术，跨会话记住用户偏好、项目上下文和操作习惯，无需重复说明，使用时间越长越懂用户；二是自主技能创建，能从交互经验中提炼可复用的程序性技能，且技能可在使用中持续优化，还可通过agentskills.io社区实现分享与移植；三是多平台与多环境兼容，支持CLI、Telegram、Discord等多种交互方式，可部署在本地、Docker、VPS等多种环境，闲置时几乎零成本。

其核心架构由记忆系统、技能系统、消息网关和终端后端四部分组成，内置40+工具，涵盖网页搜索、文件操作、终端命令、图像生成等，支持200+LLM模型，可通过OpenRouter、OpenAI、本地Ollama等多种提供商接入，无供应商锁定，灵活适配不同用户的使用需求，无论是开发者自动化、个人助手还是团队协作，都能发挥高效作用。

二、安装部署步骤

Hermes智能体支持Linux、macOS及Windows（需通过WSL2）系统，安装过程简单高效，60秒即可完成基础部署，具体步骤如下。

第一步，环境准备。Linux和macOS用户可直接使用终端操作；Windows用户需先安装WSL2，打开PowerShell输入指令启用WSL2，重启电脑后安装Ubuntu等Linux发行版，进入WSL2终端后即可执行后续安装命令。确保系统已安装curl工具，若未安装，Linux用户可通过"sudo apt install curl"、macOS用户通过"brew install curl"完成安装。

第二步，一键安装。在终端输入官方安装命令：curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash，执行后脚本会自动安装Python、Node.js及相关依赖，无需手动干预。安装完成后，执行"source ~/.bashrc"或"source ~/.zshrc"重载shell，确保指令生效。

第三步，初始配置。输入"hermes setup"启动配置向导，按照提示完成LLM提供商选择、工具启用等基础设置；也可通过"hermes model"单独选择模型和提供商，"hermes tools"配置启用的工具。首次配置时，系统会自动检测是否有OpenClaw（Hermes前身）数据，可选择"hermes claw migrate"完成数据迁移，保留原有配置和记忆。

第四步，部署验证。输入"hermes"启动智能体，若出现欢迎横幅，显示当前模型、可用工具和技能，即表示部署成功。若需部署在Docker或远程服务器，可执行"hermes config set terminal.backend docker"（Docker部署）或"hermes config set terminal.backend ssh"（远程服务器部署），后续按照提示完成相关配置即可。

三、基础操作指南

（一）启动与退出

启动Hermes智能体有两种方式：一是基础启动，终端输入"hermes"，直接进入交互式对话界面，支持多行输入（按alt+enter或ctrl+j换行），适合快速执行简单任务；二是会话恢复，退出后若需继续之前的会话，输入"hermes --continue"或简写"hermes -c"，即可恢复最近一次会话，无需重新输入上下文。

退出操作可通过两种方式完成：一是输入"/exit"指令，正常退出并保存会话；二是使用"ctrl+c"强制中断，系统会自动保存当前会话，下次启动可通过恢复指令继续操作。需要注意的是，强制中断可能导致正在执行的工具任务终止，建议优先使用"/exit"正常退出。

（二）核心交互操作

交互式对话是最基础的使用方式，启动后直接输入指令即可，智能体会自动调用相关工具完成任务。例如，输入"查询当前磁盘使用率，显示前5个最大目录"，智能体会自动运行终端命令，返回具体结果；输入"生成一张风景图片"，则会调用图像生成工具完成创作。

斜杠命令是核心操作指令，输入"/"会出现自动补全下拉菜单，常用命令包括：/help（查看所有可用命令）、/tools（列出当前启用的工具）、/model（切换模型）、/personality（切换人格风格）、/save（保存当前会话）。例如，输入"/model"，可交互式选择不同的LLM提供商和模型，无需修改代码即可切换，灵活性极强。

任务中断与调整：若智能体执行任务耗时过长，可直接输入新指令并回车，即可中断当前任务，切换到新指令；也可使用"ctrl+c"强制中断，中断后可重新输入指令继续操作。对于多步骤任务，智能体会自动拆分步骤，若需调整某一步骤，直接输入修改指令即可，无需重新发起任务。

（三）基础配置调整

通过"hermes config"相关指令可调整基础配置：输入"hermes config"查看当前所有配置；输入"hermes config edit"打开配置文件，手动修改参数；输入"hermes config set 配置项 数值"，可快速修改特定配置，例如"hermes config set openai_base_url http://localhost:11434/v1"，可将模型提供商切换为本地Ollama。配置文件默认位于"\~/.hermes/config.yaml"，可根据需求手动编辑，修改后需重启智能体生效。

四、高级功能使用

（一）记忆与技能管理

Hermes智能体的记忆系统分为四层，无需手动维护，智能体会自动整理：提示记忆（MEMORY.md + USER.md），存储核心信息，每次会话自动加载；会话搜索（SQLite + FTS5），存储历史会话，按需检索；技能（程序性记忆），存储可复用任务步骤；情景记忆，记录任务执行轨迹。用户可通过"hermes memory add 内容"手动添加记忆，"hermes memory remove 内容"删除指定记忆。

技能管理方面，智能体会在完成复杂任务后自动创建技能文件（存储于"~/.hermes/skills/"），用户可通过"hermes skill list"查看所有技能，"hermes skill delete 技能名"删除无用技能，也可手动编写技能文件，遵循agentskills.io标准，实现技能复用与分享。技能会在使用中自动优化，无需手动更新。

（二）并行子智能体使用

Hermes支持派生并行子智能体，处理多任务并行工作流，通过"delegate_task"工具实现。例如，同时执行三个任务："研究A主题""研究B主题""修复项目构建错误"，可输入对应的委托指令，子智能体会独立执行任务，仅将最终结果反馈给主智能体，不占用主会话上下文。

使用子智能体时，需明确指定任务目标和上下文，避免因信息不足导致任务失败。例如，委托修复代码错误时，需详细说明错误信息、项目路径和相关环境，确保子智能体获取足够信息。子智能体默认隔离上下文，无主智能体的历史记忆，需手动传递必要信息。

（三）多平台接入与定时自动化

通过消息网关，Hermes可接入Telegram、Discord、Slack、WhatsApp等多种平台，实现跨设备交互。配置方法：输入"hermes gateway setup"，按照提示绑定对应平台账号，绑定后即可在平台上直接与智能体对话，实现远程控制。

内置Cron调度器，支持定时自动化任务，用户可通过自然语言描述任务，设置执行频率，智能体会自动定时执行并将结果推送到指定平台。例如，设置"每天早上8点推送当日天气和工作清单"，智能体会自动调用网页搜索工具获取天气，生成工作清单并推送，实现无人值守运行。

五、典型场景应用

（一）开发者自动化

开发者可利用Hermes实现工作流自动化，例如，自动运行终端命令、管理项目文件、调试代码错误、搭建CI流水线等。输入相关指令，智能体会调用终端、文件操作等工具，完成任务并生成报告。例如，输入"检查项目中所有Python文件，将print语句替换为logging模块"，智能体会自动遍历文件、修改代码，完成后反馈修改结果，大幅提升开发效率。

（二）个人AI助手

作为个人助手，Hermes可处理日常重复性任务，例如，定时推送报告、整理文档、检索信息、语音转写与翻译等。通过Telegram等平台绑定，可随时随地发送指令，智能体会在云端后台执行任务，即使关闭本地终端也不影响。例如，发送"将语音备忘录转写为文字并翻译为英文"，智能体会调用转录和翻译工具，完成后反馈结果。

（三）研究与分析

研究者可利用Hermes的网页搜索、内容提取、批处理等功能，快速收集研究资料、分析数据、生成研究报告。支持Atropos RL训练的轨迹导出，可用于训练下一代工具调用模型。例如，输入"收集近一年AI智能体相关研究论文，提取核心观点并生成摘要"，智能体会自动搜索、筛选论文，完成摘要生成，节省研究时间。

（四）团队协作

团队可通过Slack、Discord等平台接入Hermes，实现团队级AI协助。设置团队共享记忆和技能，成员可共同调用智能体完成任务，例如，项目文档协作、任务分配、进度跟踪等。通过访问控制列表，可限制成员权限，确保数据安全，提升团队协作效率。

六、常见问题与故障排查

（一）安装失败

常见原因：系统环境不兼容、curl工具未安装、网络问题导致依赖下载失败。解决方法：Windows用户确保已安装WSL2并进入终端；安装curl工具后重新执行安装命令；网络不佳时，更换网络或手动下载安装脚本执行；若仍失败，输入"hermes doctor"诊断配置问题，根据提示修复。

（二）无法启动或会话异常

原因：配置文件错误、模型提供商未正确配置、会话文件损坏。解决方法：输入"hermes config edit"检查配置文件，恢复默认配置；通过"hermes model"重新配置模型提供商，确保API密钥或地址正确；删除损坏的会话文件（位于"~/.hermes/sessions/"），重新启动智能体。

（三）工具调用失败

原因：工具未启用、权限不足、工具依赖缺失。解决方法：输入"/tools"查看工具启用状态，通过"hermes tools"启用对应工具；Linux/macOS用户可通过"sudo"提升权限，确保智能体拥有足够操作权限；安装缺失的工具依赖，根据错误提示执行对应安装命令。

（四）数据安全与隐私问题

Hermes不收集遥测数据、使用数据或分析数据，对话、记忆和技能均存储在本地"~/.hermes/"目录；API调用仅发送至用户配置的LLM提供商，本地模型可实现完全离线使用。若需增强安全性，可部署在Docker容器或远程服务器，限制访问权限，定期备份本地数据。

七、日常维护与注意事项

日常维护可延长Hermes智能体的稳定运行时间：定期清理会话文件和无用技能，避免占用过多存储空间；每月检查配置文件，及时更新模型提供商和API信息；使用本地部署时，定期备份"~/.hermes/"目录，防止数据丢失；避免在潮湿、高温环境下运行服务器，确保部署环境稳定。

注意事项：不随意修改系统默认配置，避免导致功能异常；不向智能体输入敏感信息，确保数据安全；使用远程部署时，做好服务器安全防护；遇到无法解决的故障，可查看官方文档或社区论坛，或联系技术支持，切勿自行拆解配置文件。

总结：Hermes智能体的使用核心是掌握安装部署、基础交互和高级功能，利用其自我进化和多场景适配优势，可大幅提升工作效率。本文严格控制3000字，涵盖全流程使用方法，适合不同需求的用户快速上手，充分发挥其持久记忆、自主技能等核心优势，实现自动化、智能化办公与学习。