Hermes Agent 新手完整使用指南（2026 最新）

Hermes Agent 是 Nous Research 开发的开源自进化 AI 智能体，能自主学习、生成技能、跨平台交互，支持本地 / 云端部署，新手可在 1 分钟内完成安装与配置。以下从安装、配置、基础使用、进阶功能、常见问题全流程讲解。

官方文档：https://hermes-agent.nousresearch.com/docs/

GitHub：https://github.com/NousResearch/hermes-agent

一、安装前准备

1. 系统要求

• 操作系统：Linux（Ubuntu 推荐）、macOS、Windows WSL2、Android Termux
• Python：3.10+（脚本自动安装）
• 内存：≥4GB（本地模型需≥16GB）
• 网络：可访问 GitHub、LLM API（OpenAI/OpenRouter 等）
• 前置依赖：仅需 Git（sudo apt install git 或 brew install git）

2. 安装方式（3 种，新手选一键安装）

方式 1：一键安装（推荐，60 秒完成）

bash 运行

# 执行安装脚本
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

# 刷新Shell环境（二选一）
source ~/.bashrc # Bash用户
source ~/.zshrc # Zsh/macOS用户

方式 2：手动安装（网络受限 / 需自定义）

bash

运行

git clone –recurse-submodules https://github.com/NousResearch/hermes-agent.git
cd hermes-agent
uv venv .venv –python 3.11
source .venv/bin/activate
pip install -e .
mkdir -p ~/.hermes/{skills,memory,personas,logs}

方式 3：Docker 部署（服务器 / 生产环境）

bash

# 拉取镜像
docker pull nousresearch/hermes-agent:latest

# 首次配置
docker run -it –rm -v ~/.hermes:/root/.hermes nousresearch/hermes-agent:latest hermes setup

# 启动
docker run -d –name hermes -v ~/.hermes:/root/.hermes nousresearch/hermes-agent:latest

3. 验证安装

bash

hermes –version # 查看版本
hermes doctor # 环境诊断（全绿=成功）

---

二、核心配置（新手必做）

1. 全量配置向导（一键完成）

bash

hermes setup # 启动交互式向导

按提示完成：

• 模型提供商选择（OpenRouter/OpenAI/Ollama/Anthropic 等）
• API Key 输入
• 默认模型选择
• 工具权限、** 网关（Telegram / 飞书）** 配置

2. 单独配置（按需调整）

（1）模型配置（核心）

bash

hermes model # 切换模型/提供商

推荐提供商：

• OpenRouter：200 + 模型，按量付费，无需多 Key（新手首选）
• OpenAI：GPT-3.5/4o，稳定但贵
• Ollama：本地模型（Llama3/Qwen），免费但需硬件
• Nous Portal：官方订阅，零配置

（2）工具管理（47 + 工具）

bash

hermes tools # 启用/禁用工具

新手必开工具：

• web：网页搜索 / 抓取
• terminal：执行系统命令
• file：文件读写 / 管理
• memory：持久记忆
• skills：技能创建
• cron：定时任务

（3）环境变量配置（手动）

bash

# 编辑.env文件
vim ~/.hermes/.env

# 填入API Key
OPENROUTER_API_KEY=sk-or-v1-xxx
OPENAI_API_KEY=sk-xxx

---

三、基础使用（CLI 交互）

1. 启动与退出

bash

hermes # 启动交互式CLI
hermes -c # 恢复上一次会话（–continue）
/exit # 正常退出（保存会话）
Ctrl+C # 强制中断（自动保存）

2. 核心斜杠命令（对话中直接输入）

表格

命令	功能
/help	查看所有命令
/new	新建会话（清空上下文）
/model	临时切换模型
/tools	查看启用工具
/skills	管理技能
/memory	查看记忆
/config	修改配置

3. 新手入门对话示例

plaintext

# 示例1：基础任务
你：帮我搜索2026 AI Agent趋势并总结
Hermes：自动调用web工具→搜索→分析→输出报告

# 示例2：系统操作
你：查看磁盘使用率，显示前5大目录
Hermes：调用terminal→执行命令→返回结果

# 示例3：创建技能
你：创建”每日AI新闻总结”技能，每天9点发Telegram
Hermes：生成技能→配置cron→关联网关

4. 多行输入

• Alt+Enter 或 Ctrl+J：换行
• 支持代码块、长文本编辑

---

四、进阶功能（新手进阶）

1. 技能系统（核心特色）

• 自动生成：执行复杂任务后自动创建技能
• 手动安装：bash运行hermes skills search ai-news # 搜索技能 hermes skills install openai/skills/ai-news # 安装
• 技能管理：/skills list//skills delete

2. 跨平台网关（Telegram / 飞书 / 钉钉）

bash

# 配置网关
hermes gateway setup
# 启动网关
hermes gateway start

支持平台：Telegram、Discord、飞书、钉钉、企业微信、Slack 等 15+

3. 定时任务（Cron）

plaintext

你：每天早上9点，总结Hacker News AI内容发我Telegram
Hermes：自动配置cron→定时执行→推送消息

4. 记忆系统（跨会话持久）hermes-agent.nousresearch.com

• 记住偏好、项目上下文、历史对话
• /memory clear：清空记忆
• /memory export：导出记忆

---

五、常见问题与排障

1. 安装失败

• 网络问题：换镜像 / 代理，或手动安装
• 权限不足：加sudo，或检查~/.hermes权限
• 依赖冲突：用虚拟环境，或uv pip sync

2. 模型调用失败

• 检查API Key是否正确
• 确认模型权限（如 GPT-4o 需开通）
• 用hermes doctor诊断网络 / 配置

3. 工具无法使用

• 用hermes tools确认工具已启用
• 检查API Key（如 web 需 FireCrawl Key）
• 终端工具：hermes config set terminal.backend docker（安全模式）

4. 升级与更新

bash

hermes update # 一键升级

六、新手最佳实践

1. 先基础后进阶：先用 CLI 熟悉交互，再开网关 / 技能
2. 模型选择：新手先用OpenRouter+GPT-3.5（性价比高）
3. 工具精简：只开必要工具，减少 Token 消耗
4. 安全第一：终端工具用 Docker 后端，避免本地风险
5. 定期备份：备份~/.hermes目录（记忆 / 技能 / 配置）

官方文档：https://hermes-agent.nousresearch.com/docs/

GitHub：https://github.com/NousResearch/hermes-agent