Hermes安装部署

1、安装

Windows安装，在管理员模式下打开power shell界面输入

iex (irm https://hermes-agent.nousresearch.com/install.ps1)
#或者
irm https://hermes-agent.nousresearch.com/install.ps1 | iex

macOS / Linux / WSL2 终端输入

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

2、配置

Hermes Agent 配置文件

安装完成后，所有配置和数据都保存在 ~/.hermes/ 下：

~/.hermes/
├── config.yaml      # 主配置文件（模型、工具、终端后端等）
├── .env             # API 密钥和 Secret（不提交到版本库）
├── auth.json        # OAuth 凭据（Nous Portal 等）
├── SOUL.md          # Agent 人格设定文件
├── memories/        # 持久记忆（MEMORY.md、USER.md）
├── skills/          # 技能文件（Agent 自动创建和管理）
├── cron/            # 定时任务配置
├── sessions/        # 网关会话记录
└── logs/            # 日志（API 密钥自动脱敏）

安装完成后选择配置

三种 Setup 模式

**模式一：**Quick Setup（Nous Portal）免费 OAuth 登录，自动配置模型 + Tool Gateway（网页搜索、图片生成、TTS、浏览器）。推荐新用户使用。

**模式二：**Full Setup #手动逐项配置提供商、工具集、消息平台等。适合有明确需求、自带 API Key 的用户。

**模式三：**Blank Slate（空白起点）只保留最小运行集（提供商、文件工具、终端工具），其余一切关闭。适合需要精确控制 Agent 能力边界的高级用户。空白模式会显式写入配置，防止 hermes update 后自动开启新功能

1、出现How would you like to set up Hermes? 选择

#首次运行 hermes setup 时，会提示选择初始化模式：
hermes setup

#选择模式二
Full setup

2、出现模型选择

customer endpoint（enter URL manually）
#然后输入供应商的 API 端点地址
https://ai.xxxx.com/api/llmrouter
#然后输入API key
swda*************
#然后Select API compatibility mode:
1. Auto-detect [current]
#选择模型
deepseek-V4-flash

3、重新配置api

hermes model

3、微信飞书接入

hermes gateway setup
#选择微信/飞书
Weixin / WeChat
Feishu / Lark
#输入Y 复制超链接到浏览器打开，微信是扫码，飞书是创建智能体
#选择1、审批才能交流 2、所有人都能交流
1. Use DM pairing approval (recommended)
2. Allow al1 direct messages
#然后关闭终端一路回车
#进入终端重新输入
hermes gateway restart
#微信/飞书随便发个消息，获得code
#终端输入下面命令
hermes pairing approve weixin A5HVTX56

4、其他

启动 Hermes：

hermes          # 经典 CLI 模式
hermes --tui    # 现代 TUI 模式（推荐，支持鼠标、弹窗等）

常用命令

hermes sessions list                 			# 查看所有历史会话
hermes sessions list --limit 200	  			# 增大显示条数
hermes sessions list --limit 200 --offset 200   # 分页，取200之后的下一批
hermes sessions prune							# 删除超过90天已结束会话（默认）
hermes sessions prune --older-than 30 --yes     # 删除30天以上旧会话
hermes sessions delete 2026080_02030_xxxx --yes # 直接删除，跳过确认
hermes chat --resume xxx             			# 恢复历史对话
hermes chat -r xxx								# 恢复历史对话简写
hermes chat --continue [name]
hermes chat -c									
hermes sessions export <id> --format md 		# 导出记录

启动web管理面板

# 启动并预选指定 Profile（跳过 Profile 选择步骤）
coder dashboard

# 指定自定义端口
hermes dashboard --port 8080

# 绑定到所有网络接口（谨慎使用，建议配合防火墙）--host绑定的网络接口地址
hermes dashboard --port 8080 --host 0.0.0.0

升级命令

hermes update

设置 API key

hermes model

卸载 Hermes

Hermes 装在 ~/.hermes/hermes-agent/,并把 binary symlink 到 ~/.local/bin/hermes。

两条命令就能全部清掉。

hermes uninstall
#这一步会清掉你的 session、memory、skill、cron 任务和 API key。需要保留的先备份。
#macOS/Linux
rm -rf ~/.hermes
#windows
Remove-Item -Recurse -Force "$env:LOCALAPPDATA\hermes"

检查诊断命令

#检查
hermes doctor
#修复
hermes doctor --fix

Skill常用命令

hermes skills list                    # 列出所有技能
hermes skills update                  # 更新所有技能
hermes skills update <name>           # 更新特定技能
hermes skills reset <name>            # 重置到初始状态
hermes skills reset <name> --restore  # 完整恢复内置版本
hermes skills uninstall <name>        # 卸载 Hub 技能