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