一、核心基础信息

与传统AI工具的核心差异

1. 完成复杂任务后，自动提取解决方案生成可复用的技能文档

2. 跨会话永久存储你的偏好、项目背景与历史经验

3. 技能在后续使用中持续自我迭代优化

4. 不依赖你的本地设备，可7×24小时在云端独立运行

二、核心架构与核心能力

2.1 核心架构拆解

1. 终端运行层：支持6种终端后端，覆盖从个人笔记本到企业级集群的全场景部署，包括本地、Docker、SSH远程服务器、Daytona（无服务器开发环境）、Singularity（HPC超算集群）、Modal（GPU无服务器云计算），其中Daytona和Modal支持空闲时休眠、需求时唤醒，闲置成本几乎为零。

2. 全平台消息网关层：单进程即可同时接入多个消息平台，支持CLI终端、Telegram、Discord、Slack、WhatsApp、Signal、飞书、企业微信等，跨平台对话上下文完全同步，手机、电脑无缝切换。

3. 三层记忆引擎层：这是Hermes Agent 持久化能力的核心，采用「SQLite + FTS5全文检索 + LLM摘要」的技术方案，分为三层：
1. 会话记忆：当前对话的上下文，由LLM实时摘要生成
2. 持久记忆：跨会话的事实、偏好、项目背景，永久存储，支持全文检索
3. 技能记忆：从经验中沉淀的可复用流程，即结构化Skill文档

4. 闭环学习系统层：项目最核心的差异化竞争力，实现自主技能生成与迭代。当完成5步以上工具调用的复杂任务后，Agent会自动提取解决流程，生成符合agentskills.io开放标准的Markdown技能文档，存储后下次同类任务直接调用；使用过程中发现更优方案，还会自动更新优化技能。

5. 工具集层：内置40+开箱即用的工具，按工具集分类管理，无需额外配置即可启用，核心包括：

工具集	核心能力	额外依赖
web	网页搜索、网页内容提取	可选Firecrawl增强
terminal	终端命令执行、进程管理	无
file	文件读写、内容替换、批量搜索	无
browser	浏览器自动化、点击、填表、截图	需Browserbase服务
cron	自然语言定时任务	无
vision	图片内容分析	需视觉大模型
memory	持久记忆管理	无

6. 安全防护层：五层安全防线，从执行前到执行中全流程防护，包括用户授权白名单、危险命令强制审批、容器隔离运行、MCP凭证过滤、上下文注入扫描。

7. 模型适配层：完全模型无关，不绑定任何特定大模型，支持Nous Portal、OpenRouter（200+模型）、OpenAI、Anthropic、Ollama本地模型，以及任意OpenAI兼容的API端点，一条命令即可切换模型，无供应商锁定。

2.2 核心特色能力

1. 自主技能进化：无需人工编写技能，Agent从完成的任务中自主沉淀、迭代技能，理论上能力无上限。

2. 跨会话持久记忆：彻底解决AI「健忘症」，永久记住你的工作习惯、偏好、项目背景，无需每次对话重复交代上下文。

3. 全场景灵活部署：最低可运行在5美元/月的VPS上，也可部署在GPU集群或无服务器平台，不依赖本地设备，关闭电脑也能7×24小时工作。

4. 全平台统一入口：一个网关进程搞定所有通讯平台，在Telegram发起的任务，切到Discord、终端可继续执行，历史完全同步。

5. 自然语言定时自动化：内置cron调度器，用自然语言即可设置定时任务，比如「每天早上9点搜索AI行业新闻，总结后发到我的Telegram」，执行结果可推送到任意平台。

6. 子智能体并行处理：可生成隔离的子智能体，同时并行处理多个工作流，大幅提升复杂任务的处理效率。

7. 研究级能力支持：内置批量轨迹生成、Atropos RL强化学习环境，支持模型训练相关的研究场景。

三、超详细使用教程（从0到1上手）

3.1 前置环境准备

3.2 一键安装（3分钟完成）

1. 打开终端（macOS/Linux）或WSL2终端（Windows），执行以下一键安装命令：

2. 安装脚本会自动完成以下操作，无需人工干预：
1. 安装Python 3.11（通过uv包管理工具）
2. 安装Node.js v22
3. 安装ripgrep、ffmpeg等系统依赖
4. 安装Hermes Agent 所有Python依赖
5. 配置hermes全局命令

3. 安装完成后，重载Shell配置，让命令生效：

4. 验证安装是否成功，执行环境诊断命令：
若终端输出全绿色的✓标记，说明安装成功；若有红色报错，根据提示修复环境问题即可。

3.3 基础配置（必做步骤）

步骤1：全量配置向导（新手推荐）

步骤2：模型配置（核心必做）

• OpenRouter（最推荐）：支持200+主流大模型，按量付费，无需多个API Key

• OpenAI：GPT系列模型

• Anthropic：Claude系列模型

• Nous Portal：官方订阅服务，零配置

• Custom Endpoint：自定义OpenAI兼容端点，可接入Ollama本地模型、国内大模型等

步骤3：工具权限配置

3.4 基础使用：CLI终端交互

新手入门示例指令

1. 基础问答：帮我总结一下2026年4月AI行业的3个核心热点新闻

2. 文件操作：在当前目录创建一个test文件夹，里面生成一个README.md文件，写入Hermes Agent 测试项目的说明

3. 技能沉淀触发：帮我分析这个GitHub仓库的核心信息，包括Star数、最近更新时间、核心功能、贡献者活跃度，仓库地址：https://github.com/NousResearch/hermes-agent

4. （完成该复杂任务后，Agent会自动询问是否保存为技能，确认后即可生成可复用的GitHub仓库分析技能）

5. 定时任务：帮我设置一个定时任务，每天晚上8点，检查当前服务器的CPU、内存使用率，生成报告并保存到server_status.log文件中

3.5 进阶配置：全平台消息网关（7×24小时在线）

步骤1：创建Telegram Bot，获取基础信息

1. 打开Telegram，搜索@BotFather，发送/newbot命令，跟着提示创建Bot，获取Bot Token（格式：123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11）

2. 搜索@userinfobot，发送任意消息，获取你的数字User ID（用于白名单配置，防止他人访问你的Agent）

步骤2：配置网关

1. 执行交互式网关配置命令：

2. 在菜单中选择Telegram，粘贴刚才获取的Bot Token，输入你的User ID作为白名单，完成配置。

3. 也可手动编辑配置文件~/.hermes/.env，添加以下内容：

步骤3：启动网关

1. 临时启动网关，测试是否正常：
启动后，打开Telegram，给你创建的Bot发送任意消息，若Agent正常回复，说明配置成功。

2. 生产环境推荐将网关安装为系统服务，实现开机自启、后台常驻运行：
安装完成后，可通过以下命令管理服务：

3.6 安全最佳实践（必做）

1. 开启Docker容器隔离（最重要）

2. 所有终端命令在隔离的Docker容器内执行，即使执行危险命令，也不会影响宿主机，是最核心的安全防线。
开启后，危险命令检查会自动跳过，因为容器本身就是隔离边界，Agent无法伤害宿主机。

3. 严格配置用户白名单

4. 所有消息平台必须配置允许访问的用户白名单，严禁开启GATEWAY_ALLOW_ALL_USERS=true，防止陌生人访问你的Agent。

5. 危险命令审批

6. 未开启Docker隔离时，默认会对16类高危命令触发强制人工审批，包括递归删除、修改系统权限、SQL删库、远程脚本执行等，审批选项包括：
• [o]nce：仅此一次允许执行
• [s]ession：本次会话内都允许
• [a]lways：永久加入白名单
• [d]eny：拒绝执行
非绝对信任的命令，严禁选择always永久加白。

7. 定期环境诊断

8. 遇到问题或定期执行hermes doctor，检查环境配置、权限设置是否存在安全风险。

四、进阶用法与实战案例

4.1 技能系统的深度使用

1. 查看已有的技能

2. 在对话中输入/skills，或直接发送列出我所有的技能，Agent会展示所有已沉淀的技能，包括技能名称、触发关键词、版本号。

3. 手动创建技能

4. 直接用自然语言告诉Agent：帮我创建一个技能，名称是「服务器性能监控」，功能是检查服务器的CPU、内存、磁盘使用率，生成结构化报告，异常时给出告警提示，Agent会自动生成符合标准的技能文档，存入技能库，后续直接触发关键词即可调用。

5. 技能的迭代优化

6. 当你使用某个技能完成任务后，若发现有可优化的点，直接告诉Agent：刚才使用的「服务器性能监控」技能，帮我增加网络带宽监控的功能，优化报告的格式，Agent会自动更新技能文档，完成迭代。

7. 社区技能分享

8. Hermes Agent 兼容agentskills.io开放标准，可从社区下载他人分享的技能，也可将自己的技能分享到社区。

4.2 记忆系统的优化技巧

1. 主动引导记忆

2. 遇到重要的偏好、设置、规则，直接告诉Agent：把这个记住：我写代码默认用Go语言，缩进用4个空格，注释必须用中文，Agent会立即将这条信息写入持久记忆文件，下次会话自动生效。

3. ⚠️ 注意：本次会话写入的记忆，需要下次启动Hermes才会生效，当次对话不会热更新。

4. 记忆管理

5. 执行hermes memory命令，可管理持久记忆，包括查看、编辑、清理记忆内容，避免无效记忆过多导致Token消耗增加。

6. 项目上下文注入

7. 在你的项目目录中创建AGENTS.md或SOUL.md文件，写入项目的背景、规范、要求，在该目录启动Hermes Agent时，会自动注入该文件的内容，让Agent完全适配你的项目需求，无需每次对话重复交代项目背景。

4.3 典型实战案例

案例1：个人7×24小时AI助手

• 部署场景：5美元/月的VPS，配置Telegram网关，开启Docker隔离

• 核心功能：
• 日常问答、信息检索，永久记住你的偏好
• 定时任务：每天早上推送行业新闻、天气提醒，晚上推送当日待办完成情况
• 日程管理：自然语言添加日程，到期自动提醒
• 内容创作：帮你写文案、邮件、报告，记住你的写作风格

• 实现方式：完成基础部署和Telegram网关配置后，直接用自然语言设置对应的功能，Agent会自动沉淀相关技能，越用越贴合你的使用习惯。

案例2：开发者自动化运维助手

• 部署场景：云服务器，SSH后端接入，配置Slack网关，开启Docker隔离

• 核心功能：
• 服务器监控：定时检查服务器状态，异常时自动发送告警到Slack
• 自动备份：定时执行数据库、项目文件备份，同步到对象存储
• 日志分析：自动检索服务日志，定位报错原因，给出解决方案
• 项目部署：自动拉取代码、构建、部署项目，完成上线流程

• 实现方式：开启terminal、file、cron工具集，让Agent完成一次完整的部署流程，自动沉淀项目部署技能，后续可直接调用完成自动化部署。

案例3：行业研究与数据分析助手

• 部署场景：本地macOS + Modal无服务器GPU后端，配置Discord网关

• 核心功能：
• 行业信息跟踪：定时检索目标行业的新闻、研报、政策，生成周度/月度分析报告
• 数据抓取与分析：自动抓取目标网站的数据，清洗、分析后生成可视化图表
• 竞品跟踪：定时监控竞品的产品更新、市场动作，生成跟踪报告

• 实现方式：开启web、file、cron、code execution工具集，完成一次完整的行业分析后，自动沉淀对应的技能，后续可自动定时执行。

五、常见问题与踩坑指南

六、适用场景与选型建议

6.1 最适合的使用场景

1. 个人长期AI助手：核心优势场景，越用越懂你，7×24小时在线，无需每次重复交代上下文，替代传统无状态的对话AI。

2. 开发者自动化运维：定时监控、自动部署、日志分析、故障处理，沉淀运维技能，大幅降低重复性工作负担。

3. 跨平台消息与工作中枢：同时接入多个工作沟通平台，统一处理消息、任务、提醒，无需在多个软件之间来回切换。

4. AI研究与模型训练：内置RL强化学习环境、轨迹生成与导出功能，适合Agent相关的研究场景。

5. 中小企业轻量自动化：可低成本部署在VPS上，实现客服自动化、运营数据统计、定时报表推送等功能，MIT协议可免费商用。

6.2 不适合的场景

1. 只想简单用AI对话，不想做任何配置的用户，直接使用ChatGPT、Claude网页版更合适。

2. 需要深度本地系统集成、大量本地文件操作的场景，OpenClaw的适配性更好。

3. 对一键回滚、撤销有强需求的场景，Hermes Agent 无内置快照回滚机制，需配合Docker隔离使用。

七、总结