§ 快速配置方式
配置模型有两种方式，推荐使用交互式向导：
bash
# 方式一：交互式向导（推荐）
hermes setup model
# 方式二：直接选择模型
hermes model
# 方式三：命令行设置
hermes config set model gpt-4o
配置文件位于 ~/.hermes/config.yaml， 密钥存储在 ~/.hermes/.env。
📊 国内用户推荐选择
性价比首选
智谱 AI glm-4-flash —— 免费额度 + 低价格
中文能力最强
智谱 AI glm-4-plus —— 综合中文能力顶尖
长文档处理
Kimi moonshot-v1-128k —— 128K 上下文
全球顶尖模型
OpenRouter 接入 Claude/GPT-4（需翻墙）
智谱 AI (GLM)
官网 ↗国内最受欢迎的 AI 大模型之一，中文能力出色，API 稳定。
申请步骤
- 访问 open.bigmodel.cn 注册账号
- 在控制台创建 API Key
- 新用户通常有免费额度可用
- 将 API Key 填入 ~/.hermes/.env
环境变量
.env
# 智谱 AI 配置
GLM_API_KEY=your_api_key_here
配置文件
yaml
# config.yaml（推荐用 hermes model 命令配置）
model:
default: "glm-4-plus"
provider: "zhipu"
可用模型：
glm-4-plus ✓ 推荐glm-4 glm-4-flash glm-4-long ✓ 中文理解能力强✓ 价格较低✓ 国内直连，无需翻墙✓ API 稳定可靠
Kimi (Moonshot)
官网 ↗由月之暗面打造，以超长上下文窗口著称，支持 128K token。
申请步骤
- 访问 platform.moonshot.ai 注册账号
- 在 API 管理页面创建 API Key
- 选择合适的模型（推荐 128k 版本）
- 将 API Key 填入 ~/.hermes/.env
环境变量
.env
# Kimi / Moonshot 配置
KIMI_API_KEY=your_api_key_here
配置文件
yaml
# config.yaml（推荐用 hermes model 命令配置）
model:
default: "moonshot-v1-128k"
provider: "kimi"
可用模型：
moonshot-v1-8k moonshot-v1-32k moonshot-v1-128k ✓ 推荐✓ 超长上下文 (128K)✓ 适合处理长文档✓ 国内直连✓ 推理能力强
MiniMax
官网 ↗提供国内版和国际版两种 API，支持多模态。
申请步骤
- 访问 minimax.io 注册账号
- 创建应用并获取 API Key
- 国内用户使用 MINIMAX_CN_API_KEY
- 将 API Key 填入 ~/.hermes/.env
环境变量
.env
# MiniMax 国际版
MINIMAX_API_KEY=your_api_key_here
# MiniMax 国内版（二选一）
MINIMAX_CN_API_KEY=your_cn_api_key_here
配置文件
yaml
# config.yaml（推荐用 hermes model 命令配置）
model:
default: "abab6.5s-chat"
provider: "minimax"
可用模型：
abab6.5s-chat ✓ 推荐abab6.5-chat abab5.5-chat ✓ 多模态支持✓ 国内/国际双版本✓ 性价比高✓ 响应速度快
小米 MiMo
官网 ↗小米推出的 AI 大模型，适合与小米生态联动。
申请步骤
- 访问小米开发者平台注册
- 申请 MiMo API 访问权限
- 获取 API Key
- 将 API Key 填入 ~/.hermes/.env
环境变量
.env
# 小米 MiMo 配置
XIAOMI_API_KEY=your_api_key_here
配置文件
yaml
# config.yaml（推荐用 hermes model 命令配置）
model:
default: "mimo"
provider: "xiaomi"
✓ 小米生态联动✓ 国内直连
OpenRouter
官网 ↗聚合 200+ 模型的统一 API，包括 Claude、GPT-4、Gemini 等顶级模型。
申请步骤
- 访问 openrouter.ai 注册账号
- 充值（支持信用卡）
- 在 Keys 页面创建 API Key
- 将 API Key 填入 ~/.hermes/.env
环境变量
.env
# OpenRouter 配置
OPENROUTER_API_KEY=your_api_key_here
配置文件
yaml
# config.yaml（推荐用 hermes model 命令配置）
model:
default: "anthropic/claude-3.5-sonnet"
provider: "openrouter"
可用模型：
anthropic/claude-3.5-sonnet ✓ 推荐openai/gpt-4o google/gemini-2.5-flash meta-llama/llama-3.1-70b ✓ 200+ 模型可选✓ 一个 Key 访问所有模型✓ 随时切换模型✓ 用量透明
自定义兼容端点
支持任何 OpenAI 兼容的 API 端点，包括本地 Ollama、vLLM、LM Studio 等。
申请步骤
- 确保你的端点兼容 OpenAI Chat Completions API
- 在 config.yaml 中设置 base_url 和模型名
- 如果需要，设置 api_key
配置文件
yaml
# config.yaml - 自定义端点
model:
default: "your-model-name"
provider: "custom"
base_url: "http://localhost:11434/v1" # Ollama 示例
api_key: "ollama" # Ollama 不需要真实 Key
✓ 完全自主可控✓ 支持本地模型✓ 零成本运行✓ 数据不出本地
§ 在对话中切换模型
你可以随时在对话中切换模型，无需重启：
对话中
# 交互式选择模型
/model
# 直接指定模型
/model glm-4-plus
/model moonshot-v1-128k
/model openrouter:anthropic/claude-3.5-sonnet
§ 智能路由（高级）
Hermes Agent 支持智能路由功能，简单问题用便宜模型，复杂问题自动切换到强力模型：
config.yaml
# 智能路由配置
smart_model_routing:
enabled: true
max_simple_chars: 160
cheap_model:
provider: "zhipu"
model: "glm-4-flash" # 简单问题用 flash 版本
# 默认模型处理复杂问题
# 在 model.default 中设置