Learning path
先按场景选教程
如果刚开始接触 Hermes Agent，先从 Starter 包使用说明、setup 验收清单、安装教程和 Skills 中文指南看起；已经跑通后，再看模型接入、消息平台和部署运维。
Problem guides
按报错现象找文章
这些入口对应中文用户最常搜的问题，适合从搜索页、短视频评论区或社群答疑直接分享。
安装失败、命令找不到或 setup 卡住
hermes command not found命令找不到、PATH 没生效
Hermes Agent Windows WSL2 安装Windows、Linux、macOS 怎么选安装路线
hermes setup 没有 Provider configuredsetup 输出缺 Provider、Memory 或 Skills 信号
OpenRouter model not foundOpenRouter 报 model not found
OpenRouter 401 / 429API Key 失效、额度不足或限流
Hermes Agent OpenRouter 配置Provider 和模型路由怎么配置
hermes skills installSkills 安装命令和使用顺序
Skills 装完不生效Skill 不触发、搜索不到或输出不稳定
Hermes Agent Memory 不生效Memory 没记住项目规则或偏好
Hermes Agent Gateway 不回复Gateway 不回复或消息平台无响应
Gateway Token / Chat IDToken、允许名单或 Chat ID 配错
Hermes Agent Telegram 不回复Telegram 机器人能收到消息但没有回复
Hermes Agent 飞书 企业微信接入飞书、企业微信接入先做测试群
Memory vs SkillsMemory 和 Skills 到底怎么分工
Hermes Agent 日报工作流怎么跑日报、RSS 摘要或 Issue 分类先跑只读模板
Hermes Agent VPS 部署失败本地能跑，部署到 VPS 后失败
Hermes Agent 成本日志怎么记录模型成本、失败次数和人工修改怎么留痕
Hermes Agent 免费资源包Starter 包怎么领、下载后先看哪里
Categories
按主题继续阅读
Hermes Agent Gateway Token 和 Chat ID 怎么配置：Telegram、飞书、企业微信
消息平台不回复时，先确认 Bot Token、Webhook、允许名单、Chat ID、群 ID、签名密钥和后台进程是否一致。
Hermes Agent 常用命令速查：setup、doctor、model、skills、gateway
整理新手最常用的 Hermes Agent 命令：安装后验收、模型配置、Skills 安装、Gateway 排错和工作流调试。
Hermes Agent Starter 包怎么用：30 分钟跑通第一个工作流
下载免费 Starter 包后，从目录结构、配置文件、模板选择到首次验收，一步步跑通日报、Issue 分类或内容选题。
Hermes Agent 新手路线：从 0 到第一个可复用自动化
按 30 分钟、1 天、1 周拆解 Hermes Agent 学习路线，避免一开始就陷入复杂部署和高风险动作。
Hermes Agent Memory 和 Skills 到底怎么分工：新手实战判断法
用中文场景解释 Memory 保存什么、Skills 保存什么，以及什么时候应该把工作流升级成 Skill。
Hermes Agent OpenRouter 报 model not found 怎么排查
从模型名、Provider、环境变量、会话重启和上下文窗口五个层面排查 OpenRouter 模型不可用问题。
Hermes Agent Gateway 不回复：Telegram、飞书、企业微信排查清单
消息平台已经配置但 Agent 不回复时，按 Token、允许用户、Chat ID、进程日志和模型调用逐项定位。
Hermes Agent 每日简报工作流：输入、输出、验收和优化
把 RSS、任务、Issue、客户消息整理成每日简报时，如何设计输入字段、输出结构和人工检查点。
Hermes Agent 成本记录模板：别等账单爆了才开始统计
为日报、摘要、PR Review、研究整理等工作流建立模型成本记录，帮助判断模型选择是否划算。
OpenRouter Provider Routing：怎么让 Hermes Agent 兼顾成本、速度和质量
解释 provider_routing 的 sort、only、ignore、order 和 data_collection，适合已经用 OpenRouter 跑通后的成本优化。
如何把 Hermes Agent 部署到 VPS 上长期运行
讲清 Hermes Agent VPS 选择、进程守护、日志、环境变量、定时任务和低权限用户的基础部署思路。
Hermes Agent + 飞书 / 企业微信：团队日报自动化
把 Hermes Agent 团队日报、风险提醒和会议跟进推送到飞书或企业微信，并保留测试群、权限和人工确认边界。
Hermes Agent 定时任务：日报、周报、监控和提醒
把 Hermes Agent 固定频率文本工作变成稳定运行的定时任务，并保留日志、失败重试和人工检查点。
Hermes Agent 企业微信接入思路：权限、群聊、日报和客户服务
用企业微信承接 Hermes Agent 通知和低风险工作流时，如何设计权限、群聊、输出格式和人工确认。
Hermes Agent vs Dify / LangChain：工作流、Agent 和应用框架怎么选
比较 Hermes Agent、Dify 和 LangChain 的适用边界，帮助中文用户选择 Agent 工作流路线。
Hermes Agent vs n8n：AI Agent 和传统自动化怎么选
用谨慎视角比较 Hermes Agent 和 n8n 的适用边界，避免绝对化结论。
Hermes Agent Docker 部署：用官方 compose 文件跑通 Gateway 与仪表盘
用官方 Dockerfile 和 docker-compose.yml 部署 Hermes Agent：HERMES_UID 用户映射、~/.hermes 数据持久化、仪表盘 SSH 隧道访问与 s6-overlay 进程监管。
Hermes Agent 安卓 Termux 运行指南：官方安装面、依赖约束与定位
在安卓 Termux 上安装运行 Hermes Agent：官方一键脚本支持、.[termux] 裁剪依赖组与 constraints 锁版、gateway run 前台模式，以及手机作为第二入口的合理定位。
Hermes Agent install.sh 下载失败、卡住、超时怎么办
国内跑官方一键脚本时 install.sh 卡在下载、连 raw.githubusercontent.com 超时、依赖拉取一直转圈,按网络层、脚本层、依赖镜像三段分别定位并稳妥恢复。
hermes update 升级失败、卡住、升级后报错怎么办
运行 hermes update 卡在下载、升级中断、或升级后报缺依赖时,按备份留退路、治网络、补依赖、看日志、必要时回退的次序稳妥恢复,不靠反复重装。
Hermes Agent 接入 OpenRouter：模型选择与成本思路
讲清 Hermes Agent 接入 OpenRouter 后如何按任务选择模型、平衡成本与效果，并记录失败重试和人工修改成本。
Hermes Agent 常见报错与排查清单
从环境、模型 API、权限、消息平台和工作流设计五个层面定位 Hermes Agent 常见报错，并保存可复用排查记录。
Hermes Agent 消息入口 Gateway 安全清单：权限、日志和人工确认
Telegram、Discord、Slack、飞书、企业微信等消息入口怎么设计权限边界和人工确认。
Hermes Agent 是什么？为什么适合做长期工作流
用中文解释 Hermes Agent 的定位、适合场景和不适合场景，帮助你判断是否值得投入。
Hermes Agent 中文安装教程：macOS、Linux 与 WSL2
从零开始，覆盖三大主流环境的依赖安装、Python 版本选择与第一次启动的常见坑。
Hermes Agent + Telegram：远程私人 AI 助理
介绍如何把 Hermes Agent 的输出推送到 Telegram，并设计低风险的远程调用流程。
Hermes Agent 安装失败怎么排查：command not found、PATH、Python 和 API Key
安装 Hermes Agent 后打不开、命令找不到、setup 卡住或 Provider 配置失败时，按终端、PATH、依赖、API Key 和系统路线逐项恢复。
hermes command not found 怎么办：PATH、Shell 和 Windows WSL2 排查
终端提示 hermes: command not found 时，按安装环境、PATH、shell 配置和 Windows WSL2 路径逐步恢复。
Hermes Agent OpenRouter 401 和 429 报错：API Key、额度和限流排查
OpenRouter 返回 401、invalid key、429、rate limit 或 timeout 时，按 API Key、环境变量、额度、模型和触发频率定位。
Hermes Agent Skills 装完不生效：触发条件、会话重启和 Skill 目录排查
安装 Skill 后搜索不到、不会触发或输出不稳定时，按 Skill 名称、目录、When to Use、会话重启和低风险测试排查。
Hermes Agent Windows、Linux、macOS 安装补充：怎么选最稳路线
面向中文用户补充 Windows WSL2、Windows PowerShell Early Beta、Linux、macOS 的安装路线、命令和验收清单。
Hermes setup 输出逐项解释：Provider、Memory、Skills、Gateway 怎么验收
把 hermes setup 看到的 Provider configured、Memory enabled、Skills directory ready 和 Messaging gateway connected 拆成可验证清单。
Hermes Agent Memory 设计：什么时候用内置记忆，什么时候接外部 Provider
用中文解释 MEMORY.md、USER.md、外部 Memory Providers 的边界，避免把记忆当成无限知识库。
Hermes Agent Skills 怎么安装：browse、search、install、update 常用命令
整理 Hermes Agent Skills 的浏览、搜索、安装、会话内安装、更新和安装后验证流程。
Hermes Agent OpenRouter 配置步骤：模型名、路由、限额和成本控制
面向中文用户的 OpenRouter 接入流程，覆盖 API Key、模型名、Provider Routing、限流和成本记录。
Hermes Agent Skills 入门：把重复任务变成可复用技能
Skills 的基本结构、命名约定、调用方式，以及如何让 Agent 自动建议新技能。