01
先读中文指南
先判断 Hermes Agent 是否适合你的长期工作流，弄清 Provider、Memory、Skills、Gateway 各自负责什么。
阅读 Hermes Agent 中文指南实测路线 · 安装排错 · Provider · Skills · Gateway
Hermes Agent
中文指南：先跑通再扩展
面向中文用户整理 Hermes Agent 安装部署、OpenRouter 配置、Memory、Skills、Gateway 和常见报错。先按实测路线跑通环境，再选择低风险工作流长期运行。
刚从短视频过来？先看 10 分钟站内路线
先判断场景、安装路线和 Provider，再决定是否复制模板或接消息平台。
新手用户适合开发者自动化从业者企业团队
28+
中文教程
16
核心审核页
5 类
Skills 分类
持续
内容更新
setup 结尾输出（节选）● 可复现命令● 只读模板
~/hermes-agent — zsh
文件位置~/.hermes/
Settingsconfig.yaml
API Keys.env
Datasessions/
$
第一次试跑路径30 min
01打开 Starter 包 README✓
02复制 workflows/daily-brief.md
03保存 outputs/first-run.md·
// 推荐路径
先按路线跑通，再扩展到团队场景
首页只放最短实测路径：先判断能不能用，再安装验收、跑模板、看 Skills 和 Gateway 边界。
02
按安装主线验收
先按系统路线跑通 CLI、Provider、doctor 和 setup，保存关键输出，再考虑 VPS 或消息入口。
打开安装部署主线03
跑一个低风险模板
只选日报、Issue 分类或资料摘要这类只读任务，连续跑几次，确认输出格式和失败日志稳定。
查看低风险工作流04
再沉淀 Skills 和 Gateway
等流程稳定后，再把重复步骤做成 Skill，并把低风险结果推送到 Telegram、飞书或企业微信。
理解 Skills 边界- 10 min
判断是否适合
先读入门页，确认你要自动化的是长期工作流，而不是一次性问答。
知道哪些任务可以交给 Agent，哪些必须人工确认
- 30 min
跑通最小环境
用官方安装脚本装好（只需提前装 Git），跑 hermes setup 配好模型，并保存结尾的输出。
hermes doctor 没有报错，一句短问答能在 20 秒内回复
- 1 day
复制第一个模板
先选日报、RSS 摘要或 Issue 分类这类低风险任务，固定输入和输出格式。
连续跑 3 次，输出稳定且能被人工快速检查
- 1 week
接入和维护
再接 VPS、消息平台、日志和 Skills，把反复使用的流程固定下来。
每天自动推送，失败能定位，团队知道怎么验收
EP 07Memory / Skills
Memory 和 Skills
Memory 负责长期记忆，Skills 负责可复用能力。判断什么时候保存偏好，什么时候沉淀流程。
EP 08Skills
安装 Skill 命令
整理 hermes skills browse、search、install、/skills install 和 update 的使用顺序。
EP 09工作流
第一个工作流
第一个 Hermes Agent 工作流优先选择只读或草稿型任务，例如每日简报、RSS 摘要、Issue 分类或客服草稿。
EP 10团队实践
小团队试点
企业和小团队不要一开始自动改系统，先做只读日报、风险提醒、客户邮件草稿和人工确认。
Windows 用户先选定一条路线
常见情况：原生 Windows 和 WSL2 都已正式支持，但两边的安装目录和配置是分开的，来回切最容易出问题。
先这样做：新手直接用官方 PowerShell 一行命令或 Hermes Desktop 安装包；需要完整 Linux 环境再选 WSL2。选定一条就别混用。
OpenRouter 报错先换短问答
常见情况：很多人一上来就跑长报告，报错后分不清是模型、Key、上下文还是模板问题。
先这样做：先用同一个模型完成一句短问答，再跑 daily-brief.md。这样排查范围小得多。
Skill 不急着自己写
常见情况：第一天就写 Skill，往往会把没跑稳的流程固定下来。
先这样做：先复制 Starter 模板跑 3 次。输出字段稳定后，再把步骤写进 SKILL.md。
新手最常问
遇到报错，先按关键词进入对应教程
首页把高频搜索词前置：安装失败、command not found、OpenRouter 报错、Skills 不生效和 Gateway 不回复，都能直接进入排查页。
打开常见问题排查Hermes Agent 安装失败
安装失败、命令找不到或 setup 卡住
先确认终端、PATH、Git、curl、Python、Node 和系统路线，再检查 Provider。
hermes command not found
命令找不到、PATH 没生效
确认安装环境、shell 配置、PATH 和 WSL2 / PowerShell 是否混用。
Hermes Agent Windows WSL2 安装
Windows、Linux、macOS 怎么选安装路线
先确认 Git 可用、装完重新加载了 shell；Windows 上别把原生安装和 WSL2 混用。
hermes setup 提示 No inference provider is configured
setup 跑完了，但模型还不能用
setup 结尾出现 No inference provider is configured，或 Tool Availability Summary 里一片 ✗ 时，先分清哪些是必须修的。
OpenRouter model not found
OpenRouter 报 model not found
从模型名、Provider、API Key、环境变量和会话重启逐项排查。
OpenRouter 401 / 429
API Key 失效、额度不足或限流
401 先查 Key 和 Provider，429 先查额度、限速和工作流触发频率。
Hermes Agent OpenRouter 配置
Provider 和模型路由怎么配置
先用一个确认可用的模型跑短问答，再处理路由、备用模型和工作流模板。
hermes skills install
Skills 安装命令和使用顺序
先 browse 和 search，再 install；会话内安装用 /skills install，后续用 update。
上手前先分清
Provider、Memory、Skills、Workflow 各管一件事
很多问题不是 Prompt 写得不够长，而是模型入口、记忆、Skill 和运行方式混在了一起。先拆开，后面排错会轻很多。
阅读 Harness 中文指南// 01 · 为什么
为什么值得关注 Hermes Agent
重点不在某一次回答，而在能不能围绕项目长期运行、保留状态、复用流程，并接入真实工作入口。
每天 9 点自动发日报
固定读取 RSS、邮箱、团队消息和任务状态，整理成中文简报后推送到 Telegram、飞书或企业微信。
记住项目上下文
把客户偏好、项目规则、历史任务写进记忆，下次生成周报、回复草稿或风险提醒时不用重新解释一遍。
重复任务变成 Skills
把 Issue 分类、竞品监控、客服 FAQ 更新这类流程做成可复用技能，后续项目直接套用。
消息平台随时调用
适合 Telegram、Slack、Discord、飞书、企业微信等远程工作场景，把 Agent 输出送到团队已经在看的地方。
客户邮件先出草稿
让 Agent 先分类、提取诉求、写回复草稿，高风险内容保留人工确认，适合销售、客服和运营团队。
适合整理成模板
把部署文档、排错清单和场景说明整理成可复用资料，减少每个新项目从零摸索的时间。
// 01b · 快速对比
与其他方案的轻量对比
表格只服务于选型判断：长期运行、持久记忆、Skills、消息入口和学习成本，按你的真实场景取舍。
能力
Hermes Agent
ChatGPT Projects
n8n
长期运行于服务器
原生适合
不适合
支持
持久记忆 / 上下文
项目级积累
项目内
需自接
Skills / 可复用技能
适合复用
有限
Workflow 模板
消息平台接入
适合接入
有限
节点支持
学习成本
中等
低
中等偏高
// 02 · 你能得到
你可以在这里得到什么
先把教程站做好：新手能照着走，开发者能复制模板，企业团队能参考低风险上线方式。
01 / 新手上手
中文教程
从是什么、安装部署、模型接入到排错验收，按真实上手顺序整理。
Hermes Agent 中文教程02 / 开发复用
工作流模板
Starter 包和站内模板用于快速上手，先复制一个低风险工作流跑起来。
Hermes Agent 工作流模板03 / 团队参考
企业实践
整理消息平台、权限边界、人工确认和低风险上线案例，帮助团队稳妥试点。
Hermes Agent 企业实践案例// 02a · 用户反馈
典型用户反馈
基于常见使用场景整理的反馈，用来说明 Hermes Agent 更适合解决哪些真实工作问题。
减少信息切换
“最有用的是把每天要看的信息压成几条重点。我不用在邮件、RSS 和仓库通知里来回切，早上先看 Hermes 整理的简报，再决定今天处理什么。”
之前：每天早上分散查看 RSS、邮箱和仓库通知。
之后：简报稳定后再接 Issue 分类，人工只看需要处理的项。
独立开发者
每日简报 + GitHub Issue 分类
交付更清楚
“模板包省时间的地方不在 Prompt，而是输入、输出、验收和排错都写好了。客户不需要理解 Agent 细节，也能知道交付物怎么检查。”
之前：客户能听懂自动化想法，但不知道怎么验收。
之后：交付文档按工作流、配置、日志和人工确认拆开。
自动化顾问
模板包 + 客户交付
低风险上线
“我们先只做只读日报，不让 Agent 改系统。每天把阻塞、负责人和下一步推到群里，团队接受度比直接上复杂自动化高很多。”
之前：团队状态散在群聊、任务系统和会议纪要里。
之后：先在测试群跑一周，再进入正式团队频道。
小团队负责人
飞书日报 + 风险提醒
选题更稳定
“以前选题靠临时灵感，现在每周先让它整理热点、历史内容和素材需求。最后还是人工判断，但初稿速度快了不少。”
之前：选题依赖临时灵感，素材整理经常断档。
之后：每周固定整理 10 个选题，人工筛掉不适合的。
内容运营
选题池 + 素材摘要
知识库更好维护
“客服对话里重复问题很多，先让 Hermes 归纳新增 FAQ 和回复草稿，再由人工确认。这样比手工翻聊天记录轻松多了。”
之前：重复问题藏在大量聊天记录里，更新知识库靠人工翻。
之后：每周汇总新增 FAQ，外发回复仍保留人工确认。
客服负责人
FAQ 更新 + 回复草稿
Review 更聚焦
“PR 变大时，先看一份改动摘要和风险清单很有帮助。它不会替代 Review，但能提醒我优先看鉴权、回调和边界处理。”
之前：大 PR 先看哪里，经常靠 Review 人自己判断。
之后：先读风险清单，再进入关键文件和测试建议。
团队工程师
PR 摘要 + 代码风险提示
维护承诺
让教程站先变得可靠
这个站点当前主推教程和资源包。商业服务只是补充，重点还是让中文用户能搜索到、看得懂、照着走。
教程优先
优先做可搜索、可复用、能照着操作的中文教程，弱化销售导向。
低风险默认
所有模板先按只读、草稿和人工确认设计，不鼓励直接接高权限生产动作。
固定更新
围绕安装、模型、Memory、Skills、Gateway 和工作流持续补充排错记录，并在首页展示更新。
站内闭环
教程入口尽量留在站内，减少来回切换，让新手能按顺序读完一条路线。
// 02b · 最近更新
这个站点会持续补教程和排错
这里固定展示最近补充的教程、资源和排错内容，方便你判断哪些页面值得先看。
2026-10-07教程
新增 Hermes Desktop 桌面版中文指南
整理官方桌面应用的两种装法、如何切换简体中文界面、国内网络下 Electron 下载和更新检查的注意点，以及桌面版、命令行和网页控制台各适合什么场景。
查看更新2026-10-07内容
安装、国内使用和模型接入页更新到 v0.21.5
原生 Windows 已正式支持、Intel Mac 不再支持、官方安装地址换新域名；国内 Provider 扩到 8 家并写明每家该选的选项和环境变量；删掉从未存在的 setup「四个信号」输出，首页终端动画改为真实输出节选；修正 Key 排查、配对码、记忆隔离、Webhook 等一批说法。
查看更新2026-10-05内容
对照 Hermes Agent v0.21.5 修正失效命令
逐条对照上游 v0.21.5 源码，修正 7 处照做会报错的命令：hermes model list/set、hermes gateway logs、已删除的 hermes postinstall 和 hermes version、把 hermes import 当升级回退、已合并的 github 技能名、hermes cron create 的参数。升级排错文章按新版重写，第 4、5 期视频加了勘误。
查看更新2026-06-01内容
补强自动化案例页可信度
8 个场景案例页新增内容维护、最后更新时间和反馈入口，并补充页面更新时间结构化数据，减少案例页像模板页面的风险。
查看更新// 02c · 教程地图
按真实上手顺序整理的教程资源
从安装、OpenRouter、Memory、Skills 到消息入口，把上手路径整理成可执行路线。
推荐学习路径
新手安装
Hermes Agent 中文实战课
按 8 个模块和 6 个项目，把安装、模型、Memory、Skills、Gateway、工作流和长期运行串起来。
新手安装
Starter 包 30 分钟使用说明
下载免费资源包后，按目录、模板选择、配置检查和首次验收跑通第一个工作流。
新手安装
新手路线：从 0 到第一个可复用自动化
把 30 分钟、1 天、1 周的学习目标拆开，避免一上来就做复杂部署。
新手安装
setup 输出验收清单
setup 之后的四步验收：doctor、status、一次短问答、gateway status。
新手安装
安装部署教程：Linux、macOS、WSL2
用于补齐安装前置条件、安装布局、PATH、API Key 和 hermes doctor 排错。
新手安装
从首次对话到长期运行
从 hermes setup 配好模型，到第一次短问答、接消息平台和长期运行。
// 03 · 精选工作流
适合入门的免费工作流模板
个人效率● 免费新手
每日信息简报
聚合 RSS、邮件、Slack 的关键信息，每天早上整理成可读简报推送到你的消息平台。
Prompt 片段你是我的每日信息助理。请读取过去 24 小时的 RSS、邮件和团队消息，按主题分组，保留最多 5 条最重要信息。每条包含：标题、来源、为什么重要、建议动作。输出中文 Markdown，不要编造...
~ 30 min 配置复制模板
团队管理● 免费新手
团队周报自动生成
从 Git、Jira、飞书会议纪要中提取周成果、风险阻塞和下周计划，按角色生成结构化周报草稿。
Prompt 片段请根据本周提交、Issue、任务状态和会议纪要，生成团队周报草稿。按成员分组列出完成事项、进展证据、阻塞风险和下周建议。语气客观，不夸大成果。...
~ 45 min 配置复制模板
程序员● 免费进阶
GitHub Issue 分类与优先级判断
自动给新 Issue 打标签、判断优先级、生成回复模板，并把高优先级问题推送到群里。
Prompt 片段你是开源项目维护助理。请阅读新 Issue 的标题、正文、复现步骤和环境信息，输出 JSON：labels、priority、need_more_info、reply_draft。不要直接关闭...
~ 40 min 配置复制模板
内容运营● 免费新手
内容选题生成器
读取热点、关键词和历史内容表现，生成适合公众号、视频或 Newsletter 的选题池。
Prompt 片段你是 AI 自动化内容策划。请根据输入的热点、关键词和历史内容表现，生成 10 个中文选题。每个选题包含：标题、目标读者、独特角度、素材来源、预计难度。...
~ 35 min 配置复制模板
研究分析● 免费新手
行业 Newsletter 摘要
自动阅读多封行业 Newsletter，提取共同趋势、重要链接和可行动观点，整理成适合团队阅读的周摘要。
Prompt 片段请把本周 Newsletter 内容压缩成一份中文摘要。优先保留被多个来源提到的趋势，标注来源，不输出营销口号。最后给出 3 个值得深入研究的问题。...
~ 30 min 配置复制模板
团队管理● 免费新手
会议纪要与跟进提醒
把会议记录整理成背景、决策、待办、负责人、截止日期和风险，并在到期前形成跟进提醒。
Prompt 片段请根据会议记录生成纪要。必须分为：背景、决策、待办、负责人、截止日期、风险。无法判断负责人或截止日期时标记为待确认。...
~ 35 min 配置复制模板
// 05 · 最新教程
最近的中文实战文章
⌘ api
模型接入·2026-10-08·9 分钟阅读
Hermes Agent 接入 MiniMax 国内站：Key 申请、MiniMax (China) 选项与 M2.7 验收
国内账号怎么把 MiniMax 接进 Hermes Agent：分清 minimax.io 和 minimaxi.com，选 MiniMax (China)、写 MINIMAX_CN_API_KEY、用 M2.7 跑通验收，以及 401、模型名、think 标签等常见报错。对照上游 v0.21.5 核对。
⌘ api
模型接入·2026-10-08·10 分钟阅读
Hermes Agent 接入智谱 GLM：GLM_API_KEY、国内端点自动探测、Coding Plan 与模型选择
智谱 GLM 在 Hermes Agent 里只有 Z.AI / GLM 一个选项，Hermes 会在海外、国内和 Coding Plan 四个端点间自动探测。本文讲 GLM_API_KEY 怎么配、探测缓存在哪、GLM_BASE_URL 何时要设、glm-5 等模型怎么选，以及 Insufficient balance 怎么排。
⌘ api
模型接入·2026-10-08·9 分钟阅读
Hermes Agent 接入 Kimi：Moonshot 开放平台国内站 Key、Kimi Code 订阅 Key 与模型选择
Kimi 接入 Hermes Agent 的关键是分清三种 Key：Moonshot 国内站的 KIMI_CN_API_KEY、sk-kimi- 开头的 Kimi Code Key、海外站的 KIMI_API_KEY。本文讲选项怎么选、Kimi Code 端点的自动改写、kimi-k2.5 怎么挑，以及 401、404 怎么排。
⌘ api
模型接入·2026-10-08·7 分钟阅读
Hermes Agent 接入小米 MiMo：XIAOMI_API_KEY 配置、mimo-v2.5-pro 模型选择与验收
小米 MiMo 是 Hermes Agent 上游官方支持的国内 Provider。本文讲 Xiaomi MiMo 选项、XIAOMI_API_KEY 怎么写进 .env、mimo-v2.5-pro 和 mimo-v2-flash 怎么选、三条命令验收，以及 401、model not found 排查和兜底写法。
// guide
故障排查·更新 2026-10-07·9 分钟阅读
Hermes Agent 安装失败怎么排查：command not found、PATH、Python 和 API Key
安装 Hermes Agent 后打不开、命令找不到、setup 卡住或 Provider 配置失败时，按终端、PATH、依赖、API Key 和系统路线逐项恢复。
// guide
故障排查·更新 2026-10-07·7 分钟阅读
bash: hermes: command not found 怎么办：PATH、Shell 和 Windows 排查
终端提示 hermes: command not found 时，按安装环境、PATH、shell 配置和 Windows WSL2 路径逐步恢复。
不知道下一篇读什么？
按你现在的阶段选入口，比从文章列表里乱翻更快。
// 06 · Starter 包
先用免费资源包跑通第一个场景
包含 3 个入门工作流、Skills 示例和部署检查清单，夸克 / 百度网盘都可以直接下载。
// 07 · 常见问题
你可能会问
我没有 VPS 也能用 Hermes Agent 吗？+
可以。macOS（仅 Apple Silicon）、Linux、原生 Windows 10/11 和 WSL2 都能跑，Intel Mac 不在官方支持范围内。VPS 只是为了 7×24 长期运行定时任务，建议先在本地跑通，再考虑上云。
安装前需要准备什么？+
官方前置条件只有 Git（Linux 另需 curl 和 xz-utils），Python、Node.js 由安装脚本自动安装。再准备一个模型 Provider：国内 Provider 的 API Key，或用 Nous Portal 浏览器登录。部署到 VPS 时还需要 SSH 权限和基础安全配置。
必须使用 OpenRouter 吗？+
不必须。OpenRouter 的优点是模型选择多、切换方便。你也可以选择 OpenAI 或其他兼容接口，关键是为不同任务设置合适的模型与预算。
使用 Hermes Agent 的模型 API 一个月大概多少钱？+
取决于模型和调用频率。个人跑 3-5 个常规工作流，大致可能在 ¥30-150；团队频繁运行可能更高。本站不销售任何模型 API。
能接 Telegram、Slack、飞书或企业微信吗？+
可以作为工作流目标，但具体可用性取决于你的机器人权限、消息平台 API 和部署网络环境。模板里会给出通用接入清单。
Skills 和 Prompt 模板有什么区别？+
Prompt 更像一次任务说明；Skills 更像可复用的工具说明、文件结构和执行约定。重复任务建议沉淀成 Skill，方便团队长期维护。
先用免费 Starter 包跑通一个真实场景
拿到 3 个入门工作流、1 个 Skills 示例和部署检查清单后，按 30 分钟路线完成第一次稳定输出。