网站Logo
    首页 / 详情
Site icon

Hermes Agent

基本信息

聊天工具 浏览器 自动化 开源 个人助手 agent 前端开发 代码生成 代码补全 AI编程 工作流 数据处理 文件整理 翻译 阅读 写作 研究
访问
Hermes Agent 网站截图预览

工具详情

Hermes Agent 使用指南

1. 项目概况

Hermes Agent 是 Nous Research 于 2026 年 2 月开源发布、基于 MIT 开源协议的自成长型本地自托管 AI 智能体。

  • 官网地址：https://hermes-agent.org/zh/
  • 核心定位：常驻型持久化个人/团队 AI 智能体。区别于云端聊天机器人或 IDE 代码补全工具，它常驻服务器或个人电脑，能够持续迭代成长，熟悉用户习惯与项目，自主沉淀可复用工作技能。
  • 部署系统：支持 Linux、macOS、WSL2（Windows 原生为实验版，优先使用 WSL2）、Termux（安卓手机）。支持本地裸机、Docker 容器、SSH 远程服务器、云端 HPC/Modal 算力部署。
  • 隐私规则：遵循零云端数据采集、无遥测上报原则。所有记忆、配置、技能文件默认存储在本机 ~/.hermes/ 目录，数据完全由用户掌控。

2. 项目核心特点

  1. 全开源无捆绑：源代码完全公开可审计，无官方云托管订阅服务。
  2. 自闭环学习：采用三层记忆架构并自动生成技能，形成自主优化闭环。
  3. 全模型兼容：不限定大模型厂商，支持本地开源大模型、第三方 API、自研兼容接口。
  4. 多渠道消息互通：统一网关接入 5+ 主流聊天平台，实现跨端无缝对话。

二、核心主要功能

（一）五大王牌核心能力

1. 三层持久记忆系统（产品最大亮点）

  • 短期工作记忆：记录当前对话即时上下文。
  • 程序性技能记忆：自动将解决问题的方案保存为 Markdown 技能文档。
  • 长期全量记忆：跨会话永久保存用户偏好、项目资料、历史任务，内置 FTS5 全文检索。下次对话自动调取历史信息，无需重复交代背景。
  • 存储路径：所有数据本地化存储于 ~/.hermes/memory/ 目录。

2. 自动技能生成系统（自进化核心）

  • 内置 40+ 开箱即用技能：涵盖 GitHub 运维、MLOps、数据图表、笔记管理、爬虫、代码调试等场景。
  • 自主创建新技能：完成复杂任务后自动生成标准化 SKILL.md 技能文件，遵循 agentskills.io 开放标准，支持本地检索、跨用户分享安装及一键复用。
  • 技能管理：支持手动增删改查技能，可自定义专属工作流。

3. 多平台统一消息网关

  • 接入渠道：一键接入 Telegram、Discord、Slack、WhatsApp、Signal、终端 CLI 等。
  • 跨端接续：支持语音转文字，实现跨平台无缝接续对话（例如：在 Telegram 发起任务，在终端继续处理）。
  • 后台服务：可部署为系统后台服务，支持 7×24 小时在线值守。

4. 自动化调度与并行子智能体

  • Cron 定时任务：内置定时调度，支持无人值守自动推送日报、服务器备份、周报审计、晨间简报至任意绑定聊天平台。
  • 隔离子 Agent：自动创建多个独立子智能体并行处理多任务，各子 Agent 拥有独立终端与对话空间，通过 RPC 压缩多步骤流水线，降低上下文损耗。

5. 全链路工具执行能力

  • 多环境运行命令：支持本地终端、Docker 安全沙箱、SSH 远程服务器、云端 Modal/HPC 集群执行脚本与代码。
  • 全功能浏览器自动化：支持网页搜索、页面内容提取、自动点击/输入/截图、图像生成、图文 OCR、TTS 文字转语音。
  • MLOps 专项：支持批量生成 AI 训练数据集、RL 强化学习实验、ShareGPT 格式对话导出用于大模型微调及训练数据压缩优化。

（二）大模型接入方案

共有 4 类大模型接入方案可选：

  1. Nous Portal：官方平台，支持 OAuth 一键授权接入。
  2. OpenRouter：填入 API Key 一键调用 200+ 国内外大模型。
  3. 自定义 API：支持任意 OpenAI 兼容格式本地或云端模型接口。
  4. vLLM：全本地化部署开源大模型，支持完全脱离外网 API 计费。

三、适用人群（适合/不适合明细）

✅ 推荐使用人群

  1. 程序员/后端/运维工程师：适合自动化服务器运维、代码批量处理、GitHub 项目管理、定时脚本执行、MLOps 训练自动化。
  2. AI 研发/算法研究者：适合批量生成微调数据集、强化学习实验、Agent 架构调试、本地私有化模型落地。
  3. 自由职业/内容创作者：适合定时内容选题、全网素材爬虫、周报自动整理、跨平台内容分发。
  4. 中小企业小团队负责人：适合低成本搭建团队专属内勤 AI，接入 Slack/企业微信做自动化客服、数据报表推送。
  5. 隐私敏感重度用户：适合不想对话数据上传第三方云端，需要 24h 在线私人智能助理、长期沉淀个人知识库的用户。
  6. 跨境从业者：适合接入 Telegram/WhatsApp，自动处理海外客户消息、定时业务报表。

❌ 不适合人群

  1. 纯小白/零基础命令行用户：只想网页点开即用、零配置聊天，无法忍受命令行操作。
  2. 排斥配置用户：不愿自建服务器/本地部署、不想管理 API 密钥、完全排斥前期配置。
  3. 简单单次问答需求：仅需要简单单次问答、无长期自动化或知识库沉淀需求的用户。

四、免费&付费详情（重点避坑：警惕山寨付费）

1. Hermes Agent 本体：永久 100% 免费开源

  • 无官方收费：软件源码、全部内置功能、40+ 基础技能无任何官方收费、无订阅、无年费。
  • 协议支持：MIT 协议可商用、自由二次修改。
  • 本地模型：本地部署 vLLM 开源大模型（如 Llama、Qwen）全程零费用，不产生任何 API 开销。

2. 可选隐性自费项目（按需自愿付费，非强制）

  • 大模型 API 调用费（可选）：
  • 若使用 OpenRouter、OpenAI、DeepSeek 等第三方 API，需按 token 消耗付费，部分平台提供免费额度。
  • Nous Portal：提供免费基础套餐（需信用卡注册），高阶商用套餐按需订阅。
  • 注：小米 MiMo 等模型曾限时免费接入活动。
  • 硬件成本（可选）：
  • 本地电脑部署：零额外开销。
  • VPS 云端 7×24 挂机：最低$5/月低配云服务器即可稳定运行（1 核 1G 内存）。
  • 本地跑超大模型：需购置高显存显卡硬件成本。

3. 重大防坑：山寨收费陷阱

  • 官方声明：官方从未授权任何第三方云托管付费服务。
  • 警惕山寨网站：hermes-agent.ai 等网站售卖 59 美元/月托管版均为假冒。
  • 操作建议：不要付费购买非官方云托管，所有云托管均为第三方私自打包非官方服务。

五、分步使用安装指南（5 步快速上手）

环境要求：Linux/macOS/WSL2 终端。Windows 用户必须先装 WSL2 再操作。

步骤 1：一键自动安装（无 sudo 也可执行）

使用官方脚本自动安装 uv、Python3.11、依赖环境并拉取项目源码：

bash

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

步骤 2：交互式配置大模型

通过向导式配置模型服务商或单独修改模型源：

bash

# 向导式配置模型服务商
hermes setup

# 单独修改模型源
hermes model
# 向导式配置模型服务商
hermes setup

# 单独修改模型源
hermes model
  • 按需填入：OpenRouter 密钥/Nous 账号/自定义本地模型接口。
  • 配置保存：完成大模型绑定。

步骤 3：启动 CLI 交互式对话

进入终端聊天界面，即可调用全部内置技能、本地命令、联网搜索：

bash

hermes
hermes

步骤 4（可选）：多聊天平台网关接入

若需跨平台消息收发：

bash

# 网关配置向导
hermes gateway setup

# 启动消息网关后台
hermes gateway

# 设置开机自启系统服务
hermes gateway install
# 网关配置向导
hermes gateway setup

# 启动消息网关后台
hermes gateway

# 设置开机自启系统服务
hermes gateway install
  • 按需绑定：Telegram/Discord/Slack 等，实现全平台消息收发。

步骤 5：版本更新（获取新功能）

一键拉取最新代码与依赖升级：

bash

hermes update
hermes update
  • 补充：安装时可在 setup 中选择 Docker 隔离部署或 SSH 远程服务器执行，自带安全容器加固配置。

六、高频避坑清单（安装 + 配置 + 使用全阶段踩坑总结）

（一）安装阶段坑

  1. Windows 原生安装报错：官方 Windows 为实验版，必须 WSL2 环境安装。直接在 CMD/PowerShell 安装大概率异常。
  2. 旧环境变量冲突：本机曾装 OpenClaw、AutoGPT 并配置OPENAI_API_KEY，Hermes 会自动继承旧密钥导致配置错乱。
  3. bash
# 彻底清理旧配置
rm -rf ~/.hermes ~/.config/hermes ~/.cache/hermes

# 删除环境变量
nano ~/.bashrc # 删掉 OPENAI 相关环境变量
# 彻底清理旧配置
rm -rf ~/.hermes ~/.config/hermes ~/.cache/hermes

# 删除环境变量
nano ~/.bashrc # 删掉 OPENAI 相关环境变量
  • 稳妥方案：新建独立 Linux 用户运行 Hermes，环境完全隔离。
  1. 国内网络安装失败：GitHub 脚本拉取超时，需切换代理或替换国内镜像源执行安装命令。

（二）模型配置报错坑

  1. API Key 明明配置却提示空密钥：hermes setup配置仅保存到项目.env，未写入系统环境变量，新开终端环境变量失效。
  2. bash
# 直接命令行写入密钥（永久生效）
hermes config set openrouter_api_key "sk-or-xxx"

# 查看全量配置
hermes config list
# 直接命令行写入密钥（永久生效）
hermes config set openrouter_api_key "sk-or-xxx"

# 查看全量配置
hermes config list
  1. 混用多厂商密钥格式：OpenAI、DeepSeek、OpenRouter 密钥前缀格式不同，粘贴错误直接鉴权失败。需核对对应厂商密钥规范。

（三）日常使用逻辑坑

  1. 自动生成无用技能，干扰后续任务：偶然一次性操作被自动固化为永久技能，导致后续强制套用错误格式。
  2. bash
# 查看全部技能
hermes skills list

# 删除无效技能
hermes skills delete 技能 ID
# 查看全部技能
hermes skills list

# 删除无效技能
hermes skills delete 技能 ID
  • 建议：连续 3 次相同工作流才允许生成技能，生成后手动检查技能文档。
  1. 长对话上下文混乱：单会话混合多类不相关任务，记忆错乱。
  • 优化：使用 /new 新开空白会话，重置上下文。
  1. 多任务并发文件冲突：多子 Agent 同时读写同一个本地文件，出现数据错乱。
  • 优化：涉及本地文件修改的任务串行执行，避免并行操作同目录文件。
  1. 文件路径识别错误：智能体自动猜测路径出错，操作错误文件。
  • 规范：指令中必须填写完整绝对路径，禁止“那个配置文件”等模糊描述。

（四）网关&定时任务坑

  1. Gateway 后台频繁卡死：升级到最新版 hermes update，不要同时绑定 5 个以上聊天平台。
  2. Cron 定时任务不触发：网关未设置系统自启服务，服务器重启后需要手动 hermes gateway 重启。

（五）付费防骗坑

  1. 拒绝非官方付费：任何非官方站点付费托管、代部署年费服务均为诈骗。
  2. 警惕低价陷阱：不要轻信“一键云端 Hermes 年费 99 元”，全部为第三方山寨服务。

七、补充实用小技巧

  1. 优化身份理解：在 ~/.hermes/USER.md 写入个人身份、工作领域，优化智能体理解精准度。
  2. 快速终止进程：任务跑偏时按 Ctrl+C 立刻终止进程，重新下发指令。
  3. 全隐私零 API 开销：搭配 Ollama+vLLM 本地大模型，全程离线运行 Hermes。


评论

暂无评论