上手入门：安装 Hermes Agent 并开启第一次对话

什么是 Hermes Agent？#

Hermes Agent 是 Nous Research 推出的开源个人 AI 智能体。它运行在你自己的机器上，对接你选择的大模型提供商，通过终端、TUI 或 15+ 消息平台与你交互。本课带你走一遍官方安装流程、最关键的提供商选择，以及 Nous 官方反复强调的「先稳定基础、再叠加能力」的渐进式接入原则。

主要来源：Hermes 官方文档 https://hermes-agent.nousresearch.com/docs/getting-started/quickstart。本课以我们自己的语言总结该页内容，格式对齐 SetupClaw 读者已经熟悉的 OpenClaw 学习中心。权威信息请以上方链接为准。

前置条件#

硬性前置条件：你选择的大模型至少要有 64,000 tokens 的上下文窗口。Hermes 每一轮都要把系统提示、工具、记忆和对话历史全部打包进一次调用里 —— 窗口太小，多步工具调用会直接崩溃。主流托管模型（Claude、GPT、Gemini、Qwen、DeepSeek）都能满足，本地模型需要谨慎挑选。

操作系统支持务实而非大而全：

• Linux 与 macOS 一流支持 —— 安装脚本开箱即用。
• Windows 通过 WSL2 支持。先装好 WSL2，再按 Linux 路径安装。
• Android 可通过 Termux 运行，但有独立的指南和已知限制。

一行命令完成安装#

Nous 提供了一键安装脚本。执行后重新载入 shell，让新二进制进入 PATH：

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
source ~/.zshrc   # 或 source ~/.bashrc

脚本跑完后会有一个 hermes 命令。运行 hermes version 是快速自检 —— 能打印出版本号就说明安装成功。

选择提供商 —— 最关键的一步#

官方文档写得很直白：提供商选择是整个初始化流程中最重要的一步，因为后续每一个功能的质量、延迟和成本都由它继承。运行交互式向导，选一个匹配你当前情况的：

hermes model

• 零摩擦、手上没有凭证：Nous Portal 或 OpenRouter。
• 已有 Claude 或 Codex 订阅：直接用 Anthropic 或 OpenAI。
• 隐私优先 / 内网环境：Ollama 或任意 OpenAI 兼容的本地端点。
• 想要自动跨多家提供商做容错：选 OpenRouter。

Hermes 在设计上把秘密和普通配置分开放。API key 写入 ~/.hermes/.env，其余配置写入 ~/.hermes/config.yaml。运行 hermes config set 时 CLI 会自动把每个值路由到正确的文件 —— 避免 secret 被误提交到 config 仓库。

第一次对话#

用你偏好的界面启动：

hermes          # 经典终端提示符
hermes --tui    # 现代 TUI，支持鼠标和模态窗口

两种模式共享同一份会话、斜杠命令和记忆 —— 你可以自由切换。第一次对话的自检清单：

1. 欢迎横幅会显示你选择的模型和工具集 —— 这是提供商 + 工具都加载成功的证明。
2. 智能体能完整回复一条普通消息，不报错。
3. 让它运行一条终端命令、写一个文件或搜索网页，工具真的触发 —— 看到流式输出。
4. 退出后运行 hermes --continue。如果上一个会话重新出现，说明会话持久化正常。

「渐进式接入」原则#

这是新用户最容易忽略的一条规则，Hermes 文档原话：如果 Hermes 连普通聊天都跑不通，就不要再加功能。不要接 Telegram，不要装技能，不要开语音。先把基础稳下来，再叠加。

合理的接入顺序如下：

1. 在 CLI 里用你选择的提供商跑通普通聊天。
2. 熟悉斜杠命令 —— /help、/tools、/model —— 能自如导航。
3. 掌握 Alt+Enter 多行输入，以及用 hermes --continue 恢复会话。
4. 接入一个消息平台（例如 Telegram），严格配置 GATEWAY_ALLOWED_USERS。
5. 从官方 skills hub 一次装一个技能，不要一口气装十几个。
6. 等上述所有内容都「无聊且稳定」之后，再开语音模式、终端 Docker 沙箱、MCP 服务器。

出问题时的诊断顺序#

感觉哪里不对时不要靠猜 —— 文档给出了一条确定性的序列，把「模糊的故障」推向「已知的稳定态」：

1. hermes doctor —— 校验配置、依赖和 API key。
2. hermes model —— 重新确认提供商可达。
3. hermes setup —— 核选项：重新走一遍全部向导。
4. hermes sessions list —— 确认会话存储完整。
5. hermes gateway status —— 只在你已经接了消息机器人时才用得上。

下一步#

基础稳了之后，下一课带你走一遍 CLI 本身 —— 斜杠命令、会话管理、多行输入和后台任务模式。再之后按你的目标挑着读（消息平台、集成、开发者扩展），不必按顺序走。