Hermes Agent 新手入门指南

目录

• 1. Hermes Agent 是什么？
• 2. 系统要求与安装
• 3. 快速配置与启动
• 4. 基础使用教程
• 5. 常用命令速查表
• 6. 常见问题与解决方法

1. Hermes Agent 是什么？

1.1 基本概念

Hermes Agent 是由 Nous Research 开发的开源"自进化"AI 智能体。它不仅仅是一个聊天机器人，更像是一个住在你服务器里的数字员工：

• 持久记忆：跨会话保存你的偏好、项目上下文，重启不丢失
• 技能系统：完成任务后自动总结经验，生成可复用的技能，越用越顺手
• 多平台接入：一个网关同时接入 Telegram、微信、飞书、Discord 等，随时随地调用
• 灵活部署：支持本地、Docker、云端服务器等多种方式

1.2 与普通AI助手的区别

特性	普通AI助手	Hermes Agent
记忆能力	会话级记忆，重启丢失	跨会话持久记忆，永久保存
学习能力	固定能力，无法自我提升	自动创建技能，越用越聪明
使用方式	网页/APP界面	CLI、飞书、微信等多平台
部署方式	云端服务	本地部署，完全控制
隐私安全	数据过第三方服务器	数据不离开你的服务器

2. 系统要求与安装

2.1 系统要求

• 操作系统：Linux、macOS 或 Windows (需安装 WSL2)
• 硬件要求：最低 1核1GB 内存，推荐 4GB+ 内存
• 网络要求：能够访问 GitHub 和模型API

2.2 一键安装（推荐）

打开终端，执行以下命令：

# 国际版安装命令
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

# 国内用户如果下载慢，可以使用加速镜像
curl -fsSL https://res1.hermesagent.org.cn/install.sh | bash

安装完成后，让命令生效：

# 对于 bash 用户
source ~/.bashrc

# 对于 zsh 用户
source ~/.zshrc

2.3 验证安装

# 检查版本
hermes version

# 运行诊断
hermes doctor

# 启动 Hermes
hermes

3. 快速配置与启动

3.1 初始配置向导

运行初始化向导：

hermes setup

向导会引导你完成以下配置：

1. 选择模型提供商：Nous Portal、OpenAI、Anthropic、OpenRouter 等
2. 输入 API Key：安全写入 ~/.hermes/.env
3. 选择终端后端：本地、Docker、SSH
4. 配置记忆功能：建议开启
5. 选择语言偏好：中文或英文

3.2 API Key 配置

.env 文件示例：

# OpenRouter（推荐，可访问 200+ 模型）
OPENROUTER_API_KEY=sk-or-xxxxxxxxxxxx

# OpenAI
OPENAI_API_KEY=sk-xxxxxxxxxxxx

# Anthropic
ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxx

# 智谱AI
ZAI_API_KEY=your_zai_api_key

# Kimi
KIMI_API_KEY=your_kimi_api_key

3.3 快速启动方式

# 交互式对话（最常用）
hermes

# 单次问答
hermes chat -q "你好，请介绍一下你自己"

# 使用管道输入
echo "解释这段代码" | hermes chat

4. 基础使用教程

4.1 CLI 交互基础

进入交互模式后，你会看到一个功能完备的终端界面：

常用快捷键：

• Alt+Enter 或 Ctrl+J：在输入框中换行
• /：弹出命令菜单，支持自动补全
• Ctrl+C：中断当前任务

第一次使用建议：

# 启动 Hermes
hermes

# 查看帮助
/help

# 查看可用工具
/tools

# 查看当前模型
/model

# 查看使用统计
/usage

4.2 第一个任务

给 Hermes 一个有明确动作的任务，而不是简单的"你好"：

# 启动后输入
阅读当前目录结构并总结核心组成。

4.3 会话管理

# 命名当前会话（便于恢复）
/title 我的第一个项目

# 创建新会话
/new

# 恢复指定会话
/resume 我的第一个项目

# 查看会话历史
hermes sessions list

4.4 文件操作

Hermes 可以帮你读写文件：

# 让 Hermes 创建文件
创建一个名为 hello.py 的 Python 文件，内容为打印"Hello Hermes"。

# 让 Hermes 分析现有文件
分析当前目录下的 main.py 文件，找出潜在问题。

5. 常用命令速查表

5.1 CLI 通用命令

命令	说明
hermes	启动交互式对话
hermes chat -q "问题"	单次问答
hermes model	切换或配置模型
hermes doctor	诊断环境问题
hermes status	查看运行状态
hermes version	查看版本信息

5.2 交互模式命令

命令	说明
/help	查看所有可用命令
/new	开启新会话
/title [名称]	命名当前会话
/resume [名称]	恢复指定会话
/model	切换模型
/usage	查看 Token 用量
/tools	列出可用工具
/skills	管理技能
/compress	压缩会话上下文

5.3 工具集控制

# 启用指定工具集
hermes --toolsets web,terminal,browser

# 禁用所有工具（纯对话模式）
hermes --toolsets none

# 查看所有可用工具集
hermes toolsets list

5.4 常用工具集说明

工具集	功能
file	文件读写操作
terminal	执行系统命令
web	网页搜索和内容提取
browser	浏览器自动化
skills	技能管理
memory	记忆系统

6. 常见问题与解决方法

6.1 安装问题

问题：命令找不到 hermes

# 解决方案
source ~/.bashrc  # 或 source ~/.zshrc
# 如果还是找不到，重新安装

问题：网络连接失败

# 使用国内镜像
curl -fsSL https://res1.hermesagent.org.cn/install.sh | bash

6.2 配置问题

问题：API Key 配置错误

# 检查配置
hermes doctor

# 重新配置
hermes setup

问题：模型无法连接

# 切换模型
hermes model

# 或指定模型启动
hermes --model openai/gpt-4o

6.3 使用问题

问题：工具调用失败

# 检查工具状态
/tools

# 启用必要工具集
hermes --toolsets file,terminal

问题：上下文太长

# 压缩上下文
/compress

# 查看使用情况
/usage

6.4 性能优化建议

1. 选择合适的模型：日常对话使用轻量模型，复杂任务使用强大模型
2. 定期压缩会话：长会话使用 /compress 减少 token 消耗
3. 合理命名会话：使用 /title 便于后续恢复
4. 善用技能系统：重复任务让 Hermes 自动学习为技能

7. 下一步学习建议

7.1 进阶技能

1. 学习技能创建：让 Hermes 记住常用工作流程
2. 配置消息网关：接入飞书、微信等平台
3. 探索高级工具：使用浏览器自动化、数据可视化等

7.2 推荐练习

1. 让 Hermes 帮你整理文档
2. 创建自动化脚本执行日常任务
3. 配置定时任务自动生成报告

7.3 获取帮助

• 官方文档：https://hermes.xaapi.ai/
• GitHub 仓库：https://github.com/NousResearch/hermes-agent
• 社区讨论：查看官方仓库的 Issues 和 Discussions

---

附录：快速开始检查清单

• 安装完成（hermes version 能显示版本）
• 配置向导完成（hermes setup 已运行）
• API Key 正确配置（hermes doctor 无错误）
• 能正常启动交互模式（hermes 能进入对话）
• 能执行简单任务（如文件操作、命令执行）

恭喜！你已经完成了 Hermes Agent 的基础学习。现在可以尝试让它帮你完成一些实际任务，逐步熟悉这个强大的 AI 助手。