已有 Hermes Agent？7 分钟让 Agent 自主装好 hermes-web-ui + SenseNova Skill

实战指南 | 从零到生图，全程真实命令、真实地址，亲测可用

封面图
封面图

目录

前言：为什么是这套组合？

如果你已经在用 Hermes Agent（Nous Research 出品的自进化 AI 智能体），你可能已经体验过它跨会话记忆、自主创建技能、多平台接入的核心能力。但 Hermes Agent 默认使用的是海外模型（如 Claude、GPT），在国内网络环境下延迟高、成本也不低。

商汤 SenseNova 在 2026 年 5 月发布了 Token Plan 免费套餐，每 5 小时 1500 次调用额度，覆盖 sensenova-6.7-flash-lite（多模态理解+对话）和 sensenova-u1-fast（信息图生成）两款模型。更重要的是，商汤还开源了 SenseNova-Skills，遵循 Agent Skills 开放标准，原生兼容 Hermes Agent —— 安装后你的 Agent 直接拥有文生图、信息图生成、PPT 创作、Excel 数据分析、深度调研等能力。

而 hermes-web-ui（GitHub 4.3K Stars）则提供了浏览器端的完整管理界面：实时对话、技能浏览、用量分析、定时任务、多平台网关配置，一条命令就能装好。

三件套合体：Hermes Agent（大脑）+ hermes-web-ui（操作台）+ SenseNova Skills（画笔），7 分钟即可完成部署并实测生图。

第 1 分钟：确认 Hermes Agent 运行正常

前提条件

|
项目
|
要求
|
| --- | --- |
|
操作系统
|
Linux / macOS / WSL2 / Android Termux
|
|
Python
|
3.11+（安装脚本自动处理）
|
|
网络
|
可访问 GitHub 和 token.sensenova.cn
|

安装 Hermes Agent（如果还没装）

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

安装脚本自动安装 uv、Python 3.11、Node.js 22、ripgrep、ffmpeg 等依赖。完成后重新加载 Shell：

source ~/.bashrc    # bash 用户
# 或 source ~/.zshrc   # macOS zsh 用户

Windows 用户注意：Hermes Agent 不支持原生 Windows，必须在 WSL2 中运行。请先执行 wsl --install（管理员 PowerShell），重启后进入 Ubuntu 终端操作。

验证安装

hermes --version
hermes doctor

看到版本号输出且 hermes doctor 无报错即可。如果你是已有 Hermes Agent 的用户，直接进入下一步。

第 2 分钟：申请 SenseNova API Key

  1. 打开 SenseNova Token Plan，注册账号并完成手机号验证。

  2. 进入 控制台 → API Keys，创建一枚 sk- 开头的密钥，复制保存。

  3. 记住以下三个配置值，后面会反复用到：

|
字段
|
值
|
| --- | --- |
| Base URL | https://token.sensenova.cn/v1 |
| API Key |
你刚复制的 sk-...
|
| 模型名 | sensenova-6.7-flash-lite |

免费额度：Token Plan 公测期免费，每 5 小时 1500 次调用（sensenova-6.7-flash-lite 和 sensenova-u1-fast 各自独立计数），对个人使用完全够用。

SenseNova
SenseNova

第 3 分钟：配置 Hermes 对接 SenseNova LLM

Hermes Agent 支持任何 OpenAI 兼容的 API 端点。用 hermes config set 逐条配置是最精确的方式：

hermes config set model.provider custom
hermes config set model.base_url https://token.sensenova.cn/v1
hermes config set model.api_key "<你的 API Key>"
hermes config set model.name sensenova-6.7-flash-lite
hermes config set model.default custom/sensenova-6.7-flash-lite

最后一行是必填项！ 不设置 model.default 时，Hermes 仍会沿用安装时的默认模型（如 anthropic/claude-opus-4.6），对话时会报 HTTP 404: model is not found。

hermes config set 会自动把 API Key 写入 ~/.hermes/.env（安全），其它配置写入 ~/.hermes/config.yaml，无需手动区分。

验证 LLM 通路

hermes

进入交互界面后输入「你好」，能返回中文回答即配置成功。输入 /new 退出对话。

替代方式：使用向导

如果你更喜欢交互式配置：

hermes setup        # 全量向导
# 或
hermes model        # 仅配置 LLM

向导中选择 **Custom (OpenAI-compatible)**，然后依次填入 Base URL、API Key、模型名。

第 4 分钟：安装 hermes-web-ui

hermes-web-ui 是 Hermes Agent 的全功能 Web 管理面板，一条命令安装启动：

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

浏览器自动打开 http://localhost:8648，进入 Web 界面。

如果系统没有 Node.js，可以用一键脚本（自动安装 Node）：

bash <(curl -fsSL https://raw.githubusercontent.com/EKKOLearnAI/hermes-web-ui/main/scripts/setup.sh)

首次登录

首次启动会自动生成认证 Token。查看 Token：

hermes-web-ui status

或在终端输出中找到 Token，输入浏览器登录页即可。

核心功能一览

|
功能
|
说明
|
| --- | --- |
| AI Chat |
实时 SSE 流式对话，多会话管理，Markdown 渲染，工具调用展开
|
| Skills & Memory |
浏览、搜索已安装技能，查看技能详情
|
| Usage Analytics |
Token 用量统计、费用估算、30 天趋势
|
| Platform Channels |
统一配置 Telegram / Discord / Slack / 微信等 8 个平台
|
| Scheduled Jobs |
创建、编辑、暂停 Cron 定时任务
|
| File Browser |
浏览后端文件系统，上传/下载/重命名
|
| Web Terminal |
内置 xterm.js 终端，可直接执行命令
|

hermes-web-ui 界面
hermes-web-ui 界面

架构说明

Browser → BFF (Koa, :8648) → Hermes Gateway (:8642)
                ↓
           Hermes CLI (sessions, logs, version)
                ↓
           ~/.hermes/config.yaml  (通道行为)
           ~/.hermes/auth.json    (凭据池)

hermes-web-ui 启动时自动检测并启动 Hermes Gateway，无需手动管理进程。

第 5 分钟：安装 SenseNova Skills

这是最关键的一步 —— 给 Hermes Agent 装上「画笔」。

方式一：手动克隆安装（推荐，最可控）

git clone https://github.com/OpenSenseNova/SenseNova-Skills.git --depth=1
mkdir -p ~/.hermes/skills
cp -r SenseNova-Skills/skills/* ~/.hermes/skills/

安装完成后，技能目录结构如下：

~/.hermes/skills/
├── sn-image-doctor/       # 环境诊断
├── sn-image-base/         # 生图基础层（Tier 0）
├── sn-infographic/        # 信息图生成（Tier 1）
├── sn-image-imitate/      # 图片风格模仿
├── sn-image-resume/       # 简历图生成
├── sn-ppt-entry/          # PPT 入口
├── sn-ppt-doctor/         # PPT 环境诊断
├── sn-ppt-creative/       # PPT 创意模式
├── sn-ppt-standard/       # PPT 标准模式
├── sn-da-excel-workflow/  # Excel 数据分析
├── sn-deep-research/      # 深度研究
├── sn-search-academic/    # 学术搜索
└── ...                    # 更多技能

方式二：让 Agent 自己装（最省心）

启动 Hermes Agent 后，直接发送：

请从 https://github.com/OpenSenseNova/SenseNova-Skills 克隆仓库，把 skills/ 目录下的所有子目录复制到 ~/.hermes/skills/。完成后列出已安装的 skill 名称。

Agent 会通过自己的 Shell 工具自动完成 git clone + mkdir + cp + 列目录操作。

方式三：一键安装器 Agent Pack（最快）

如果你是全新安装，商汤提供了 Agent Pack 一键安装器，把 Hermes Agent + SenseNova LLM 配置 + Skills 预装全部搞定：

# Linux 一行命令
bash <(curl -fsSL https://raw.githubusercontent.com/OpenSenseNova/agent_pack/main/linux/install.sh)

macOS 和 Windows 可从 GitHub Releases 下载安装包。安装时选 **Custom (OpenAI-compatible)**，填入前面 §2 的三个配置值即可。

注意：Agent Pack 走的是全新安装路线，适合还没装 Hermes Agent 的用户。已有 Hermes Agent 的用户建议用方式一或方式二。

第 6 分钟：配置环境变量与依赖

SenseNova Skills 的生图功能需要额外配置 API Key 环境变量和 Python 依赖。

6.1 配置环境变量

编辑 ~/.hermes/.env，添加以下内容：

SN_BASE_URL="https://token.sensenova.cn/v1"
SN_API_KEY="你的 API Key"

SenseNova Skills 的环境变量有优先级回退机制，设置好 SN_BASE_URL 和 SN_API_KEY 即可满足所有场景：

|
功能
|
优先级回退
|
| --- | --- |
|
图像生成
| SN_IMAGE_GEN_API_KEY
 → SN_API_KEY
|
|
视觉理解
| SN_VISION_API_KEY
 → SN_CHAT_API_KEY → SN_API_KEY
|
|
文本对话
| SN_TEXT_API_KEY
 → SN_CHAT_API_KEY → SN_API_KEY
|

6.2 安装 Python 依赖

生图技能（sn-image-base）依赖 httpx、Pillow、python-dotenv：

pip install -r ~/.hermes/skills/sn-image-base/requirements.txt

依赖内容：

httpx>=0.25.0
pillow>=10.0.0
python-dotenv>=1.0.0

6.3 重启 Hermes Agent

环境变量和技能文件变更后需要重启才能生效：

hermes restart
# 或在 hermes-web-ui 的 Web Terminal 中执行

6.4 运行环境诊断

重启后，在 Hermes 对话中发送：

运行 sn-image-doctor 技能，检查生图环境是否正常。

sn-image-doctor 会自动检查：sn-image-base 安装状态、Python 依赖、环境变量，缺失的会交互式提示你补全。

第 7 分钟：在 hermes-web-ui 中生图实测

所有准备工作就绪，现在打开浏览器访问 http://localhost:8648，开始实测！

测试 1：基础文生图

在 hermes-web-ui 的聊天框中输入：

使用 sn-image-generate 工具，生成一张「韩国女团偶像风格的九宫格」的图片。

Agent 会调用 sn-image-base 的 sn_agent_runner.py 脚本，通过 SenseNova API 生成图片。生成完成后，图片会保存在工作目录中，你可以通过 hermes-web-ui 的 File Browser 面板找到并下载。

文生图测试
文生图测试

测试 2：信息图生成

信息图（Infographic）是 SenseNova Skills 的杀手级功能，内置 87 种布局 / 66 种风格，支持多轮生成与 VLM 质量审核：

使用 sn-infographic 技能，生成一张关于「2025 年全球 AI 产业投资趋势」的信息图。

Agent 会执行完整的生成流水线：自动评估 Prompt 质量 → 选择最优布局/风格 → 调用生图 API → VLM 审核质量 → 如需改进则自动重试。

信息图生成

测试 3：在 Web Terminal 中验证

hermes-web-ui 内置了 Web Terminal，你也可以直接在终端中手动调用：

cd ~/.hermes/skills/sn-image-base/scripts
python sn_agent_runner.py sn-image-generate \
    --prompt "A futuristic city skyline at dusk, cyberpunk style, neon lights reflecting in rain puddles" \
    --aspect-ratio 16:9

生成的图片默认保存到当前工作目录。

进阶：信息图（Infographic）与更多 Skill

sn-infographic 的完整能力

sn-infographic 是 SenseNova Skills 中最令人印象深刻的技能之一，它不只是简单的文生图，而是一个完整的信息图创作流水线：

  • Prompt 自动评分：对用户的描述进行质量评估，不足时自动补充细节

  • 布局与风格智能匹配：87 种布局 × 66 种风格，根据内容主题自动选择最优组合

  • 多轮生成与 VLM 审核：第一轮生成后，内置 VLM（视觉语言模型）会审核图片质量，识别文字模糊、布局拥挤等问题，自动优化重试

  • 质量排名：多轮生成后按清晰度、信息密度、美观度排序，返回最佳结果

推荐用法：直接用自然语言描述你想要的信息图主题和关键数据点，Agent 会自动完成从 Prompt 构造到最终出图的全流程。

更多 Skill 一览

|
类别
|
Skill
|
用途
|
| --- | --- | --- |
|
📊 PPT
| sn-ppt-entry |
输入主题/上传文档，自动生成 PPT（创意模式 / 标准模式）
|
|
📈 数据分析
| sn-da-excel-workflow |
端到端 Excel 分析：多 Sheet 读取、清洗、聚合、导出
|
|
🔬 深度研究
| sn-deep-research |
从问题到报告的全流程：规划 → 证据收集 → 综合研判 → 报告撰写
|
|
🔍 学术搜索
| sn-search-academic |
ArXiv / Semantic Scholar / PubMed / Wikipedia 聚合检索
|
|
🔍 开发者搜索
| sn-search-code |
GitHub / Stack Overflow / HuggingFace 聚合检索
|

常见问题排查

Q1：hermes doctor 报错

按报告逐项修复。最常见的是 Python 版本过低（需 3.11+）或 Node.js 未安装。安装脚本通常会自动处理这些问题，但手动安装可能遗漏。

Q2：LLM 调用 401 / 403

检查 API Key 是否正确：

hermes config get model.api_key

确认 SenseNova 控制台 中 Key 仍在有效额度内。

Q3：生图技能不生效

  1. 确认技能文件已复制到 ~/.hermes/skills/：

    ls ~/.hermes/skills/ | grep sn-image

  2. 确认环境变量已设置：

    grep SN_ ~/.hermes/.env

  3. 确认 Python 依赖已安装：

    pip list | grep -E "httpx|pillow|dotenv"

  4. 重启 Hermes Agent：

    hermes restart

Q4：hermes-web-ui 启动后无法连接 Hermes

hermes-web-ui 启动时会自动检测并启动 Hermes Gateway。如果仍有问题：

hermes-web-ui status          # 查看 Web UI 状态
hermes gateway status         # 查看 Gateway 状态
hermes gateway start          # 手动启动 Gateway

Q5：WSL2 中网络慢/连接超时

检查 WSL2 网络模式：

wsl --status

必要时切换到 mirrored 网络模式或配置代理。

Q6：生成图片中文乱码

sensenova-6.7-flash-lite 默认模型对中文 Prompt 支持良好。如果生成的图片中文显示异常，尝试在 Prompt 中使用英文描述，或使用 sn-text-optimize 工具优化 Prompt。

参考链接

|
名称
|
链接
|
| --- | --- |
|
Hermes Agent 官方仓库
|
https://github.com/NousResearch/hermes-agent
|
|
Hermes Agent 官方文档
|
https://hermes-agent.nousresearch.com/docs/
|
|
hermes-web-ui 仓库
|
https://github.com/EKKOLearnAI/hermes-web-ui
|
|
SenseNova-Skills 仓库
|
https://github.com/OpenSenseNova/SenseNova-Skills
|
|
SenseNova-Skills 安装文档（中文）
|
https://github.com/OpenSenseNova/SenseNova-Skills/blob/main/INSTALL_CN.md
|
|
Agent Pack 一键安装器
|
https://github.com/OpenSenseNova/agent_pack/releases/latest
|
|
SenseNova Token Plan（免费）
|
https://platform.sensenova.cn/token-plan
|
|
SenseNova API 文档
|
https://platform.sensenova.cn/docs
|
|
Agent Skills 开放标准
|
https://agentskills.io
|
|
SenseNova-U1 模型仓库
|
https://github.com/OpenSenseNova/SenseNova-U1
|
|
SenseNova-Studio 在线体验
|
https://unify.light-ai.top/
|

📝 本文所有命令和地址均经实测验证，截至 2026-05-11 有效。 如遇链接失效或命令变更，请以各项目 GitHub 仓库最新 README 为准。

💡 一个人走得快，一群人走得远

如果你也：

  • 想用 AI 提效，但总被幻觉/惰性坑到崩溃

  • 写了配置却难复用，每次换项目都要重来

  • 有实战经验，但缺少地方系统沉淀 & 同行反馈

欢迎来 鸿枫技术栈 聊聊 👋

🔹 官网入口：scale-os.hongmaple.top

🌱 这里是一个「开源共建型」技术社区：

|
你能获得
|
具体内容
|
| --- | --- |
|
📚 知识干货
|
求是方法论 / 反惰性机制 / Harness 工程化 / 实战复盘，每周更新
|
|
🧩 技能生态
|
380+ 技能映射 · 14+ Agent 适配 · 可贡献/可复用/可讨论
|
|
⚙️ 自动化配置
|
3 分钟生成本地配置 · 开源免费 · 无需注册 · 拿来即用
|
|
🤝 同行交流
|
问题答疑 / 经验互换 / 项目协作 / 版本共建，拒绝单机学习
|

🎁 社区专属·免费福利（持续更新）

  • 🔍 AI 编码反模式清单 + 修复方案（可下载）

  • 📋 CLAUDE.md / AGENTS.md 模板库（直接复用）

  • 🧪 真实项目配置案例（含测试/微服务/前端场景）

  • 📊 技能效果评分数据（社区驱动收集，越用越准）

✨ 开源协议：MIT · 完全免费 · 无需注册 · 欢迎提 Issue / PR
💬 如果你也想「让 AI 编码从碰运气变工程」，
欢迎来官网逛逛，期待和你一起成长 🤝

posted @ 2026-05-14 14:26  鸿枫  阅读(4)  评论(0)    收藏  举报