Hermes Agent + Web UI 完整指南

AI应用 Hermes  收藏
0 / 8

简介

Hermes Agent 是由 Nous Research 构建的自我改进型 AI 智能体，具备持续学习、技能自动创建、跨会话记忆等独特能力。配合 Hermes Web UI，你可以通过全功能 Web 面板管理聊天会话、监控用量、配置平台渠道、管理定时任务。

本文将基于快速安装流程 ，带你完成从安装到微信对话配置、模型选择、以及卸载的完整流程。

一、快速安装 Hermes Agent

前置要求

  • Linux / macOS / WSL2 ：直接安装
  • Windows ：需先安装 WSL2
  • Android ：通过 Termux 安装（使用 .[termux] 精简依赖）

一键安装

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

安装器会自动处理平台特定的配置。

Receiving objects: 100% (43711/43711), 129.24 MiB | 11.54 MiB/s, done.
Resolving deltas: 100% (30701/30701), done.
✓ Cloned via HTTPS
✓ Repository ready
→ Creating virtual environment with Python 3.11...
Using CPython 3.11.15
Creating virtual environment at: venv
Activate with: source venv/bin/activate
✓ Virtual environment ready (Python 3.11)
→ Installing dependencies...

安装到上面 这个位置会时间长一些耐心等待

进入了选择模型页面

我是 minimax 选中后
MiniMax China (domestic direct API)

提示没配置 key
No MiniMax (China) API key configured.
MINIMAX_CN_API_KEY (or Enter to cancel): 这里输入 key 不显示
API key saved.

Base URL [https://api.minimaxi.com/anthropic]: 直接回车

选择一个你支持的模型，我是 2.7 选择 2.7 就行
Found 6 model(s) from models.dev registry
Select default model:
MiniMax-M2
MiniMax-M2.5
-> MiniMax-M2.7
MiniMax-M2.7-highspeed
MiniMax-M2.1
MiniMax-M2.5-highspeed
Enter custom model name
Skip (keep current)

Connect a messaging platform? (Telegram, Discord, etc.)
↑↓ navigate ENTER/SPACE select ESC cancel

(●) Set up messaging now (recommended)
→ (○) Skip — set up later with 'hermes setup gateway'

这里 message 跳过

Launch hermes chat now? [Y/n]: 输入 y

就进入成功页面，如下

关闭之后会有一些使用提示信息

Resume this session with:
  hermes --resume 20260418_201740_c81ef1
  hermes -c "<think> The user said "hello" and the assistant responded with a greeting. Th..."

Session:        20260418_201740_c81ef1
Title:          <think> The user said "hello" and the assistant responded with a greeting. Th...
Duration:       56s
Messages:       2 (1 user, 0 tool calls)


┌─────────────────────────────────────────────────────────┐
│              ✓ Installation Complete!                   │
└─────────────────────────────────────────────────────────┘


📁 Your files (all in ~/.hermes/):

   Config:    ~/.hermes/config.yaml
   API Keys:  ~/.hermes/.env
   Data:      ~/.hermes/cron/, sessions/, logs/
   Code:      ~/.hermes/hermes-agent/

─────────────────────────────────────────────────────────

🚀 Commands:

   hermes              Start chatting
   hermes setup        Configure API keys & settings
   hermes config       View/edit configuration
   hermes config edit  Open config in editor
   hermes gateway install Install gateway service (messaging + cron)
   hermes update       Update to latest version

─────────────────────────────────────────────────────────

⚡ Reload your shell to use 'hermes' command:

   source ~/.bashrc
	 
	 
	 ```
	 

### 安装后初始化

```bash
source ~/.bashrc     # 或 source ~/.zshrc
hermes               # 启动交互式对话

完整设置向导

hermes setup         # 一次性完成所有配置

设置向导会引导你完成：

  • LLM 提供商和模型选择
  • API 密钥配置
  • 消息渠道设置（Telegram、Discord、微信等）
  • 工具启用

二、安装 Hermes Web UI

方式一：npm 安装（推荐）

npm install -g hermes-web-ui
hermes-web-ui start

访问 http://localhost:8648 即可打开 Web 管理面板。

方式二：一键自动安装

自动检测系统并安装 Node.js（如未安装）和 Web UI，支持 Debian/Ubuntu/macOS：

bash <(curl -fsSL https://cdn.jsdelivr.net/gh/EKKOLearnAI/hermes-web-ui@main/scripts/setup.sh)

方式三：Docker Compose

docker compose up -d --build hermes-agent hermes-webui

访问 http://localhost:6060 （可通过 PORT=16060 环境变量自定义端口）。

Web UI CLI 命令速查

命令 说明
hermes-web-ui start 后台启动 Web UI
hermes-web-ui start --port 9000 自定义端口启动
hermes-web-ui stop 停止后台进程
hermes-web-ui restart 重启
hermes-web-ui status 查看运行状态
hermes-web-ui update 更新到最新版本

三、配置微信对话

方案 A：Hermes 原生微信支持

Hermes Agent 原生支持微信，通过腾讯 iLink API 实现。

1. 启动微信 Gateway

hermes gateway setup

在设置向导中选择 WeChat（微信） ，系统会引导你：

  • 启用微信渠道
  • 配置提及控制和消息模式

2. 启动 Gateway

hermes gateway start

首次使用时，需要在浏览器中打开二维码页面进行微信扫码登录，凭证会自动保存到 ~/.hermes/auth.json。

3. 通过 Web UI 配置

打开 Web UI (http://localhost:8648 ) → 平台渠道 → 微信 ，可以：

  • 启用/禁用微信渠道
  • 配置提及控制
  • 设置提及模式
  • 扫码登录（浏览器扫码，自动保存凭证）

方案 B：HermesClaw（Hermes + OpenClaw 双开）

如果你需要在同一个微信账号 上同时运行 Hermes 和 OpenClaw：

curl -fsSL https://raw.githubusercontent.com/AaronWong1999/hermesclaw/main/install.sh | bash

HermesClaw 作为唯一的 iLink 轮询者，通过双代理架构让两个 Gateway 各连各的，互不冲突。

微信命令切换：

默认路由为 Hermes。在 /both 模式下，回复会标注 [Hermes Agent] / [OpenClaw]。

四、配置模型

方式一：交互式配置

hermes model

会引导你选择提供商和模型。

方式二：CLI 直接设置

hermes model [provider:model]

例如：

hermes model openrouter:anthropic/claude-sonnet-4
hermes model openai:gpt-4o

方式三：对话中切换

在任意对话中使用：

/model openrouter:anthropic/claude-sonnet-4

支持的提供商

提供商 说明
OpenRouter 200+ 模型，推荐首选
OpenAI GPT-4o、GPT-4 等
Anthropic Claude 系列
Nous Portal Nous Research 自有模型
小米 MiMo 小米大模型
z.ai / GLM 智谱 GLM
Kimi / Moonshot 月之暗面
MiniMax MiniMax 模型
Hugging Face 开源模型
自定义端点 任何 OpenAI 兼容 API

模型凭证配置

API 密钥存储在 ~/.hermes/auth.json 中，也可通过 hermes setup 向导配置。

Web UI 中的模型管理

打开 Web UI → 模型管理 ：

  • 自动从凭证池发现可用模型（读取 ~/.hermes/auth.json）
  • 从每个 Provider 端点获取可用模型列表（/v1/models）
  • 添加自定义 OpenAI 兼容 Provider
  • Provider 级别模型分组展示

五、常用操作速查

核心命令

hermes                    # 启动交互式终端对话
hermes model              # 选择/切换模型
hermes tools              # 配置启用的工具
hermes config set          # 设置配置项
hermes gateway            # 消息网关管理
hermes setup              # 完整设置向导
hermes update             # 更新到最新版本
hermes doctor             # 诊断问题
hermes claw migrate       # 从 OpenClaw 迁移

终端与消息平台通用命令

命令 功能
/new 或 /reset 新建对话
/model [provider:model] 切换模型
/personality [name] 设置人格
/retry 重试最后一次
/undo 撤销最后一次
/compress 压缩上下文
/usage 查看用量
/skills 浏览已安装技能
/stop 中断当前工作

六、卸载指南

卸载 Hermes Agent

如果是gatway运行，先停止，如果不是直接关闭
# 停止 gateway
hermes gateway stop

如果 Hermes 是通过官方安装脚本安装的，最简单的卸载方式是直接运行：
bash
hermes uninstall
运行该命令后，系统会询问是否保留 ~/.hermes/ 配置文件。这是为了让你可以在未来重装时，保留原有的配置、API密钥、记忆和技能等数据。

Uninstall Options:

  1) Keep data - Remove code only, keep configs/sessions/logs
     (Recommended - you can reinstall later with your settings intact)

  2) Full uninstall - Remove everything including all data
     (Warning: This deletes all configs, sessions, and logs permanently)

  3) Cancel - Don't uninstall

Select option [1/2/3]: 2      这个提示是否完整卸载输入2

⚠️  WARNING: This will permanently delete ALL Hermes data!
   Including: configs, API keys, sessions, scheduled jobs, logs

Type 'yes' to confirm: yes   是否删除 输入yes 确认


控制台提示下面信息，卸载成功
Uninstall Complete!


也可以急速删除安装文件
# 删除安装目录
rm -rf ~/.hermes

# 如果使用 pip 安装
pip uninstall hermes-agent

# 清理 shell 配置中的 hermes 路径（~/.bashrc 或 ~/.zshrc）

如果需要保留配置和记忆，请先备份 ~/.hermes/ 目录。

卸载 Hermes Web UI

# 停止 Web UI
hermes-web-ui stop

# 卸载 npm 全局包
npm uninstall -g hermes-web-ui

# 如果需要，清理相关进程
pkill -f "hermes-web-ui" || true

卸载 HermesClaw（如果安装了）

sudo systemctl stop hermesclaw
sudo systemctl disable hermesclaw
sudo rm -f /etc/systemd/system/hermesclaw.service
sudo systemctl daemon-reload

# 恢复 openclaw-weixin 配置
find "$HOME" -maxdepth 5 -name "*.json.bak" -path "*/openclaw-weixin/accounts/*"   -exec sh -c 'for f; do cp "$f" "${f%.bak}"; done' sh {} +

# 恢复 Hermes .env
[ -f "$HOME/.hermes/.env.bak" ] && cp "$HOME/.hermes/.env.bak" "$HOME/.hermes/.env"

rm -rf "$HOME/hermesclaw"

七、常见问题

1. Windows 用户怎么办？

Windows 原生不支持 Hermes Agent，请先安装 WSL2，然后在 WSL2 中运行安装命令。

2. 微信 Gateway 启动后没反应？

  • 确认已完成扫码登录
  • 检查 ~/.hermes/.env 中 WEIXIN_BASE_URL 是否正确
  • 使用 hermes doctor 诊断问题

3. 模型切换不生效？

  • 确认 API 密钥已正确配置在 ~/.hermes/auth.json
  • 使用 /model provider:model 格式指定完整路径
  • 检查网络连接是否正常

4. Web UI 端口冲突？

Web UI 启动时会自动检测端口冲突并清理残留进程。如需自定义端口：

hermes-web-ui start --port 9000

总结

Hermes Agent 提供了一条命令完成安装的极简体验，配合 Web UI 的可视化管理，无论是快速上手还是深度定制都非常方便。微信对话通过原生 iLink 集成或 HermesClaw 双开方案都能轻松实现。模型配置支持 200+ 模型自由切换，真正做到零锁定。

快速上手三步走：

  1. curl -fsSL ... | bash 一键安装 Hermes
  2. npm install -g hermes-web-ui && hermes-web-ui start 启动 Web UI
  3. hermes model 选择你喜欢的模型，开始对话！
阅读全文