安装步骤以Windows11为例其余的需执行上网找教程 或 参考官方文档安装教程上面有链接前提工具安装自行下载 git 并安装如果没有gitHermes Agent是自动安装便携版 Git Bash为了后续更好体验建议自行安装完整版git更新power shell自行上网下载更新低版本power shell 有可能出现命令行安装中乱码问题开始安装方式一命令行什么系统执行对应命令即可Linux / macOS / WSL2curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bashWindowsPowerShellv0.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 Agenthermes 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-agentWindows 默认安装到 %LOCALAPPDATA%\hermes\hermes-agent创建 Python 虚拟环境并安装依赖必要时会安装 uv、Node.js、浏览器工具相关依赖创建 hermes 命令入口并提示把它所在目录加入 PATH初始化数据目录。Linux / macOS / WSL2 默认是 ~/.hermesWindows 默认是 %LOCALAPPDATA%\hermes仅在文件不存在时创建 config.yaml、.env、SOUL.md已有配置会保留交互式终端中会继续运行 setup 向导桌面版使用桌面版的使用很直白不做过多介绍此处省略一万字CLI使用注意如果cmd输入无效就使用power shell交互式对话终端hermes # 启动交互式对话hermes --tui # 使用 TUI 启动v0.11React/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 / WSL2rm -rf ~/.hermesWindowsRemove-Item -Recurse -Force $env:LOCALAPPDATA\hermesWeb界面使用由于已经有了桌面版所以更推荐使用桌面版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:9119hermes 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.jsonWebhooks配置外部系统回调Gateway 控制启动、停止、监控 Gateway 状态简体中文界面完整的中文本地化Hermes目录介绍官方文档https://hermes-agent.nousresearch.com/docs/user-guide/configurationHermes目录位置①普通 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 切换绕过确认模式减少工具执行确认只建议在可信环境和低风险任务使用二、基本功能会话管理