🧠
Day 2
7 天入门教程
配置 AI 模型与 Provider
🔑 Day 2
配置模型与 API Key
🎯
今日目标: 发送消息后，Hermes 能调用 LLM 并返回有意义的回答
📑
本节内容
1
理解模型配置方式
2
运行模型向导
3
管理凭证（推荐）
4
在对话中切换模型
5
验证回复质量
6
查看用量
1
理解模型配置方式
Hermes 支持 20+ provider：OpenRouter、Anthropic、OpenAI、DeepSeek、Kimi、Gemini、HuggingFace 等。两种配置方式：
- hermes model（终端命令）：完整的 provider 设置向导，可新增 provider、运行 OAuth、输入 API key
- /model（对话内 slash）：只能在已配置的 provider 之间切换，不能新增
需要新增 provider 时，必须先退出对话（Ctrl+C），在终端运行 hermes model。
2
运行模型向导
terminal
$ hermes model
交互式向导会引导你：
- 选择 provider（OpenRouter、Anthropic、OpenAI 等）
- 输入 API key 或运行 OAuth 登录
- 从 provider 的模型列表中选择默认模型
- 保存到 config.yaml
3
管理凭证（推荐）
API key 有三种管理方式：
- 手动编辑：直接写入
~/.hermes/.env文件，如OPENROUTER_API_KEY=sk-or-v1-xxx - config set：
hermes config set OPENROUTER_API_KEY your-key自动写入配置 - 模型向导：运行
hermes model，交互式引导你输入 API key
terminal
$ hermes config set OPENROUTER_API_KEY sk-or-v1-xxx
✓ Saved to ~/.hermes/.env
需要 OAuth 登录的 provider（如 Anthropic Console）可使用 hermes login，登出用 hermes logout。
4
在对话中切换模型
进入 hermes 对话后，用 /model 切换已配置的模型：
terminal
You: /model
Current: openrouter/anthropic/claude-sonnet-4
Available: claude-sonnet-4, gpt-4.1, deepseek-chat...
You: /model gpt-4.1 --global
Switched to gpt-4.1 (saved to config.yaml)
--global 会将切换持久化到配置文件，否则仅当前会话有效。
5
验证回复质量
发送一条需要推理的消息，确认模型工作正常：
terminal
You: 9.8 和 9.11 哪个大？
Hermes: 9.8 比 9.11 大。因为 9.8 = 9.80，9.11 = 9.11，所以 9.80 > 9.11。
如果回复为空或报错，检查 API key 是否有效、账户余额是否充足。
6
查看用量
terminal
You: /usage
Tokens: 1,234 / Cost: $0.0042 / Duration: 5m 32s
长期用量分析用 hermes insights --days 7。
✅ 你将看到
$ hermes model
? Select provider: OpenRouter
? Enter API key: sk-or-v1-...
? Select model: anthropic/claude-sonnet-4
✓ Saved to ~/.hermes/config.yaml
$ hermes
You: /model
Model: anthropic/claude-sonnet-4
Provider: openrouter
Status: ✓ Connected
You: 9.8 和 9.11 哪个大？
Hermes: 9.8 比 9.11 大...
⚠️ API key 无效
检查 key 是否过期；国产模型需同步修改 base_url；用 hermes config set 重新写入，或检查 ~/.hermes/.env 文件内容是否正确。
⚠️ 回复为空或报错 429
速率限制。换 provider 或在 config.yaml 中设置 fallback_model。
⚠️ /model 只显示 OpenRouter 模型
退出对话，运行 hermes model 添加其他 provider。/model 只能在已配置 provider 间切换。