Hermes Agent常用操作和命令使用速查手册
小k77777
一、Hermes Agent 是什么
Hermes Agent 是一个本地命令行 AI Agent 工具。它可以连接大模型，例如 DeepSeek、OpenAI、OpenRouter、Ollama 等，也可以配置工具能力，例如终端、浏览器、语音、图片生成、消息网关等。
你可以把它理解成：一个可以在终端里聊天、调用工具、执行任务的 AI 助手。
安装完成后，最常用的入口命令是：
hermes
二、启动 Hermes
1. 普通启动
在 PowerShell 或 Windows Terminal 中输入：
hermes
作用：启动 Hermes 聊天模式。
启动后可以直接输入问题，例如：
你好，介绍一下你自己。
或者：
帮我分析当前目录下有哪些文件。
2. 启动 TUI 界面
如果你的版本支持 TUI，可以使用：
hermes --tui
作用：启动更完整的终端交互界面。
3. 继续上一次会话
hermes --continue
或者简写：
hermes -c
作用：继续最近一次对话，不从新会话开始。
适合场景：
- 上次任务没做完
- 想继续之前的上下文
- 不想重新描述需求
三、常用聊天方式
启动 Hermes 后，可以直接像聊天一样输入任务。
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 需要提前安装 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:\Users\sky\AppData\Local\hermes\config.yaml
密钥文件一般在：C:\Users\sky\AppData\Local\hermes\.env
注意：
.env 里通常保存 API Key，不要公开发给别人。
3. 设置单个配置项
hermes config set <key> <value>
示例：
hermes config set terminal.backend local
作用：把终端后端设置为 local。
六、诊断和修复
当 Hermes Agent 出现异常时，可以使用以下命令进行诊断和修复：
1. 查看运行日志
# 查看最近的日志 hermes logs # 查看详细的调试日志 hermes logs --debug # 查看特定会话的日志 hermes logs --session-id <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 <command> --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 <file> | 分析文件 | hermes analyze document.pdf |
hermes code <file> | 代码相关操作 | hermes code main.py |
hermes write <topic> | 文档写作 | hermes write "项目计划" |
hermes terminal <task> | 终端任务 | 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 <key> <value> | 设置配置项 | 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 |
以上就是Hermes Agent常用操作和命令使用速查手册的详细内容，更多关于Hermes Agent使用的资料请关注脚本之家其它相关文章！