Hermes Agent 小白使用手册
☤ Hermes Agent 小白使用手册（超详细版）
适合完全零基础的用户，手把手教你从安装到精通
来源：https://hermes-agent.nousresearch.com/docs
📖 目录
- 一、Hermes Agent 到底是什么？
- 二、准备工作
- 三、安装（60 秒搞定）
- 四、第一次启动——设置模型提供者
- 五、核心操作：开始聊天
- 六、TUI 界面详解
- 七、配置消息网关——在 Telegram/Discord 上用
- 八、技能系统——让 AI 学会你的工作流
- 九、记忆系统——AI 永远不会忘记你
- 十、定时任务（Cron）——让 AI 自动干活
- 十一、全部 CLI 命令速查
- 十二、常见问题与故障排除
- 十三、实用场景示例
一、Hermes Agent 到底是什么？
Hermes Agent 是一个会自我学习的 AI 助手。
与普通 AI 不同，它有三个"超能力"：
- 🧠 会记住你——跨对话记住你的偏好和习惯
- 📚 会自己学——用多了会自动创建"技能"，越用越聪明
- 🔧 会干活——能运行代码、搜索网页、管理文件、定时任务
适合谁用？
- 想在终端里有个超级 AI 助手的开发者
- 想在 Telegram/Discord 上跟 AI 聊天的所有人
- 想让 AI 自动执行重复工作的人
一句话总结：ChatGPT 能做的它都能做，但比 ChatGPT 更个性化、更能干活。
二、准备工作
你需要什么？
| 物品 | 说明 |
|------|------|
| 一台电脑 | Mac、Linux、Windows 都行 |
| 网络 | 能访问 GitHub 和 AI API |
| API 密钥 | 从 AI 模型提供商获取 |
支持的 AI 模型提供商
国内可用：
- DeepSeek https://platform.deepseek.com （便宜又快，推荐入门）
- Kimi / Moonshot https://platform.moonshot.cn
- GLM (z.ai) https://z.ai
国外可用（需科学上网）：
- OpenAI https://platform.openai.com
- Anthropic https://console.anthropic.com
- OpenRouter https://openrouter.ai（聚合 200+ 模型）
三、安装（60 秒搞定）
Linux / macOS 用户
打开终端（Terminal），粘贴下面一行，回车：
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
Windows 用户
推荐方式：先安装 WSL2，然后在 WSL2 里运行上面那条 Linux 命令。
Windows 原生方式（早期测试版）：在 PowerShell 中运行：
iex (irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1)
安装完成后
# 重新加载 shell（让 hermes 命令可用）
source ~/.bashrc # 或 source ~/.zshrc
# 验证安装
hermes --version
你会看到类似 hermes 0.x.x 的输出，说明安装成功！🎉
安装了什么？
安装程序会自动装好这些：
- ✅
uv（Python 包管理器） - ✅ Python 3.11
- ✅ Node.js
- ✅
ripgrep（文件搜索工具） - ✅
ffmpeg（音视频工具） - ✅ Hermes Agent 本体
四、第一次启动——设置模型提供者
第 1 步：选择模型
hermes model
屏幕上会出现一个列表让你选择提供者和模型。用方向键选择，回车确认。
如果你是国内用户，建议选：
deepseek/deepseek-chat（最便宜，¥1/百万 token）- 或
kimi/moonshot-v1
第一次不知道选什么？直接选第一个，后面可以随时改。
第 2 步：输入 API 密钥
选择模型后，会让你输入 API Key。粘贴进去（不会显示，是正常的安全机制），回车。
第 3 步：验证配置
hermes
如果出现对话界面并且 AI 回复了你，就说明配置成功了！🎉
五、核心操作：开始聊天
最简方式
# 直接启动对话
hermes
然后就可以像 ChatGPT 一样跟它聊天了。
一次性提问
hermes --message "Linux 怎么查看磁盘使用情况？"
修改模型
hermes model
# 重新选择模型
常用对话命令
在聊天界面里输入这些斜杠命令：
| 命令 | 功能 | 示例 |
|------|------|------|
| /new | 开始新对话 | /new |
| /model gpt-4o | 切换模型 | /model gpt-4o |
| /retry | 让 AI 重新回答 | /retry |
| /undo | 撤销上一条消息 | /undo |
| /compress | 压缩长对话省 token | /compress |
| /usage | 查看用了多少 token | /usage |
| /stop | 中断 AI 正在做的事 | /stop |
| Ctrl+C | 中断当前操作 | Ctrl+C |
| Ctrl+L | 清屏 | Ctrl+L |
六、TUI 界面详解
运行 hermes 后，你会看到一个漂亮的终端界面：
┌─────────────────────────────────────────────────┐
│ Hermes Agent ☤ [deepseek/deepseek-chat] │
├─────────────────────────────────────────────────┤
│ │
│ 用户: 帮我写一个 Python 脚本 │
│ ─────────────────────────────────────────────── │
│ 小沐: 好的，我来写这个脚本... │
│ │
│ ┌─ 正在运行: python script.py ────────────────┐ │
│ │ Output: Done! │ │
│ └─────────────────────────────────────────────┘ │
│ │
├─────────────────────────────────────────────────┤
│ > 输入你的消息... [Ctrl+E] │
└─────────────────────────────────────────────────┘
状态栏：顶部显示当前模型、会话信息
对话区：中间是你和 AI 的对话
工具区：当 AI 在运行命令时会显示输出
输入区：底部是输入框，可以多行输入
快捷键
| 快捷键 | 功能 |
|--------|------|
| Tab | 自动补全命令 |
| ↑ / ↓ | 浏览历史输入 |
| Ctrl+E | 打开编辑器（多行输入） |
| Ctrl+C | 中断 AI |
| Ctrl+D | 退出 |
七、配置消息网关——在 Telegram/Discord 上用
设置 Gateway
# 运行设置向导
hermes gateway setup
这个向导会一步步帮你配置消息平台。
连接 Telegram
步骤 1：创建 Bot
- 打开 Telegram，找
@BotFather - 发
/newbot，按提示设置名字 - 拿到 Token（类似
123456:ABC-DEF1234ghIkl）
步骤 2：配置
hermes config set gateway.telegram.bot_token "你的Token"
hermes config set gateway.telegram.enabled true
步骤 3：启动
hermes gateway start
现在在 Telegram 上给你的 Bot 发消息，它就会回复你！
连接 Discord
hermes config set gateway.discord.bot_token "你的Token"
hermes config set gateway.discord.enabled true
hermes gateway start
Gateway 管理命令
hermes gateway status # 查看状态
hermes gateway start # 启动
hermes gateway stop # 停止
hermes gateway setup # 重新配置
八、技能系统——让 AI 学会你的工作流
技能是什么？
技能就是一段"使用说明书"，告诉 AI 怎么做某件事。比如：
- 代码审查技能：告诉 AI 按你的标准审查代码
- 翻译技能：告诉 AI 如何专业地翻译
- 部署技能：告诉 AI 部署流程的每一步
查看已有技能
# 列出所有技能
hermes skills list
# 查看某个技能的详情
hermes skills view <技能名>
在对话中使用技能
# 直接输入技能名（带 / 前缀）
/代码审查
# 或者发消息时提到
"帮我做个代码审查"
如果你有 代码审查 这个技能，AI 就会按照技能里的要求执行。
Hermes 会自动创建技能
这是 Hermes 最酷的功能之一——完成复杂任务后，它会问你是否要把这个过程保存为技能。比如你教它怎么做部署，下次它就会自己记住。
Skills Hub（官方技能市场）
https://agentskills.io — 在这里可以找别人分享的技能。
九、记忆系统——AI 永远不会忘记你
这是 Hermes 的另一个超能力
普通 AI 每次聊天都是"失忆"的。Hermes 会记住：
- ✅ 你的名字和偏好（"叫我小张"）
- ✅ 你的习惯（"我习惯用 Python 写脚本"）
- ✅ 你的项目信息（"我的项目在 ~/work/project"）
- ✅ 之前聊过的话题
记忆会自动管理
你不需要手动做什么。Hermes 会在对话中自动：
- 发现有用的信息 → 保存到记忆
- 过时的记忆 → 自动更新
- 跨对话回忆 → 自动搜索之前聊过的内容
搜索历史对话
Hermes 内置了强大的搜索功能，能查找之前的聊天记录：
# 在对话中直接问
"我之前问过关于 Docker 的问题吗？"
十、定时任务（Cron）——让 AI 自动干活
创建定时任务
# 每天早上 9 点给你发每日摘要
hermes cron create \
--name "daily-summary" \
--schedule "0 9 * * *" \
--prompt "查看今天的日程和待办事项，生成简洁的摘要" \
--deliver telegram
定时任务管理
hermes cron list # 列出所有任务
hermes cron pause <id> # 暂停某个任务
hermes cron resume <id> # 恢复
hermes cron remove <id> # 删除
hermes cron run <id> # 立即运行一次
定时任务可以做哪些事？
- 每日新闻摘要
- 每周项目报告
- 监控服务器状态
- 定时备份
- 提醒你喝水 😄
十一、全部 CLI 命令速查
基础命令
| 命令 | 说明 |
|------|------|
| hermes | 启动对话 |
| hermes --message "你好" | 发一条消息就退出 |
| hermes model | 选择 AI 模型 |
| hermes setup | 完整设置向导 |
配置与诊断
| 命令 | 说明 |
|------|------|
| hermes config set <key> <value> | 设置配置 |
| hermes config get <key> | 查看配置 |
| hermes doctor | 全面体检，诊断问题 |
| hermes tools | 管理工具集 |
消息网关
| 命令 | 说明 |
|------|------|
| hermes gateway start | 启动网关 |
| hermes gateway stop | 停止网关 |
| hermes gateway status | 查看网关状态 |
| hermes gateway setup | 配置网关 |
技能与记忆
| 命令 | 说明 |
|------|------|
| hermes skills list | 列出技能 |
| hermes skills view <name> | 查看技能详情 |
| hermes sessions list | 查看所有会话 |
| hermes sessions show --last | 查看最近会话 |
更新与迁移
| 命令 | 说明 |
|------|------|
| hermes update | 更新到最新版 |
| hermes claw migrate | 从 OpenClaw 迁移过来 |
Cron 定时任务
| 命令 | 说明 |
|------|------|
| hermes cron create | 创建定时任务 |
| hermes cron list | 列出所有任务 |
| hermes cron pause <id> | 暂停 |
| hermes cron remove <id> | 删除 |
十二、常见问题与故障排除
Q：hermes: command not found
# 重新加载 shell 配置
source ~/.bashrc
# 或
source ~/.zshrc
Q：安装脚本卡住不动了
国内用户：
# 用 GitHub 代理
curl -fsSL https://ghproxy.com/https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
Q：AI 不回复 / 超时
# 检查模型配置
hermes model
# 换一个模型试试
hermes config set agent.model "deepseek/deepseek-chat"
Q：怎么换模型？
# 方法 1：交互式选择
hermes model
# 方法 2：直接设置
hermes config set agent.model "openai/gpt-4o"
Q：如何退出聊天？
在对话界面中按 Ctrl+D 或输入 /exit。
Q：安装在哪里了？
| 系统 | 路径 |
|------|------|
| Linux/macOS | ~/.hermes/ |
| Windows | %LOCALAPPDATA%\hermes\ |
| 配置文件 | ~/.hermes/config.yaml |
| 技能目录 | ~/.hermes/skills/ |
| 记忆文件 | ~/.hermes/memory/ |
| 会话数据 | SQLite 数据库 |
Q：怎么卸载？
# 先卸载 pip 包
pip uninstall hermes-agent
# 删除配置目录
rm -rf ~/.hermes
# Windows
# rmdir /s %LOCALAPPDATA%\hermes
Q：费用怎么算？
Hermes 本身是完全免费的开源软件。你只需要支付：
- API 调用费（给 AI 模型提供商）
- 服务器费（如果你部署在云上）
DeepSeek 一个月几块钱就够日常使用了。
十三、实用场景示例
场景 1：个人学习助手
# 安装
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
# 设置模型（用便宜的 DeepSeek）
hermes config set agent.model "deepseek/deepseek-chat"
# 开始对话
hermes
然后你可以问它任何学习问题，它会帮你写代码、解释概念、查资料。
场景 2：代码审查机器人（Discord 版）
# 配置模型和 Discord
hermes config set agent.model "anthropic/claude-sonnet-4"
hermes config set gateway.discord.bot_token "你的Token"
hermes config set gateway.discord.enabled true
# 启动
hermes gateway start
把代码贴在 Discord 频道里 @机器人，它就会帮你审查。
场景 3：每日早报自动推送
hermes cron create \
--name "morning-briefing" \
--schedule "0 8 * * 1-5" \
--prompt "搜索今天的科技新闻，整理成 5 条要点发送" \
--deliver telegram
每个工作日早上 8 点，自动给你推送科技早报。
场景 4：项目文档助手
cd ~/my-project
# 启动对话（自动加载项目上下文）
hermes
AI 会自动读取项目里的文件，了解你的项目结构后回答问题。
还想了解更多？
- 📘 官方文档：https://hermes-agent.nousresearch.com/docs
- 📚 技能 Hub：https://agentskills.io
- 💬 Discord 社区：https://discord.gg/NousResearch
- 🐱 GitHub：https://github.com/NousResearch/hermes-agent
本手册由简川工作室基于 Hermes Agent 官方文档整理，适合零基础用户阅读。
最后更新：2026-05-23