Hermes Agent常用操作和命令使用速查手册
一、Hermes Agent 是什么
Hermes Agent 到底是个什么东西？简单来说，它是一个跑在终端里的 AI 助手，支持连接 DeepSeek、OpenAI、OpenRouter、Ollama 这些主流大模型，还能配上一堆工具——比如终端操作、浏览器控制、语音交互、图片生成、消息推送之类。说得再直白点：你可以在命令行里跟它聊天，让它帮你干活。
装好之后，最常用的入口命令就一个：
hermes
二、启动 Hermes
1. 普通启动
打开 PowerShell 或 Windows Terminal，敲下：
hermes
回车之后，聊天模式就启动了。这时候直接打字问就行，比如：
你好，介绍一下你自己。
或者：
帮我分析当前目录下有哪些文件。
2. 启动 TUI 界面
如果版本支持 TUI（终端用户界面），可以用这个方式启动：
hermes --tui
效果是得到一个更完整的交互界面，看着更舒服。
3. 继续上一次会话
hermes --continue
简写版本：
hermes -c
作用很明显——接着上次没聊完的内容继续，不用从头再来。适合的场景比如：上次任务没做完、想延续上下文、不想重新描述需求。
三、常用聊天方式
启动后，直接像跟人聊天一样发任务就行。以下是几种常见用法：
1. 普通问答
解释一下什么是 LoRA 微调。
DeepSeek 和 Qwen 有什么区别？
2. 文件分析
帮我查看当前目录有哪些文件，并总结每个文件的作用。
帮我阅读这个项目，告诉我入口文件在哪里。
3. 代码相关
帮我检查这个 Python 脚本有没有问题。
帮我给当前项目写一个 README。
帮我修改代码，让它支持命令行参数。
4. 文档写作
帮我把这段内容整理成 CSDN 风格的 Markdown 文档。
帮我写一份安装教程，要求适合新手。
5. 终端任务
如果你配好了 local terminal，Hermes 就能在本机执行命令。比如：
帮我查看当前 Python 版本。
帮我检查 Git 是否安装成功。
帮我运行这个项目的测试。
需要注意一点：涉及删除文件、修改系统配置、安装软件这类操作时，最好先让它确认一下要做什么，别直接盲跑。
四、配置相关命令
1. 重新运行完整配置向导
hermes setup
这个命令会重新配置模型、终端、工具、网关等所有选项。适合第一次配置错了、想换模型服务、或者想从头来一遍的场景。
2. 重新配置模型
hermes setup model
只重新配置模型提供商和模型名称。比如从 DeepSeek 换成 OpenRouter，或者从 deepseek-chat 换成 deepseek-reasoner，又或者改 API Key、改 Base URL，都走这个命令。
3. 重新配置终端后端
hermes setup terminal
这一步决定 Hermes 在哪里执行终端命令。常见选项如下：
| 选项 | 说明 |
|---|---|
| Local | 直接在本机执行命令 |
| Docker | 在 Docker 容器中执行命令 |
| SSH | 在远程机器执行命令 |
| Keep current | 保持当前配置 |
新手一般选 Local 就行。如果担心安全，可以选 Docker，但前提是得先装好 Docker Desktop。
4. 重新配置工具
hermes setup tools
这个命令用来配置浏览器、图片生成、TTS（文本转语音）、搜索等工具。新手可以这样取舍：
| 工具 | 新手建议 |
|---|---|
| Browser | 选 Local Browser |
| Image Generation | 可以先 Skip |
| Text-to-Speech | 可以先 Skip，或者选 Microsoft Edge TTS |
| Search | 如果没有订阅服务，可以先跳过 |
5. 配置消息网关
hermes setup gateway
用来连接 Telegram、Discord、Slack、Email 这些消息平台。新手建议先放一放，等命令行能稳定玩转了再研究。
五、查看和修改配置
1. 查看当前配置
hermes config
显示当前 Hermes 的所有配置，包括模型、provider、终端后端、工具状态、配置文件路径等，一眼就能看清。
2. 打开配置文件
hermes config edit
用编辑器打开配置文件。Hermes 的主配置通常在这个位置：C:UsersskyAppDataLocalhermesconfig.yaml，密钥文件在：C:UsersskyAppDataLocalhermes.env。.env 里存的是 API Key，千万别泄露出去。
3. 设置单个配置项
hermes config set
直接改某个配置项。例如：
hermes config set terminal.backend local
把终端后端改成 local。
六、诊断和修复
当 Hermes 出现异常时，这几个命令能帮你快速定位和修复。
1. 查看运行日志
# 查看最近的日志 hermes logs # 查看详细的调试日志 hermes logs --debug # 查看特定会话的日志 hermes logs --session-id
2. 诊断工具状态
# 检查所有工具的状态 hermes diagnose tools # 检查模型连接状态 hermes diagnose model # 检查终端后端状态 hermes diagnose terminal # 运行完整诊断 hermes diagnose --all
3. 常见问题修复
# 重置会话状态（当会话卡住时） hermes reset-session # 清理临时文件 hermes cleanup # 修复配置文件权限 hermes fix-permissions # 重新初始化工具环境 hermes init-tools
4. 获取帮助
# 查看所有可用命令 hermes --help # 查看特定命令的帮助 hermes--help # 查看版本信息 hermes --version
七、更新和卸载
1. 更新 Hermes Agent
# 检查更新 hermes check-update # 更新到最新版本 hermes update # 更新到指定版本 hermes update --version 1.2.3 # 更新并重启服务 hermes update --restart
2. 卸载 Hermes Agent
# 完全卸载（保留配置文件） hermes uninstall # 完全卸载（删除所有文件，包括配置文件） hermes uninstall --purge # 仅卸载特定组件 hermes uninstall --component tools hermes uninstall --component model
3. 重新安装
# 卸载后重新安装 hermes reinstall # 重新安装指定版本 hermes reinstall --version 1.2.3 # 重新安装并恢复配置 hermes reinstall --restore-config
4. 备份和恢复
# 备份当前配置 hermes backup-config # 恢复备份的配置 hermes restore-config --file backup_20240614.json # 导出当前配置 hermes export-config --output my_config.json # 导入配置 hermes import-config --file my_config.json
八、常用命令速查表
启动相关
| 命令 | 说明 | 示例 |
|---|---|---|
hermes | 启动 Hermes Agent | hermes |
hermes --tui | 启动 TUI 界面 | hermes --tui |
hermes --continue | 继续上次会话 | hermes --continue |
聊天方式
| 命令 | 说明 | 示例 |
|---|---|---|
hermes chat | 普通问答模式 | hermes chat |
hermes analyze | 分析文件 | hermes analyze document.pdf |
hermes code | 代码相关操作 | hermes code main.py |
hermes write | 文档写作 | hermes write "项目计划" |
hermes terminal | 终端任务 | hermes terminal "列出文件" |
配置管理
| 命令 | 说明 | 示例 |
|---|---|---|
hermes config | 查看当前配置 | hermes config |
hermes config-wizard | 运行配置向导 | hermes config-wizard |
hermes config-model | 重新配置模型 | hermes config-model |
hermes config-terminal | 重新配置终端 | hermes config-terminal |
hermes config-tools | 重新配置工具 | hermes config-tools |
hermes config-gateway | 配置消息网关 | hermes config-gateway |
hermes edit-config | 编辑配置文件 | hermes edit-config |
hermes set | 设置配置项 | hermes set model.temperature 0.7 |
诊断维护
| 命令 | 说明 | 示例 |
|---|---|---|
hermes diagnose | 运行诊断 | hermes diagnose |
hermes logs | 查看日志 | hermes logs |
hermes reset-session | 重置会话 | hermes reset-session |
hermes cleanup | 清理临时文件 | hermes cleanup |
更新卸载
| 命令 | 说明 | 示例 |
|---|---|---|
hermes update | 更新到最新版 | hermes update |
hermes uninstall | 卸载 Hermes | hermes uninstall |
hermes reinstall | 重新安装 | hermes reinstall |
hermes backup-config | 备份配置 | hermes backup-config |
快捷参数
| 参数 | 说明 | 示例 |
|---|---|---|
-h, --help | 显示帮助 | hermes --help |
-v, --version | 显示版本 | hermes --version |
-d, --debug | 调试模式 | hermes --debug |
-q, --quiet | 静默模式 | hermes --quiet |
