安装步骤
以Windows11为例，其余的需执行上网找教程 或 参考官方文档安装教程（上面有链接）

前提工具安装：

自行下载 git 并安装（如果没有git，Hermes Agent是自动安装便携版 Git Bash，为了后续更好体验，建议自行安装完整版git）

更新power shell：自行上网下载更新

低版本power shell 有可能出现命令行安装中乱码问题

开始安装

方式一：命令行（什么系统执行对应命令即可）

Linux / macOS / WSL2

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
Windows（PowerShell，v0.14+ 原生支持）

iex (irm https://hermes-agent.nousresearch.com/install.ps1)
Termux (Android)

v0.15 冷启动优化后，Termux 环境下 hermes --version 仅需 0.8 秒

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
方式二：桌面端安装

安装桌面版（图形化界面、中文支持）：https://hermes-agent.nousresearch.com/docs/getting-started/desktop

也可以不通过前面的命令行直接安装桌面版，会自动帮你安装所有内容。但存在访问GitHub超时问题，所以还是建议先使用前面的 命令行【建议是使用方式一安装完后，下载桌面端。此时就可以正常使用桌面端了】

配置Hermes Agent

hermes model # 交互式选择模型和提供商
hermes setup --portal # 使用 Nous Portal 一键配置【推荐，但需要登录GitHub账号，绑定银行卡】
hermes setup # 或者运行完整设置向导【次推荐，每一步都自行设置】
①Nous Portal 是 v0.16 推荐的一键配置方式，提供 400+ 模型，OAuth 登录后即可使用，无需手动管理 API Key（自动帮你配置好免费的 搜索工具、图片工具、语音转文字 等等）

②API Key 存储在 ~/.hermes/.env 文件中（Windows 在 %LOCALAPPDATA%\hermes.env）

配置完成后建议使用桌面版进行使用，有直观的UI界面（方式二有桌面版安装链接）

补充：

命令行安装/桌面版安装会自动安装 所需的环境（遇到报错查看命令行报错提示即可），自动执行以下内容：

拉取或更新 Hermes 源码。普通 Linux / macOS / WSL2 用户默认安装到 ~/.hermes/hermes-agent；Windows 默认安装到 %LOCALAPPDATA%\hermes\hermes-agent
创建 Python 虚拟环境并安装依赖；必要时会安装 uv、Node.js、浏览器工具相关依赖
创建 hermes 命令入口，并提示把它所在目录加入 PATH
初始化数据目录。Linux / macOS / WSL2 默认是 ~/.hermes；Windows 默认是 %LOCALAPPDATA%\hermes
仅在文件不存在时创建 config.yaml、.env、SOUL.md，已有配置会保留
交互式终端中会继续运行 setup 向导
桌面版使用
桌面版的使用很直白不做过多介绍（此处省略一万字）

CLI使用
注意：如果cmd输入无效，就使用power shell

交互式对话（终端）
hermes # 启动交互式对话
hermes --tui # 使用 TUI 启动（v0.11+，React/Ink 终端界面）
TUI 模式（v0.11+）提供：

实时 token 流式输出
每轮对话耗时统计
子 Agent 可观测性面板
多会话管理
固定输入栏（类似聊天应用）
单次对话（非交互式）
hermes chat -q “查看系统资源占用情况”
适合脚本调用或一次性任务。

诊断
hermes doctor # 检查环境健康状态，诊断潜在问题
常用快捷键
快捷键 功能
Alt + V 从剪贴板粘贴图像
Ctrl + C 中断当前操作
Ctrl + D 退出会话
Ctrl + Z 暂停并挂起到后台，fg 恢复
Alt + Enter 插入新行，输入多行文本
Ctrl + J 插入新行，输入多行文本
Shift + Enter 插入新行，需终端支持独立按键序列
更新/备份
hermes update
建议：升级前备份 ~/.hermes/auth.json 和 ~/.hermes/config.yaml。大版本升级时建议直接跳到最新补丁版本（如 v0.15.1 而非 v0.15.0）。

卸载
hermes uninstall
如需完全清理所有数据：

Linux / macOS / WSL2

rm -rf ~/.hermes

Windows

Remove-Item -Recurse -Force $env:LOCALAPPDATA\hermes
Web界面使用
由于已经有了桌面版，所以更推荐使用桌面版，Web版了解即可。

Hermes 提供了一个基于浏览器的 Web 管理界面（Dashboard），替代手动编辑 YAML 和 CLI 命令，用于配置管理、API 密钥设置和会话监控。

官方文档：https://hermes-agent.nousresearch.com/docs/user-guide/features/web-dashboard

启动与配置
hermes dashboard # 启动，自动打开浏览器 http://127.0.0.1:9119
hermes dashboard --port 8080 # 自定义端口
hermes dashboard --tui # 启用浏览器内 Chat 标签页
hermes dashboard --status # 查看运行状态
hermes dashboard --stop # 停止运行
hermes dashboard &>/dev/null & # 后台运行
hermes dashboard &>/dev/null & disown # 后台运行并脱离终端
v0.16 Web 管理面板
v0.16 将 Dashboard 升级为完整的 Web 管理面板，支持：

消息渠道配置：在网页中配置 Telegram、Discord、Slack 等平台
MCP 目录管理：浏览和配置 MCP 服务器
凭证管理：可视化编辑 .env 和 auth.json
Webhooks：配置外部系统回调
Gateway 控制：启动、停止、监控 Gateway 状态
简体中文界面：完整的中文本地化
Hermes目录介绍
官方文档：https://hermes-agent.nousresearch.com/docs/user-guide/configuration

Hermes目录位置：
①普通 Linux / macOS / WSL2 用户默认在 ~/.hermes/hermes-agent；
②Windows 默认安装到 %LOCALAPPDATA%\hermes\hermes-agent

例如我的Windows电脑目录为：C:\Users\conan\AppData\Local\hermes\hermes-agent

配置目录结构
~/.hermes/
├── config.yaml # 主配置文件（模型、终端、TTS、压缩等）
├── .env # API 密钥和机密信息
├── auth.json # OAuth 提供商凭证（Nous Portal 等）
├── SOUL.md # 主 Agent 的身份 / 人格文件，会拼入系统提示词开头部分
├── memories/ # 持久化记忆（MEMORY.md、USER.md）
├── skills/ # 技能
├── cron/ # 定时任务
├── sessions/ # 会话
└── logs/ # 日志（errors.log、gateway.log — 密钥自动脱敏）
配置管理命令
hermes config # 查看当前配置
hermes config edit # 用 $EDITOR 打开 config.yaml 编辑
hermes config set section.key value # 直接设置某个配置项
会话内也可以通过斜杠命令调整部分配置：

命令 功能
/config 查看当前配置
/model [model-name] 查看或切换当前会话使用的模型
/personality [name] 切换预设交互风格 / 人格
/reasoning [level/show/hide] 调整或查看模型推理级别
/voice [on/off/tts/status] 开启、关闭或查看语音输入 / TTS 输出状态
/yolo 切换绕过确认模式，减少工具执行确认；只建议在可信环境和低风险任务使用
二、基本功能

1. 会话管理