🔌 Provider 配置指南

12 个主流提供商的接入步骤，含环境变量和免费额度信息

推荐：先用 OpenRouter，一个 key 访问 300+ 模型，无需挨个注册。需要极致性价比用 DeepSeek，需要最强代码能力用 Claude，需要免费额度用 Gemini Flash。

OpenRouter

环境变量: OPENROUTER_API_KEY💡 推荐首选，一个 key 访问 300+ 模型，无需挨个注册

注册送免费额度（约 $1）

1. 注册 https://openrouter.ai
2. 在 Keys 页面创建 API key
3. hermes config set model.provider openrouter
4. 把 key 写入 ~/.hermes/.env：OPENROUTER_API_KEY=sk-or-v1-...

Anthropic (Claude)

环境变量: ANTHROPIC_API_KEY

无免费额度

1. 注册 https://console.anthropic.com
2. 创建 API key
3. hermes config set model.provider anthropic
4. .env 写入：ANTHROPIC_API_KEY=sk-ant-...

DeepSeek

环境变量: DEEPSEEK_API_KEY💡 性价比之王，中文能力强

价格极低，RMB 充值

1. 注册 https://platform.deepseek.com
2. 获取 API key
3. hermes config set model.provider deepseek
4. .env 写入：DEEPSEEK_API_KEY=sk-...

OpenAI

环境变量: OPENAI_API_KEY

新用户有试用额度

1. 注册 https://platform.openai.com
2. 创建 API key
3. hermes config set model.provider openai
4. .env 写入：OPENAI_API_KEY=sk-...

Google Gemini

环境变量: GOOGLE_API_KEY💡 Gemini Flash 免费额度最高，适合批量任务

免费额度充足，Gemini Flash 基本免费

1. 访问 https://aistudio.google.com
2. 创建 API key
3. hermes config set model.provider google
4. .env 写入：GOOGLE_API_KEY=...

xAI (Grok)

环境变量: XAI_API_KEY

每月有免费额度

1. 注册 https://x.ai/api
2. 获取 API key
3. hermes config set model.provider xai
4. .env 写入：XAI_API_KEY=...

GitHub Copilot

环境变量: COPILOT_GITHUB_TOKEN💡 有 Copilot 订阅就能免费用

Copilot 订阅用户可免费使用 API

1. hermes model → 选择 GitHub Copilot
2. 按提示完成 OAuth 设备码流程
3. 注意：gh auth login 的 token 无效，必须走 Hermes 专用 OAuth

Z.AI / GLM (智谱)

环境变量: GLM_API_KEY

新用户送额度

1. 注册 https://open.bigmodel.cn
2. 获取 API key
3. hermes config set model.provider zai
4. .env 写入：GLM_API_KEY=...

Alibaba / DashScope (Qwen)

环境变量: DASHSCOPE_API_KEY💡 通义千问，中文优化

新用户送额度

1. 注册 https://dashscope.aliyun.com
2. 获取 API key
3. hermes config set model.provider dashscope
4. .env 写入：DASHSCOPE_API_KEY=sk-...

MiniMax

环境变量: MINIMAX_API_KEY💡 1M 上下文窗口

新用户送额度

1. 注册 https://platform.minimaxi.com
2. 获取 API key
3. hermes config set model.provider minimax
4. .env 写入：MINIMAX_API_KEY=...

Moonshot / Kimi

环境变量: KIMI_API_KEY

新用户送额度

1. 注册 https://platform.moonshot.cn
2. 获取 API key
3. hermes config set model.provider kimi
4. .env 写入：KIMI_API_KEY=...

Hugging Face

环境变量: HF_TOKEN

免费调用部分模型

1. 注册 https://huggingface.co
2. Settings → Access Tokens 创建
3. hermes config set model.provider huggingface
4. .env 写入：HF_TOKEN=hf_...