hermes-webui中文版支持自定义任意大模型支持微信飞书等接入

bug反馈可以加入科哥专属群交流➕ 广告勿进！​

​

---

---

Hermes Web UI 用户使用手册

一、系统简介

Hermes Web UI 是 Hermes Agent 的网页管理界面，提供直观的聊天交互、会话管理、任务调度、使用统计、平台渠道配置和日志查看等功能。

主要功能模块：

模块	功能说明
💬 聊天	与 AI 助手对话，会话管理，文件上传
📋 任务	创建和管理定时任务
🔌 渠道	配置 Telegram、Discord、Slack 等 messaging 平台
🎭 模型	管理 AI 模型和 API 提供商
🧠 技能	浏览和管理技能扩展
💾 记忆	管理用户画像和个人偏好
📊 使用	查看 token 使用量和成本统计
📝 日志	查看系统运行日志
⚙️ 设置	配置系统各项参数

---

二、快速开始

2.1 启动服务

cd /root/hermes-web-ui
./start_app.sh 7860

服务启动后访问地址：

http://你的服务器IP:7860

2.2 界面介绍

登录后可以看到：

┌─────────────────────────────────────────────────────┐
│  🏠 Hermes                            [模型选择器] [🌐 EN] │
├──────────┬──────────────────────────────────────────────┤
│          │                                           │
│ 💬 聊天  │                                           │
│ 📋 任务  │            主内容区域                       │
│ 🔌 渠道  │                                           │
│ 🎭 模型  │                                           │
│ 🧠 技能  │                                           │
│ 💾 记忆  │                                           │
│ 📝 日志  │                                           │
│ 📊 使用  │                                           │
│ ⚙️ 设置  │                                           │
│          ├──────────────────────────────────────────────┤
│    👤    │              状态栏                     │
└──────────┴──────────────────────────────────────────────┘

侧边栏说明：

• 各功能模块导航入口
• 右上角：模型选择器、语言切换
• 左下角：连接状态（已连接/未连接）+ 版本号

---

三、功能使用指南

3.1 💬 聊天

开始对话：

1. 点击左侧「聊天」进入对话页面
2. 在底部输入框输入消息
3. 按 Enter 或点击发送按钮

高级功能：

功能	操作
上传文件	点击输入框左侧 📎 图标
切换模型	点击顶部模型名称下拉选择
新建会话	点击左上角「新建对话」按钮
切换历史会话	左侧会话列表点击选择
删除会话	会话右键 → 删除
重命名会话	会话右键 → 重命名

消息格式支持：

• Markdown 渲染（代码高亮、链接、图片等）

---

3.2 📋 定时任务

创建任务：

1. 点击左侧「任务」进入任务页面
2. 点击「新建任务」按钮
3. 填写任务配置：

字段	说明	示例
任务名称	任务标识名	daily_report
描述	任务说明	每日报告推送
Cron 表达式	执行时间	0 9 * * *
内容	执行的指令	/report today
启用	是否激活	开启

常用 Cron 表达式：

表达式	含义
0 9 * * *	每天 9:00
0 */2 * * *	每 2 小时
0 0 * * 0	每周日午夜
0 0 1 * *	每月 1 日午夜

任务操作：

• 立即执行：点击任务右侧 ▶️ 按钮
• 暂停/恢复：点击暂停按钮
• 编辑：点击编辑按钮
• 删除：点击删除按钮

---

3.3 🔌 渠道配置

支持的平台：

• 📱 Telegram
• 💬 Discord
• 💼 Slack
• 📱 WhatsApp
• 💬 Matrix
• 🟦 Feishu (飞书)
• 💬 WeCom (企业微信)

配置步骤：

1. 点击左侧「渠道」进入配置页面
2. 选择要配置的平台卡片
3. 填写平台凭证信息
4. 点击保存并重启 Gateway

常见配置项：

平台	必要配置
Telegram	Bot Token
Discord	Bot Token
Slack	Bot Token, Signing Secret

💡 提示：配置完成后需要重启 Gateway 才能生效

---

3.4 🎭 模型管理

切换默认模型：

1. 点击顶部模型选择器
2. 从下拉列表选择目标模型
3. 自动保存到配置文件

查看可用模型：

1. 点击左侧「模型」进入模型管理
2. 查看所有可用模型列表
3. 按提供商分组

添加自定义模型：

1. 点击「添加自定义模型」按钮
2. 填写：
   • API Name：自定义名称
   • Base URL：API 端点地址
   • API Key：访问密钥

---

3.5 🧠 技能管理

浏览技能：

1. 点击左侧「技能」进入技能页面
2. 查看已安装的技能列表
3. 点击技能查看详情

常用技能：

技能	功能
web	网页搜索和抓取
browser	浏览器自动化
terminal	终端命令执行
file	文件操作
code_execution	代码执行
vision	图片分析
image_gen	AI 绘画

---

3.6 💾 记忆管理

功能说明：

• 持久化用户画像和偏好设置
• 跨会话记忆保持

操作：

1. 点击左侧「记忆」进入记忆管理
2. 查看当前记忆内容
3. 编辑用户画像

---

3.7 📊 使用统计

查看内容：

统计项	说明
总 Token	累计使用 token 数量
输入/输出	input/output 分类统计
成本估算	预计费用
缓存命中率	缓存复用率
模型分布	各模型使用占比
趋势图	30 天使用趋势

---

3.8 📝 日志查看

查看日志：

1. 点击左侧「日志」进入日志页面
2. 选择日志类型：

类型	内容
agent	Agent 运行日志
gateway	Gateway 消息日志
errors	错误日志

筛选功能：

• 按日志级别（INFO、WARNING、ERROR）
• 搜索关键词
• 显示最近 N 行

---

3.9 ⚙️ 设置

配置分类：

分类	说明
显示设置	流式输出、紧凑模式、思考过程等
Agent 设置	最大轮数、超时时间、工具强制等
记忆设置	启用状态、字符限制
隐私设置	PII 脱敏
API 设置	API Server 配置

---

四、状态说明

4.1 连接状态

侧边栏底部显示连接状态：

状态	含义
🟢 已连接	Gateway 正常运行
🔴 未连接	Gateway 未启动或异常

4.2 故障排查

常见问题：

问题	原因	解决方法
显示"未连接"	Gateway 未启动	重启 start_app.sh
无法发送消息	API 请求失败	检查模型配置
任务不执行	Gateway 未运行	确认 Gateway 状态
模型无法切换	配置文件权限	检查 ~/.hermes/config.yaml

---

五、快捷操作

5.1 常用快捷键

快捷键	功能
Enter	发送消息
Shift + Enter	换行
Ctrl + K	搜索命令

5.2 常用命令

在聊天界面可直接使用：

命令	功能
/new	新建会话
/model [模型名]	切换模型
/skills	查看技能列表
/usage	查看使用统计

---

六、附录

6.1 端口说明

端口	服务
7860	Web UI 前端
8642	Hermes Gateway API
8643	Web UI 后端服务

6.2 配置文件位置

• 主配置：~/.hermes/config.yaml
• 凭证配置：~/.hermes/.env
• 凭证池：~/.hermes/auth.json

6.3 日志文件位置

• Agent 日志：~/.hermes/agent.log
• Gateway 日志：~/.hermes/gateway.log
• 错误日志：~/.hermes/errors.log

---

遇到问题？

1. 检查服务是否运行：ps aux | grep hermes
2. 查看 Gateway 状态：hermes gateway status
3. 查看日志：使用本手册 3.8 节方法

祝您使用愉快！🚀