欢迎来到 U-Hermes 学堂

U-Hermes 马盘的官方中文教程中心。U-Hermes 是基于 Windows 原生 WinUI 3 打造的 AI 智能体桌面应用，内置 20+ 工具、104 个技能、Telegram/Discord/Slack/WhatsApp/Matrix 多平台网关。

⚡ 5 分钟快速上手

U-Hermes 马盘开箱即用，按下面 4 步走一遍，5 分钟内就能和 AI 说上话。

• 01
  插入 U 盘 把 U-Hermes 马盘插到 Windows 10/11 电脑的 USB 口。打开「此电脑」会看到新盘符（一般是 D: / E: / F:），双击进去，可以看到 U-Hermes\ 和 U-Claw\ 两个产品文件夹。
• 02
  双击 Launch U-Hermes.cmd 进入 U-Hermes\ 文件夹，找到 Launch U-Hermes.cmd 双击启动。
  
  ⚠️ 不要直接双击 U-Hermes.exe——.cmd 启动器会自动设环境变量让数据保存到 U 盘，直接跑 .exe 数据可能写到本地。
  
  弹出「Windows 已保护你的电脑」：点「更多信息」→「仍要运行」即可。
  被杀毒软件拦截：在杀毒软件里把 U 盘目录添加到白名单后重试。
• 03
  完成激活（首次启动 / 换电脑时） 首次启动会弹出 Hermes Activation 激活窗口：

  1. 第 1 步：点「复制授权码」按钮，把这段 64 位字符发给商家（微信 hecare888）
  2. 第 2 步：商家回复你激活码（一长串 base64 字符），粘贴到第二个输入框
  3. 点「激活并继续」——窗口自动关闭，进入主界面

  激活码绑定 U 盘硬件指纹（基于 Model + Serial + PNPDeviceID 计算的 SHA256），只对这一根 U 盘有效，不会泄露。
• 04
  开始对话 进入主界面后，左侧菜单点「💬 聊天」，底部输入框打字按回车发送。AI 几秒内开始回复就说明所有环节通了。 默认配的是 虾盘云，新用户有赠送的初始 Token 不用充值就能聊。Token 用完后从「↔ 模型」页或集成页找充值入口。

系统要求

💬 第一次对话

控制台打开后，左侧点「新建对话」，底部输入框打字，回车发送。如果 AI 有回复，配置就成功了。

推荐从这些问题开始

这几个问题能快速验证 AI 是否正常工作，也能让你感受一下它能做什么：

对话中的常用操作

🗺️ 界面总览

U-Hermes 是一个原生 Windows 桌面应用（WinUI 3），左侧 8 个菜单切换不同功能页。

左侧导航 8 个菜单

概览页关键信息

概览页顶部 4 个数字卡片让你一眼看清运行状态：

Dreamer 是什么

概览页中间有 Dreamer 模块——这是 U-Hermes 独有的 背景闲置自我学习系统。AI 在你不和它对话的时候，会回顾过去的会话提取经验，叫"游走（Walks）"。游走结果生成"信号"和"摘要"，主对话时偶尔被召回作为额外上下文。默认是 disabled，需要在配置文件开启。

数据存哪里

所有数据都在 U 盘 U-Hermes\data\ 目录里：

🧭 模型选择指南

不同模型各有擅长，用对了事半功倍。以下是根据实际使用场景整理的选择建议。

场景速查表

一句话记住每个模型

☁️ 虾盘云（内置推荐）

虾盘云是 U-Hermes 官方的 AI API 服务，支持 DeepSeek、通义千问等国内主流模型，无需自己到各家官网申请 API Key，充值后直接用，最省事。

为什么推荐虾盘云？

支持的模型与价格

参考：1 百万 token ≈ 75 万中文字，普通用户每天聊 1-2 小时约消耗 2-5 万 token。

充值步骤

U-Hermes 首次启动会自动写入虾盘云模型配置，并尝试激活初始额度（赠送 token）。额度用完后按以下步骤充值：

• 01
  查看当前状态U-Hermes 左侧点「↔ 模型」，找到名称为 Uclaw Cloud 的模型卡片（顶部带"默认"+"受保护"标签）。卡片显示 https://api.u-claw.org/v1 即虾盘云端点。展开配置可以看到当前 API Key（自动绑定 U 盘指纹生成，不要修改）。
• 02
  访问充值页面用浏览器打开：https://api.u-claw.org/recharge?key=<你的 API Key>
  或在 U-Hermes "概览"页找充值入口（部分版本提供一键打开按钮）。
• 03
  选择金额支付宝付款充值页面选金额（10 / 20 / 50 / 100 / 200 元或自定义），点「支付宝充值」，扫码完成付款。
• 04
  余额到账付款成功后立即到账（一般 < 1 分钟）。回到 U-Hermes "↔ 模型"页面，刷新就能看到新余额。如超过 30 分钟未到账，加微信 hecare888 并发付款截图。

如果你习惯直接用 API Key（开发者方式）

虾盘云兼容 OpenAI API 格式，可以在 ChatBox / Cherry Studio / 任何 OpenAI 客户端里直接接入：

🔵 接入 DeepSeek

深度求索出品，目前综合能力最强的国产大模型之一。API 价格极低（V3 约每百万 token 仅 ¥1），新用户注册有免费额度，非常适合自己申请 Key 直接用。

申请步骤

• 1
  注册账号访问 platform.deepseek.com，用国内手机号注册，无需实名认证，1 分钟完成。
• 2
  领取免费额度新用户注册后系统会自动发放免费额度（具体金额以官网为准，通常够用一段时间）。在「账户余额」页面可以查看。
• 3
  创建 API Key进入「API Keys」→「创建 API Key」，给 Key 起个名字（方便区分用途），复制生成的 Key 保存好——它只显示一次。
• 4
  填入 U-HermesU-Hermes → 设置 → 模型 → 添加供应商，填入以下信息，保存。

两个模型怎么选？

🌙 接入 Kimi

月之暗面出品，最大支持 128K tokens 的超长上下文，是处理长文档的最佳选择。把一整本书、一个完整代码仓库丢给它，都能完整分析，不会截断。

申请步骤

• 1
  注册账号访问 platform.moonshot.cn，手机号注册，新用户有免费额度赠送。
• 2
  创建 API Key进入「API Key 管理」→「新建 API Key」，复制保存。
• 3
  填入 U-Hermes添加供应商，填入以下配置：

☁️ 接入通义千问

阿里云出品，国内访问速度最稳定，免费额度较多，支持图片识别（多模态）。如果你已经在用阿里云生态（钉钉、阿里云盘等），通义千问是最自然的选择。

申请步骤

• 1
  开通阿里云账号访问 dashscope.aliyuncs.com（灵积模型服务），用支付宝或手机号登录/注册阿里云账号。
• 2
  开通 DashScope 服务首次登录会引导你开通服务，免费，新用户有赠送额度。
• 3
  创建 API Key在右上角个人头像 →「API-KEY 管理」→「创建新的 API-KEY」，复制保存。
• 4
  填入 U-Hermes添加供应商，注意 Base URL 格式与其他不同：

💎 接入硅基流动

聚合型 API 平台，一个 Key 可以访问数十个主流开源模型（Qwen、GLM、Llama 等），有多个完全免费的模型，适合预算有限或想测试不同模型的用户。

申请步骤

• 1
  注册账号访问 siliconflow.cn，手机号注册，新用户赠送 ¥14 免费额度。
• 2
  获取 API Key登录后进入「API 密钥」→「新建 API 密钥」，复制保存。
• 3
  填入 U-Hermes添加供应商，填入配置后，在模型名处填写你想用的具体模型。

推荐模型

🌍 国际模型

ChatGPT（GPT-4o）、Claude、Gemini 等国际模型能力很强，但 API 在国内访问受限，需要代理或中转才能用。

国际模型概览

方式一：通过虾盘云中转（推荐）

虾盘云支持部分国际模型的中转服务，不需要你自己配代理，直接填入虾盘云的 Base URL 和 Key 就能用。具体支持哪些国际模型，以 api.u-hermes.org 实际显示的模型列表为准。

方式二：自己申请 + 配代理直连

如果你已有代理环境，也可以直接申请官方 API Key 使用，费率更透明，但需要国际支付方式（信用卡）。

💻 本地模型（Ollama）

使用 Ollama 在本机运行 AI 模型，数据完全不上网，适合处理公司内部文件、个人隐私内容等敏感场景。缺点是需要一定的显卡或内存配置，速度比云端模型慢。

硬件要求参考

安装步骤

填入 U-Hermes

推荐中文模型

🧰 技能库说明

技能（Skill）是 U-Hermes 的能力扩展——每个技能是一个独立功能包，让 AI 从只会聊天变成能真正执行任务。U-Hermes 出厂预装 104 个技能，按分类组织，开箱即用。

技能怎么用

技能是 自动调用 的——你只要正常聊天，AI 会根据问题自动选择合适的 Skill。比如：

• 说"画一个流程图" → AI 调 diagramming 技能生成 Mermaid / SVG
• 说"读这个 PDF 总结一下" → AI 调 pdf-extract 技能解析
• 说"看下我 Apple Notes 里关于会议的笔记" → AI 调 apple-notes 技能查询（仅 macOS）
• 说"训练一个小模型" → AI 调 mlops/training 系列技能给方案

你不需要记住技能名字，AI 会自己挑。但可以在「📚 技能」页面浏览全部 104 个技能，或者关掉不想用的（比如不需要 macOS 相关的可以关掉 apple/ 分类）。

出厂预装的 104 个技能（按分类）

技能从哪里来？

技能按类别分类

🌐 信息获取类

📁 文件与数据类

📬 通讯与协作类

🔌 平台频道类

📦 安装新技能

虾盘预装的技能已够日常使用。如果需要安装社区里的新技能，按以下步骤操作：

方式一：在控制台直接搜索安装（推荐）

• 1
  打开技能面板在 U-Hermes 控制台左侧点击「技能」，进入技能管理页面。
• 2
  搜索技能点击「技能市场」或「搜索」，输入技能名称（英文或中文都可以），找到目标技能。
• 3
  点击安装点击技能卡片上的「安装」按钮，等待下载完成。
• 4
  配置并启用部分技能需要填写 API Key 或其他配置项（技能页面有说明），填完后点击「启用」即可使用。

方式二：从文件安装

在 ClawHub 或 SkillHub 下载到 .zip 格式的技能包后：

• 1
  进入技能管理控制台 → 技能 → 右上角「从文件安装」。
• 2
  选择技能文件选择下载的 .zip 文件，点击确认。U-Hermes 会自动解析并安装。
• 3
  按说明配置阅读技能的 README，根据说明填写所需的 API Key 或配置项。

⏰ 定时任务

定时任务让 AI 按照你设定的时间表自动执行任务，不需要你手动触发。比如：每天早上 8 点总结今日新闻、每周五下午生成工作周报、每小时检查服务器状态……

配置步骤

• 1
  进入定时任务U-Hermes 控制台左侧 → 「定时任务」→「新建任务」。
• 2
  设置触发时间选择执行频率：每天（填写具体时间）、每周（选择星期几+时间）、或填写 Cron 表达式实现精确控制。
• 3
  填写任务内容在「任务提示词」里填写你希望 AI 执行的指令，就像平时发消息给 AI 一样。
• 4
  选择输出方式结果可以发送到：QQ 群、飞书、Telegram、邮件，或保存到笔记。

实用任务示例

🤖 平台接入

U-Hermes 支持 6 个消息平台共用同一网关：Telegram、Discord、Slack、WhatsApp、Matrix、Webhook。配置后 AI 就能在对应平台里收发消息，作为聊天机器人服务。

两种网关分工

通用流程

1. 在对应平台拿到 bot token（详见下面各平台教程）
2. U-Hermes 主界面 → 左侧「👤 集成」
3. 在 Telegram 或 Discord 行的输入框粘贴 token，点"保存"
4. 点"启动原生网关"按钮，状态从橙色"已停止"变成绿色"运行中"
5. 在对应平台给 bot 发消息，AI 就会回复

✈️ Telegram Bot 接入

Telegram 是最容易接入的平台，2 分钟搞定。

1. 创建 Bot（@BotFather）

1. 在 Telegram 搜索 @BotFather，开始对话
2. 发送 /newbot 命令
3. 按提示输入 bot 名字（如 My Hermes Bot）和用户名（必须以 _bot 结尾，如 my_hermes_bot）
4. BotFather 返回一段 token，形如 1234567890:ABCdefGhIJKlmNOPqrstuVWXyz，复制保存

2. 在 U-Hermes 配置

1. 主界面 → 左侧「👤 集成」
2. 找到 Telegram 行，token 输入框粘贴刚才复制的 token
3. 点"保存令牌"
4. 点"启动原生网关"，等几秒变成绿色"运行中"

3. 测试

在 Telegram 找到你刚创建的 bot（搜用户名如 @my_hermes_bot），发送 /start 然后随便问个问题。AI 应该几秒内回复。

🎮 Discord Bot 接入

Discord bot 适合接入游戏社区、开发者群、海外团队。

1. 创建 Application

1. 访问 Discord Developer Portal → 登录
2. 点 New Application，输入名字（如 Hermes Bot）→ Create
3. 左侧 Bot → 在 Token 区点 Reset Token → 确认 → 复制 token（只显示一次！）
4. 开启需要的 Privileged Gateway Intents：Message Content Intent 必须打开

2. 邀请 Bot 到服务器

1. 左侧 OAuth2 → URL Generator
2. Scopes 选 bot
3. Bot Permissions 选 Send Messages + Read Message History
4. 复制底部生成的 URL，浏览器打开 → 选你的服务器 → Authorize

3. 在 U-Hermes 配置

1. 主界面 → 左侧「👤 集成」
2. 找到 Discord 行，粘贴 token，点保存
3. 点"启动原生网关"，等绿灯
4. 在 Discord 服务器@bot 或私聊，AI 会回复

💼 提示词库 · 办公场景

以下提示词可以直接复制使用，把【】里的内容替换成你的实际情况。

📧 邮件撰写

📝 会议纪要整理

📊 工作周报生成

🎯 方案策划框架

💻 提示词库 · 编程场景

用 AI 辅助编程时，给的上下文越具体，回答越准确。以下是经过验证的高效提问方式。

🔍 解释代码

🐛 Debug 排查

✍️ 写单元测试

✍️ 提示词库 · 内容创作

适合写公众号、小红书、短视频文案等内容场景。

📱 小红书爆款笔记

📢 公众号文章

🌱 提示词库 · 日常生活

✈️ 旅行攻略

💊 健康咨询（预筛查用）

🚀 高级提问技巧

掌握这几个技巧，AI 的回答质量会显著提升。

① 给 AI 设定角色

在提问开头加上角色设定，AI 会以该角色的视角和专业度回答。

② 要求结构化输出

明确告诉 AI 你想要什么格式，避免一大段文字难以阅读。

③ 迭代修改，不要重新开始

AI 的第一次回答往往不是最好的，用这些指令持续优化：

④ 追问而不是重问

同一个对话里，AI 会记住上下文。不需要把问题重复一遍，直接追问更高效：

🔀 多模型策略

U-Hermes 支持同时配置多个模型，对话时随时切换。用好这一点，可以大幅提升效果、降低成本。

按任务类型分配模型

实用技巧：两个模型交叉验证

对于重要的判断或分析（比如合同条款、投资决策、技术方案），可以把同一个问题发给两个不同模型，对比它们的答案。两个模型都同意的结论更可靠，有分歧的地方值得重点关注。

成本控制：按用量选模型

🖥️ 服务器部署 / 长期在线

U-Hermes 桌面版本身是 Windows 桌面应用（基于 WinUI 3 + .NET 10），需要 Windows 桌面环境跑，不能直接部署到 Linux VPS。如果你需要让 Telegram / Discord bot 24 小时在线，有两个方案：

方案 1：本地 Windows 一直开机

最简单的方式——把一台 Windows 电脑（或迷你主机）一直开着，U 盘插上、U-Hermes 后台运行。

• 1
  用闲置 Windows 主机或迷你主机NUC、Beelink 等小主机功耗低（5-10W），24 小时电费一年也就几十元。
• 2
  设开机自启把 Launch U-Hermes.cmd 的快捷方式放到 shell:startup（按 Win+R 输入这条命令打开启动文件夹）。开机后 Hermes 会自动启动。
• 3
  关闭 Windows 自动休眠设置 → 系统 → 电源和睡眠 → 屏幕和睡眠都设为"从不"。
• 4
  系统托盘最小化启动后点窗口右上角"最小化"，Hermes 会缩到托盘继续跑后台 agent。

方案 2：开源版 hermes-agent（Linux VPS）

如果你有 Linux 经验，可以装开源的 hermes-agent CLI 到 Linux VPS 上，**功能上等价于 U-Hermes 桌面版的 Agent 部分**（不带桌面 GUI 和 Skills 浏览界面，但聊天、工具调用、Telegram/Discord bot 都可用）：

详细教程见 u-hermes/linux 仓库（开源版）。

🛠️ 故障排查

按问题类型快速定位，点击卡片跳转到对应解答。

❓ 常见问题

遇到问题先看这里，90% 的问题有现成答案。

📞 联系与支持

安装遇到问题、教程看不懂、想定制技能、需要批量授权？随时找我们，通常 24 小时内回复。

联系方式

微信扫码添加

💬

微信hecare888

✈️

Telegram@dsds8848

📧

邮箱hefangsheng@gmail.com

🛍️

购买虾盘淘宝口令 HU293

常见支持场景

反馈问题前，先备好这些信息

能帮我们更快定位问题：