一、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:UsersskyAppDataLocalhermesconfig.yaml

密钥文件一般在：C:UsersskyAppDataLocalhermes.env

注意：

.env 里通常保存 API Key，不要公开发给别人。

3. 设置单个配置项

hermes config set  

示例：

hermes config set terminal.backend local

作用：把终端后端设置为 local。

六、诊断和修复

当 Hermes Agent 出现异常时，可以使用以下命令进行诊断和修复：

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