30 分钟先跑通
先领取 Starter 包，跑通一个低风险模板，不急着接消息平台。
- 1领取免费资源包
- 2选日报或 Issue 分类
- 3确认 Provider 与环境变量
- 4CLI 试跑一次
- 5保存验收记录
Resources
Hermes Agent 教程地图
按真实上手顺序整理中文学习路线：先跑通，再接模型、记忆、Skills、消息平台和长期部署。
教程中心
Hermes Agent 中文教程中心
这里按搜索意图组织教程：先解决安装和模型，再看 Skills、Gateway、排错和部署验收。每个入口都指向站内页面，方便搜索引擎理解主题关系。
1 天做出第一个工作流
选择低风险文本任务，跑通输入、模型、输出和日志。
- 1选日报或 Issue 分类
- 2写清输入来源
- 3固定输出格式
- 4先只读运行
- 5观察 10 次再沉淀 Skill
1 周变成 always-on
把本地试验迁到 VPS，并接入消息平台、日志和人工确认。
- 1低权限用户部署
- 2配置环境变量
- 3接入 Gateway
- 4设置重启与日志
- 5高风险动作加确认
学习地图
按阶段整理的中文教程
每一阶段按真实上手顺序组织，先看中文实战，再按你的场景继续深入。
先跑通
免费资源包先跑通
Starter 包 30 分钟使用说明
下载免费资源包后，按目录、模板选择、配置检查和首次验收跑通第一个工作流。
- ✓ 包内目录结构
- ✓ 30 分钟路线
- ✓ 首次验收标准
学习路线先跑通
新手路线：从 0 到第一个可复用自动化
把 30 分钟、1 天、1 周的学习目标拆开，避免一上来就做复杂部署。
- ✓ 最小成功标准
- ✓ 低风险工作流
- ✓ 一周部署节奏
入门清单先跑通
setup 输出验收清单
把 Provider、Memory、Skills、Gateway 四个信号拆成可执行检查项。
- ✓ 一行安装入口
- ✓ hermes model / tools / gateway / doctor
- ✓ CLI 与消息平台入口差异
安装部署先跑通
安装部署教程：Linux、macOS、WSL2
用于补齐安装前置条件、安装布局、PATH、API Key 和 hermes doctor 排错。
- ✓ macOS / Linux / WSL2 前置检查
- ✓ 首次 setup 验收
- ✓ VPS 长期运行 checklist
快速上手先跑通
从首次对话到 always-on setup
适合把 hermes setup 的输出拆成可执行步骤：Provider、Memory、Skills、Gateway。
- ✓ 先跑干净对话
- ✓ 模型上下文至少 64K
- ✓ 先 CLI 再 Gateway
模型接入
模型接入模型接入
AI Providers：OpenRouter、Nous Portal、Ollama 与自托管端点
用于选择模型供应商、配置 API Key，并理解 hermes model 与 /model 的区别。
- ✓ OpenRouter 适合先试
- ✓ 本地模型适合隐私优先
- ✓ 新增 Provider 要先退出会话
成本优化模型接入
Provider Routing：OpenRouter 成本、速度与质量路由
适合进阶配置 OpenRouter 的 provider_routing，用价格、质量或白名单控制请求路由。
- ✓ sort: price 控制成本
- ✓ only / ignore 做白名单黑名单
- ✓ 仅适用于 OpenRouter
模型成本模型接入
OpenRouter 模型选择与成本思路
按任务风险和运行频率选择模型，先跑稳定，再优化成本。
- ✓ 查看模型可用性
- ✓ 对比价格与上下文窗口
- ✓ 适合作为第一阶段试验入口
模型排错模型接入
OpenRouter model not found 排查
模型名、Provider、API Key、会话重启和上下文窗口的逐项检查。
- ✓ 模型名检查
- ✓ 环境变量
- ✓ Gateway 进程重启
记忆与 Skills
记忆设计记忆与 Skills
Persistent Memory：内置 MEMORY.md 与 USER.md
解释 Hermes 如何把偏好、项目规则和环境信息压进持久记忆，并保持上下文可控。
- ✓ 内置记忆有字符预算
- ✓ 记忆在会话启动时加载
- ✓ 高价值事实才值得写入
能力边界记忆与 Skills
Memory vs Skills：什么时候记住事实，什么时候沉淀方法
用实战判断法解释 Memory 和 Skills 的分工，帮助新手避免把所有东西都塞进 Skill。
- ✓ Memory 保存事实
- ✓ Skills 保存方法
- ✓ 先跑稳定再沉淀
进阶记忆记忆与 Skills
Memory Providers：Honcho、Mem0、Hindsight 等外部记忆
适合长期项目、多人使用或需要语义检索时，评估外部记忆提供商是否值得接入。
- ✓ 一次只能启用一个外部 Provider
- ✓ 外部记忆与内置记忆并行
- ✓ 先简单后复杂
Skills记忆与 Skills
Skills System：让 Agent 把经验沉淀成技能
适合学习本地 Skills、Skills 搜索安装、推荐分类和自定义 Skill 写法。
- ✓ Skills 保存做事方法
- ✓ Memory 保存稳定事实
- ✓ 安装后用低风险任务验证
消息平台
消息平台消息平台
Messaging Gateway：Telegram、Discord、Slack、飞书和企业微信
适合把 Hermes 从终端搬到消息平台，并设计允许用户、会话隔离和安全边界。
- ✓ gateway setup 先做交互配置
- ✓ 每个平台会话隔离不同
- ✓ 高权限动作必须人工确认
消息排错消息平台
Gateway 不回复排查清单
Telegram、飞书和企业微信配置后没有回复时，按平台、进程、模型三层定位。
- ✓ Token 与允许用户
- ✓ 进程日志
- ✓ CLI 最小复现
部署运维
部署验收部署运维
部署验收与交付清单
把 Provider、Memory、Skills、Gateway、工作流和日志拆成可交付标准。
- ✓ 交付前逐项验收
- ✓ 写清环境变量和重启方式
- ✓ 高风险动作必须确认
扩展能力
工作流模板扩展能力
每日简报工作流设计
从输入来源、输出字段、验收标准到消息推送，整理最适合入门的自动化场景。
- ✓ 输入字段
- ✓ 输出结构
- ✓ 5 天验收
扩展能力扩展能力
Skills、Web UI 和工具生态怎么选
按真实场景筛选 GUI、Skills、部署工具和记忆增强方案。
- ✓ 先看工作场景
- ✓ 按能力成熟度选择
- ✓ 接入前做低风险验证
最近补充