Hermes官方文档Hermes Agent 文档 | Hermes AgentHermes中文文档配置 | Hermes Agent 中文社区前言Hermes Agent 是什么它不是绑定在 IDE 上的编程副驾驶也不是对单一 API 的聊天机器人封装。它是一个自主智能体运行时间越长能力越强。它可以部署在任何地方——5 美元的 VPS、GPU 集群或者闲置时几乎零成本的 serverless 基础设施Daytona、Modal。在 Telegram 上与它对话同时让它在你从未亲自 SSH 登录的云端虚拟机上工作。它不依赖你的本地电脑。快速链接安装在 Linux、macOS、WSL2 或原生 Windows早期测试版上 60 秒完成安装快速入门教程第一次对话及值得尝试的核心功能️学习路径根据你的经验水平找到合适的文档⚙️配置配置文件、提供商、模型及选项消息网关配置 Telegram、Discord、Slack、WhatsApp、Teams 等平台工具与工具集70 内置工具及其配置方式记忆系统跨会话持续增长的持久记忆技能系统智能体创建并复用的程序性记忆MCP 集成连接 MCP 服务器、过滤其工具并安全扩展 Hermes在 Hermes 中使用 MCP实用的 MCP 配置模式、示例与教程️语音模式在 CLI、Telegram、Discord 及 Discord 语音频道中进行实时语音交互️在 Hermes 中使用语音模式Hermes 语音工作流的实操配置与使用模式个性与 SOUL.md通过全局 SOUL.md 定义 Hermes 的默认风格上下文文件影响每次对话的项目上下文文件安全命令审批、授权与容器隔离技巧与最佳实践快速上手充分发挥 Hermes 的潜力️架构底层工作原理❓常见问题与故障排查常见问题及解决方案核心功能闭环学习循环— 智能体管理的记忆配合定期提示、自主技能创建、使用中的技能自我改进、基于 FTS5 的跨会话召回与 LLM 摘要以及 Honcho 辩证式用户建模随处运行不限于本地— 6 种终端后端本地、Docker、SSH、Daytona、Singularity、Modal。Daytona 和 Modal 提供 serverless 持久化——环境闲置时休眠几乎零成本在你所在的地方— CLI、Telegram、Discord、Slack、WhatsApp、Signal、Matrix、Mattermost、Email、SMS、DingTalk、Feishu、WeCom、Weixin、QQ Bot、Yuanbao、BlueBubbles、Home Assistant、Microsoft Teams、Google Chat 等——通过一个网关支持 20 平台由模型训练者构建— 由 Nous Research 创建该实验室是 Hermes、Nomos 和 Psyche 背后的团队。支持 Nous Portal、OpenRouter、OpenAI 或任意端点定时自动化— 内置 cron可向任意平台投递委托与并行— 派生隔离的子智能体以并行处理多个工作流。通过execute_code实现程序化工具调用将多步骤流水线压缩为单次推理调用开放标准技能— 兼容 agentskills.io。技能可移植、可共享并通过 Skills Hub 接受社区贡献完整的 Web 控制— 搜索、提取、浏览、视觉、图像生成、TTSMCP 支持— 连接任意 MCP 服务器以扩展工具能力研究就绪— 批处理、轨迹导出、基于 Atropos 的 RL 训练。由 Nous Research 构建——该实验室是 Hermes、Nomos 和 Psyche 模型背后的团队面向 LLM 和编程智能体本文档的机器可读入口/llms.txt— 每个文档页面的精选索引附简短描述。约 17 KB可安全加载到 LLM 上下文中。/llms-full.txt— 所有文档页面拼接为单一 markdown 文件支持一次性摄取。约 1.8 MB。两个文件同样可通过/docs/llms.txt和/docs/llms-full.txt访问。每次部署时全新生成。Hermes Agent是一个具体的、开源的AI Agent 框架。它的核心特点是自进化能自动沉淀经验、生成技能越用越聪明。你通过hermes chat命令与之交互它负责调用工具、执行任务。一、安装Hermes【环境准备】Hermes Agent可以安装在Linux/macOSWindows(需要安装在WSL2环境)中安装Hermes Agent前需要有如下环境:▲Python(3.11):Agent逻辑运行的基础环境。▲Node.js(22):主要用于支撑浏览器自动化(Playwright)和WhatsApp 桥接等高级功能。▲Git:用于版本控制和一键安装脚本的拉取。▲系统工具:ripgrep/ffmpeg(非硬性依赖缺失时会提示手动安装)方法一指定路径安装推荐以下是将Harness安装在D盘的命令路径可根据情况自定义 ([scriptblock]::Create((irm https://res1.hermesagent.org.cn/install.ps1))) -HermesHome D:\Hermes -InstallDir D:\Hermes\hermes-agent【图示】说明第7步会比较慢请耐心等待二、配置2.1 url和API key填写url和API key。这里根据自己选择的模型对应填入这里我选择的是deepseek的如▲url填入https://api.deepseek.com/v1▲APIkey填入官方申请DeepSeek 开放平台填完到这直接回车就行【说明】选项适用场景是否适合 DeepSeek1. Auto-detect标准 OpenAI 兼容接口✅推荐2. Chat Completions强制使用/chat/completions也可以用但没必要3. Responses / Codex专为 Codex 设计❌ 不适合4. Anthropic MessagesClaude 专用格式❌ 不适合简单总结在Choice [1-4...]后面直接按Enter键使用默认的 Auto-detect 模式继续安装即可。2.2 选择模型根据配置的模型厂商选择对应模型以下2个模型可供选择填入对应名称即可这里我选择的是【deepseek-v4-pro】这里选择使用哪个 DeepSeek 模型按需选择即可选项模型特点推荐场景1deepseek-v4-flash速度更快性价比高日常对话、快速响应、大批量处理2deepseek-v4-pro能力更强推理更深入复杂任务、代码生成、逻辑推理2.3 设置上下文长度即模型一次能处理的最大 token 数直接按 Enter 键让它自动检测就行。2.4 设置API显示名称这里让你给这个 API 配置起个显示名称方便你在 Harness 界面里识别它是哪个服务。操作直接按Enter继续即可。2.5 选择Hermes 执行代码和命令的后端环境操作直接按Enter继续即可这一步是选择Hermes 执行代码和命令的后端环境也就是 Harness 底层用哪个方式来运行工具和代码。直接按 Enter 键选择默认的Keep current (local)即可。各选项说明供参考选项说明适用场景1. Local直接在本地机器上运行命令个人使用、开发测试最常用2. Docker在 Docker 容器中隔离运行需要环境隔离、安全性要求高3. Modal云端无服务器沙箱云端部署、弹性扩展4. SSH通过 SSH 在远程机器运行管理远程服务器5. Daytona云开发环境团队协作、云端开发6. Keep current (local)保持当前设置默认 local✅直接选这个就行2.6 配置消息平台这一步是让你选择要配置哪些消息平台用于让 Hermes/Harness 连接到各种聊天应用比如微信、Telegram、Discord 等。这里直接按 Enter 键不选择任何平台跳过这一步。2.7 配置Hermes 的工具Tools这一步是配置Hermes 的工具Tools也就是 AI 可以调用的各种功能比如浏览器搜索、文件操作、代码执行等。直接按 Enter 键选择默认的Configure CLI (17/26 enabled)继续即可。【各选项说明】选项说明建议1. Configure CLI配置当前已启用的工具17个已启用还有9个未启用✅推荐进去看看有什么工具可以用2. Reconfigure重新配置某个已有工具修改 API Key 或提供者暂时不需要3. Done跳过工具配置直接完成安装也可以但建议先进去看看操作直接按Enter确认默认选项 1进入工具配置界面。2.8启用在 CLI 中使用的工具这里到了最关键的一步——启用在 CLI 中使用的工具。大部分已经默认启用了显示绿色●标记你直接按 Enter确认即可。【说明】绿色●标记的1-6, 8, 12-20, 24已经启用了这些核心功能足够日常使用网页搜索 抓取让 AI 上网查资料浏览器自动化AI 可以操作浏览器终端 进程AI 可以执行命令文件操作读写文件代码执行运行代码图像分析/生成看图、画图TTS 语音文字转语音记忆功能跨会话记住信息任务规划、任务委派复杂任务管理没有启用的7, 9, 10, 11, 21, 22, 23是需要额外配置或特定场景才用的现在不需要。操作直接按Enter键确认当前配置继续完成安装。2.9 完成配置操作输入3然后按Enter。回到工具配置主菜单了这次需要选3. Done来完成配置。因为工具已经配置好了刚才已经确认过启用哪些了现在选择 Done 退出工具配置继续安装流程。2.10 启动Harness完成这一步后Harness 应该就基本安装好了可以开始使用了。1. 先重启终端重要关闭当前的 PowerShell 窗口重新打开一个新的。这样 PATH 变更才能生效。2. 可以忽略 ripprep 的提示ripprep是一个文件搜索工具没有它也能用只是文件搜索会慢一点。如果想装运行winget install BurntSushi.ripprep.MSVC不装也行不影响正常使用。3. 启动 Harness在新终端里运行hermes chat或者如果你想用 TUI终端图形界面模式hermes三、使用Hermes3.1 启动命令在新终端里运行hermes chat到这里我们就可以开始进行对话了3.2 常用命令速查命令作用hermes chat启动 Hermes 对话hermes setup重新配置 API Key 和设置hermes config edit编辑配置文件hermes update更新到最新版本3.3 会话内常用命令在聊天输入框中输入命令作用/exit退出当前会话/clear清空当前会话的对话记录上下文清空但会话保留/reset重置会话类似于 /clear有时效果更彻底/undo撤销最后一条消息或操作如果有/model 模型名在当前会话中切换模型例如/model deepseek-v4-pro/status查看当前会话状态模型、工具、token 使用等/tools查看当前启用的工具列表/memory查看/管理 AI 的记忆内容/save手动保存当前会话通常自动保存但可以手动触发3.4 通用管理命令在终端中非会话内命令作用hermes config edit用编辑器打开配置文件config.yamlhermes setup重新运行配置向导改 API Key、模型等hermes update更新 Hermes 到最新版本hermes doctor诊断和修复环境问题hermes gateway启动消息网关连接 Telegram/Discord 等hermes sessions查看所有历史会话列表hermes logs查看日志文件hermes version查看当前版本3.5 可用工具Hermes在安装好后自带19个tools。可通过命令【/tools】进行查看。工具分类速查分类工具作用 辅助决策clarify拿不准时主动问你比如你确定要覆盖这个文件吗 代码执行execute_code在 Python 环境中运行代码你刚才写贪吃蛇就用到了这个⏰ 定时任务cronjob创建和管理定时任务比如每天8点提醒我 任务委派delegate_task派生子 AI 去并行处理任务各自有独立的上下文 文件操作read_file/write_file/patch/search_files读文件、写文件、找内容、精确修改patch 是只改指定行️ 图像生成image_generate根据文字描述生成图片需模型支持 记忆系统memory保存跨会话的持久记忆比如我叫小明喜欢 Python 会话搜索session_search搜索历史聊天记录 技能管理skill_manage/skill_view/skills_list管理和查看预设的技能模板可以理解成任务配方️ 终端操作terminal/process执行 Linux 命令管理后台进程✅ 任务列表todo当前会话的任务清单帮你拆解复杂任务 语音合成text_to_speech文字转语音输出音频️ 视觉分析vision_analyze加载图片让 AI看需要支持视觉的模型DeepSeek-V4 支持四、常用操作4.1 设置MCP服务魔搭社区MCP广场MCP 广场 · 魔搭社区这里高德mcp服务为例后续如果想再继续添加其他服务一样可以按这个步骤1、打开config.yaml文件在PowerShell中输入命令:hermes config edit随后会弹出config.yml需要在这填入MCP服务字段2、配置高德MCP服务这里我们配置一个高德的MCP。在config.yaml最末尾加上【方式1】或【方式2】的mcp配置字段API申请看下方【说明】部分方式1明文输入APIkey这种方式直接填入对应APikey就可以直接使用但是会有APIkey泄露的风险mcp_servers: amap-maps: command: npx args: [-y, amap/amap-maps-mcp-server] env: AMAP_MAPS_API_KEY: 你的key方式2推荐API配置到.envhermes直接读取对应变量这种方式直接把高德APIkey配置在本地环境可以更好的保护API的安全。mcp_servers: amap-maps: command: npx args: [-y, amap/amap-maps-mcp-server] env: AMAP_MAPS_API_KEY: ${AMAP_API_KEY} # 需要用 ${} 格式【说明】注意1、需要在你的电脑上安装 Node.js。Hermes 会通过npx命令下载并运行高德的 MCP 服务包。2、如果API直接明文填入会有泄露的风险我们可以把高德的APIkey配置先配置在本地环境变量。看下方图示步骤即可【API配置到.env】前面我们把Hermes安装在了D盘先进入到主目录#1、进入到主目录 cd Hermes #2、创建 .env 文件并写入高德 API Key AMAP_API_KEY替换为你的高德API | Out-File -FilePath .env -Encoding utf8执行完后在【D:\Hermes】路径下会出现一个【.env】文件记入的就是你的高德API后续如果有变动也方便自行编辑。API申请部分看下方即可【高德API申请】▲高德API申请地址我的应用 | 高德控制台名称和类型自定义即可复制API即可▲将上面内容填入config.yaml最末尾这里用的【方式2API配置到本地环境hermes直接读取对应变量】记得前面加上“$”▲保存并重启保存配置文件并退出。然后重新启动 Hermes新添加的高德地图工具就会自动生效了。3、启动Hermes启动命令hermes chat在输入对话你现在有哪些mcp工具通过下图我们可以看到检索出了一个地图相关的mcp服务工具这就说明配置成功了4、检查是否可用这里我们问了一下天气可以看到准确成功输出4.2 接入三方平台这里我们通过接入QQ为例来作为演示1、接入平台命令在powershell中输入命令hermes gateway setup2、选择平台可以发现这里有25个平台可供我们接入。这里输入【5】然后回车。3、选择接入方式这里推荐选择【1】扫码方式简单快捷翻译图示4、扫码复制链接显示的是一个二维码手机打开QQ扫码即可5、如何授权信息推荐输入【1】1.使用DM配对审批(推荐)2.允许所有直接消息3.仅允许已列明的用户OpenIDs翻译图示后续全部Yes即可然后重启网关4.3 会话操作▲查看所有历史会话列表说明查看已有的所有会话组列表hermes sessions list▲设置会话标题说明在对话前先设置好会话组标题#进入hermes对话 hermes chat #设置标题 /title 标题名▲导出所有会话说明导出已有的所有会话数据该命令会把所有的会话导出到backup.jsonl文件中hermes sesstons export backup.jsonl▲导出单个会话说明对某个会话组的所有对话进行导出1、先查看已有对话列表hermes sessions list可以发现每个会话组都有一个ID复制对应的会话ID2、将对应会话ID填入导出到session.jsonl文件hermes sessions export session.jsonl --session-id 替换为会话ID▲恢复会话说明在之前的历史会话记录上再次进行对话#查看会话列表 hermes sessions list #恢复对应ID会话 hermes -c 替换为会话ID▲删除指定会话说明对指定的会话ID进行删除方法1删除指定会话IDhermes sessions delete 替换为会话ID方法2进入会话后删除#查看说有会话组 hermes sessions list #恢复会话 hermes -c 替换为会话ID #退出并删除该规划 /exit --delete▲批量删除会话说明按历史会话天数进行批量删除hermes sessions prune --older-than 10执行这个命令后Hermes 会扫描所有会话记录找出创建时间距今超过 10 天的会话删除它们会先让你确认除非加上--yes参数4.4 skill【skill下载地址】skill下载地址Skills 中心 · 魔搭社区AI TemplatesClaude Code Skills: Pre-built Templates Configurationsclaude官网Claude Skills Directory — Browse 21,600 Claude Code Skills方法一下载skills扩展到hermes1、进入skill文件夹在【D:\Hermes\skills】路径下是hermes存放skill工具的文件下2.下载skill这里我们在魔搭社区下载一个skill地址skill-creator · Skills3.解压到【D:\Hermes\skills】路径下4.查询skill是否被加载在powershell中启动hermes#启动hermes hermes输入问题你有哪些skill输入显示可以发现我们下载的skill已经加载进来接下来就可以直接使用了5.指定对应skill/skill-creator 输入的问题注意不是所有的skill都是下载后直接就可以使用的有些服务需要配置API才能使用在下载的时一定得先看说明。4.5 hermes UI界面#1.切换路径 cd D:\Hermes\hermes-agent #替换为自己安装hermes的路径 #2.拉取资源 git clone https://github.com/nesquena/hermes-webui.git hermes-webui #3.切换路径 cd hermes-webui #4.访问 python bootstrap.py --host 0.0.0.0打开浏览器访问http://localhost:8787设置为中文显示配置模型