Hermes Agent 基础使用完全指南:对话模式、常用命令与斜杠命令速查手册
Hermes Agent 基础使用完全指南:对话模式、常用命令与斜杠命令速查手册
Hermes Agent 基础使用的核心就是三件事:交互式对话模式、命令行常用命令、对话中的斜杠命令。这份速查手册把三者一次讲透——从第一次 hermes 对话、多轮上下文管理,到随时切换模型、管理记忆、压缩上下文,帮你把最常用的命令变成肌肉记忆。刚完成安装的 Hermes Agent 用户,照做一遍大约 30 分钟即可上手日常操作。
一、30 秒上手:启动 Hermes Agent 对话模式
完成安装(可参考 05-安装部署全攻略.md)后,在终端输入一行命令即可进入对话模式:
hermes
首次运行会触发 Quick Setup 向导,就像新手机的「开机设置」,引导你完成 4 项核心配置:
| 配置项 | 说明 | 新手建议 |
|---|---|---|
| 界面语言 | CLI 菜单与提示的语言 | 中文(简体) |
| LLM 提供商 | 决定 Agent 的「大脑」 | DeepSeek(性价比最高)或 OpenRouter(有免费额度) |
| API Key | 对应平台的密钥 | 提前注册好,向导会做连接测试 |
| 默认模型 | 日常主力模型 | 先选通用对话模型(如 deepseek-chat) |
💡 向导随时可以重跑:
hermes setup。换了 API Key 或想换默认模型,用hermes setup --models-only只重配模型即可。
配置完成后的验证三件套:
hermes --version # 版本检查
hermes doctor # 系统诊断,检查项全绿即正常
hermes # 开始第一次对话
第一次对话,先问一句「你好,请简单介绍一下你自己」。如果 Hermes 正常回复,说明部署完全成功,可以进入日常使用了。
二、Hermes Agent 对话模式的 4 个核心技巧
技巧 1:多轮对话自动维护上下文
Hermes 会自动记住当前会话的上下文,你可以像和朋友聊天一样连续追问:
You: 我正在做一个 Python 项目,需要处理 CSV 文件
Hermes: 好的,可以使用……
You: 数据量比较大,有 100 万行,哪种方式最快?
Hermes: 对于百万行级别的数据集,推荐……
第二轮无需再重复「Python」和「CSV」,Hermes 已经记住了。切到全新话题时,输入 /clear 清除上下文;发现回答有偏时,直接指出错误让它修正即可,不必从头开始。
技巧 2:工具调用——Hermes 能真正「动手」
这是 Hermes Agent 与普通聊天机器人的本质区别:它会自动调用工具完成实际任务,比如读取本地文件、搜索网页、执行 Python 代码、运行 shell 命令。
You: 帮我读取 ~/.hermes/config.yaml 的内容
Hermes: [工具调用: file_read] → 输出配置内容
You: 帮我计算 1 到 100 的平方和
Hermes: [工具调用: execute_python] → 338350
⚠️ 涉及执行命令、删除文件等操作前,Hermes 会先展示即将执行的命令并请求确认。这一步请务必认真看——用户确认是防止误操作的最后一道防线。
技巧 3:高效提问公式
好的提问 = 明确的任务 + 足够的上下文 + 期望的输出格式。
| ❌ 低效提问 | ✅ 高效提问 |
|---|---|
| 帮我看看这个 | 帮我审查这段 Python 代码的安全性,特别关注 SQL 注入和 XSS 漏洞 |
| 为什么报错? | 运行 python main.py 报 TypeError: expected str, got int,函数代码如下…… |
| 总结一下 | 用 bullet points 总结核心观点,每条不超过 20 字,标注重要性(高/中/低) |
技巧 4:对话历史随时可查可导出
所有对话自动保存在 ~/.hermes/database/hermes.db(SQLite),随时可以检索:
hermes chat list # 列出最近的会话
hermes chat search "Python CSV" # 搜索历史对话内容
hermes chat export <session_id> --format md --output ~/chat-history.md
退出时输入 exit,会话自动保存并返回会话 ID;下次 hermes 直接启动即可恢复上次会话,或用 hermes chat resume <session_id> 精确恢复。
三、Hermes Agent 常用命令速查表
掌握下面这张表,日常 90% 的操作都够用了:
| 命令 | 功能 | 典型场景 |
|---|---|---|
hermes |
启动交互式对话(自动恢复上次会话) | 日常使用 |
hermes -c "任务描述" |
单次任务,执行完自动退出 | 临时小需求 |
hermes --model <模型名> |
临时指定模型启动 | 切换模型测试 |
hermes --workspace <目录> |
以指定目录为工作上下文 | 项目代码审查 |
hermes --private |
隐私模式,不保存对话历史 | 敏感话题 |
hermes chat list / show / search |
会话管理 | 翻查历史 |
hermes model list / use / benchmark |
模型管理 | 切换与评测模型 |
hermes tools list / enable / disable |
工具开关 | 按需启用工具 |
hermes skills list / install |
技能管理 | 安装新技能 |
hermes cron list / run |
定时任务 | 自动化任务 |
hermes doctor |
系统诊断(--fix 可自动修复) |
出问题时先跑它 |
hermes status |
查看系统/资源/会话状态 | 日常巡检 |
hermes update |
更新 Hermes 本体 | 保持最新 |
三个高频组合用法:
# 以当前项目为上下文启动代码审查
hermes --workspace .
# 隐私模式处理敏感问题(不落库)
hermes --private
# 一键诊断并修复常见问题
hermes doctor --fix && hermes config validate
💡 小技巧:
hermes model benchmark会向所有已配置模型发送相同测试问题,对比响应速度、输出质量和 token 消耗,帮你直观找到「性价比之王」。
四、Hermes Agent 斜杠命令全表:像用 Slack 一样操控 Agent
在对话中输入 / 开头的斜杠命令,无需退出对话即可执行各种操作。这是 Hermes Agent 交互效率的倍增器。
核心斜杠命令速查
| 命令 | 功能 | 使用示例 |
|---|---|---|
/help |
查看所有可用命令 | /help |
/model |
切换模型(本次会话生效) | /model 后按列表选择 |
/memory |
查看/添加全局记忆 | /memory add 用户最近在学 Rust |
/skills |
管理技能开关 | /skills enable stock_analysis |
/compact |
压缩上下文,节省 token | /compact |
/clear |
清除当前上下文,全新开始 | /clear |
/export |
导出当前对话 | 支持 Markdown / JSON / 纯文本 |
/private / /public |
进入 / 退出隐私模式 | 本次对话不保存 |
/undo / /retry |
撤销上条消息 / 重新生成回复 | 不满意时回退 |
/system |
发送系统级指令 | /system 请用中文回答 |
/temp |
临时切换模型(仅下条消息) | /temp claude-3.5-sonnet |
三个高手级组合用法
组合 1:/temp 做模型 A/B 测试
You: 帮我写一个快速排序的 Python 实现
Hermes: [DeepSeek 给出实现]
You: /temp claude-3.5-sonnet
用类型注解和文档字符串重写上面的代码
Hermes: [Claude 给出更完善的实现]
同一个问题让两个模型各答一遍,效果差异一目了然。
组合 2:/system 纠正 Agent 行为
You: /system 从现在开始,所有代码示例都要包含单元测试
本次会话内所有代码输出都会自动附带测试,省得每次都叮嘱。
组合 3:/compact + /memory 管理长对话
对话超过 20 轮后,上下文会占用大量 token。先用 /memory 把关键结论存进全局记忆,再用 /compact 把长对话压缩成摘要——一次可节省约 8500 token。
💡 记不住全部命令没关系。只要记住
/help、/model、/memory三个最高频命令,就能覆盖 80% 的使用场景,其余在实战中慢慢熟悉即可。
五、新手最容易踩的 5 个坑
| # | 误区 | 正确做法 |
|---|---|---|
| 1 | 把它当搜索引擎,直接问「2026 年诺贝尔奖得主是谁?」 | 加上「搜索」指令:「搜索一下 2026 年诺贝尔奖的最新消息」,Hermes 会调用 web_search 获取实时信息 |
| 2 | 不给上下文:「帮我改一下这个代码」 | 给足背景:「审查 ~/project/main.py,重点关注内存泄漏和并发安全问题」 |
| 3 | 每次对话都重复「我是做电商的,用 Python 开发」 | 写入 SOUL.md / USER.md 或 /memory,一次配置永久生效 |
| 4 | 所有任务都用最贵的模型 | 配置分层模型:复杂推理用强模型,日常问答用便宜模型,实测可省 50%–70% |
| 5 | 工具执行请求不看细节直接确认 | 每次执行前仔细查看命令,尤其涉及删除和系统配置的操作 |
完整的新手误区与最佳实践清单,可在 06-基础使用入门.md 的「新手常见误区与最佳实践」章节找到。
六、延伸学习:把 Hermes Agent 玩得更深
掌握基础操作后,推荐按这条路径继续深入:
- 🧠 记忆机制:07-三层记忆系统详解.md —— 让 Agent 真正「记住」你,越用越懂你
- 🎯 技能生态:08-技能系统完全指南.md —— 技能生命周期与 Skills Hub 生态
- 🛠 工具全解:09-47个内置工具全解.md —— 47 个内置工具逐一详解
- 🚀 实战进阶:12-高阶玩法与实战案例.md —— 从单 Agent 到多 Agent 编排
- 📄 想要纸质版?用 generate_pdf.py 可将全书 Markdown 一键转换为精美 PDF
总结
Hermes Agent 基础使用可以浓缩为一句话:hermes 进对话,命令管配置,斜杠快操控。
- 记住 3 个启动命令:
hermes(日常)、hermes -c "任务"(单次)、hermes doctor(排障) - 记住 3 个斜杠命令:
/help(查帮助)、/model(切模型)、/memory(存记忆) - 避开 3 个坑:别当搜索引擎、给足上下文、善用记忆系统
把这份速查表收藏起来,配合三个实战小练习(让它搜索总结新闻、写一段脚本、管理一下文件),你的 Hermes Agent 就能立刻上岗,处理 80% 的日常任务。
