reference
Reference 参考手册LCP
Reference 是查表入口，适合已经开始使用 Hermes 的用户快速定位命令、配置、环境变量、Profiles、Tools、Skills、MCP、Cron、Gateway、模型 Provider 与部署相关细节。
一句话结论：Reference 模块不是教程，也不是排障页，而是 Hermes 官方 Reference 的中文查表入口。你已经知道自己要查什么时，从这里进。
如果你现在最想先记住一句话，就记这句：
学 Hermes 负责“教你怎么学”，遇到问题负责“帮你定位和排障”，Reference 只负责“查命令、查配置、查工具、查 Skills”。
🔍 Reference 是什么
Reference 的用户，通常已经知道自己要找什么。 他们来这里不是为了重新学习 Hermes，而是为了快速查：
- 终端里的
hermes ...命令 - 对话里的
/xxx命令 - profile 相关命令
- 环境变量和 API Key 名称
- 内置工具和 toolsets
- MCP 配置结构
- 内置 skills 和可选 skills
所以这一模块的边界很硬：
- 不负责安装排障
- 不负责模型报错排障
- 不负责 Gateway / Messaging 排障
- 不负责 Tools / Skills / MCP 不生效排障
- 不负责 OpenClaw 迁移排障
这些统一交给 05-遇到问题。
🧭 先按你要查的东西找入口
说明：06-Reference 中文模块已按你的要求整模块开放。下面这些入口现在都优先走本地中文页；只有需要核对最新细节时，再回官方原文。
| 你现在要查什么 | 中文模块状态 | 先看哪里 |
|---|---|---|
shell 里运行的 hermes ... 命令 | 已开放中文页 | 02-CLI 命令参考 |
对话中输入的 /help、/tools、/model | 已开放中文页 | 03-Slash Commands 参考 |
| profile 创建、切换、导出、导入 | 已开放中文页 | 04-Profile 命令参考 |
| API Key、token、base_url、provider 变量 | 已开放中文页 | 05-环境变量参考 |
| Hermes 内置工具有哪些 | 已开放中文页 | 06-Built-in Tools 参考 |
| toolsets 怎么分、怎么配 | 已开放中文页 | 07-Toolsets 参考 |
| MCP server 怎么写进配置 | 已开放中文页 | 08-MCP 配置参考 |
| Hermes 自带哪些 skills | 已开放中文页 | 09-内置 Skills 目录 |
| 哪些是可选扩展 skills | 已开放中文页 | 10-可选 Skills 目录 |
🚦 如果你现在只想快速查一个东西
直接按当前目标走：
- 我要查 shell 命令 → 02-CLI 命令参考
- 我要查 slash command → 03-Slash Commands 参考
- 我要查 profile → 04-Profile 命令参考
- 我要查环境变量 / Key / provider → 05-环境变量参考
- 我要查 tools / toolsets → 06-Built-in Tools 参考 / 07-Toolsets 参考
- 我要查 MCP → 08-MCP 配置参考
- 我要查 skills → 09-内置 Skills 目录 / 10-可选 Skills 目录
如果你其实不是“查表”，而是“不知道为什么不工作”，直接回 05-遇到问题。
📚 Reference、教程、排障、解决方案的区别
学 Hermes
负责：
- 新手怎么开始
- CLI / Web / 消息入口怎么理解
- 命令和 skills 怎么入门
- profiles / tools / skills 怎么建立认知
Reference
负责：
- 查命令
- 查参数
- 查环境变量
- 查工具
- 查 toolsets
- 查 MCP 配置
- 查 skills 目录
遇到问题
负责：
- 定位问题
- 排查问题
- 按症状分流
- 给 checklist
- 导向官方 FAQ 和 GitHub issues
解决方案 / 场景页
负责：
- 某个工作场景怎么落地
- 推荐入口
- 推荐模型
- 推荐路径
一句话记住：
- 教程：教你怎么学
- Reference：让你查表
- 遇到问题：帮你排障
- 解决方案：告诉你怎么落地
🗂️ 按使用角色看推荐查法
新手最常查
如果你刚开始查表，通常先查这几类：
- 02-CLI 命令参考
- 03-Slash Commands 参考
- 05-环境变量参考
- 不确定问题在哪时，直接回 遇到问题总览
进阶用户最常查
如果你已经开始搭多助手、多环境或系统能力，通常更常查：
做方案 / skills / 系统接入的用户最常查
如果你已经在扩展 Hermes 的能力边界，通常更常查：
🚦 出问题了去哪？
如果你已经不是“查定义”，而是“查为什么不工作”，直接按下面这张导流表走：
| 你现在卡在哪 | 先去哪里 |
|---|---|
| 命令找不到 / 安装异常 | 遇到问题 / 安装 / 更新 / 环境问题 |
| API Key / model / endpoint 报错 | 遇到问题 / 模型 / Provider / 自定义 endpoint 问题 |
| slash command / CLI / session 异常 | 遇到问题 / CLI / TUI / 会话问题 |
| gateway / 平台消息链路不通 | 遇到问题 / Gateway / Messaging / 推送问题 |
| tools / skills / MCP 不生效 | 遇到问题 / Tools / Skills / MCP 问题 |
| 配置改了像没生效 / profile 混乱 | 遇到问题 / 配置 / Profiles / 环境隔离问题 |
| Docker / SSH / 远程 backend 边界不清 | 遇到问题 / Docker / Nix / SSH / 远程后端问题 |
✅ 看完这页你应该能立刻判断什么
看完这一页，你应该能直接回答这 4 个问题：
- 我现在到底是在查表，还是已经进入排障？
- 我现在要查的是命令、配置、工具、MCP，还是 Skills 目录？
- 我应该先看中文排障页，还是直接查官方原文？
- 当前中文 Reference 里，我下一步最该先查哪一页？
➡️ 下一步
完成后进入：
- 如果你现在要查 shell 里的
hermes ...命令，先看 02-CLI 命令参考 - 如果你现在要查 slash commands，先看 03-Slash Commands 参考
如果你想先回到上一阶段入口重新确认位置：
🔗 Reference 相关入口
- 第一次使用 Hermes：先看从这开始，不要直接从参考表硬啃。
- 查命令：看CLI 命令参考和Slash Commands 参考。
- 查 Profiles / Tools / Skills / MCP：分别看Profile 命令参考、Built-in Tools 参考、内置 Skills 目录和MCP 配置参考。
- 配置报错：回到遇到问题，按模型、Gateway、Tools、Profiles 或远程环境分类排查。