实战：接入 Google Gemini

这篇教程将手把手教你如何把 Hermes Agent 的“大脑”切换成谷歌的 Gemini 模型，让你用上 Gemini 强大的理解和推理能力。

如果把 Hermes Agent 比作一辆高级跑车，那模型就是它的发动机。默认的发动机可能不错，但 Gemini 这台“涡轮增压引擎”能让你体验推背感。别担心，整个过程不复杂，跟着下面的步骤走就行。

准备工作：拿到“车钥匙”（API 密钥）

首先，你需要一把能启动 Gemini 引擎的“钥匙”——API 密钥。

1. 获取密钥：打开浏览器，访问 aistudio.google.com/apikey，用你的谷歌账号登录，点击“创建 API 密钥”，复制这串字符。
2. （强烈推荐）开启计费：在谷歌云平台为你的项目开启结算功能。因为 Hermes 在对话中可能会多次调用模型，免费额度的“油”太少，跑不了几圈就没了，开启计费才能畅快驾驶。

第 1 步：告诉 Hermes 你的钥匙

打开终端（命令行），执行下面的命令，把刚才的密钥存到 Hermes 的配置里（把 你的密钥 换成你复制的字符）：

echo "GOOGLE_API_KEY=你的密钥" >> ~/.hermes/.env

第 2 步：选择 Gemini 作为“发动机”

现在，运行模型选择命令：

hermes model

这是一个交互式菜单。你只需要：

1. 选择 “More providers…”（更多服务商）。
2. 再选择 “Google AI Studio”。
3. 它会自动检测你的密钥，并显示可用的模型列表。建议选择 gemini-3-flash-preview，这是速度和能力比较平衡的默认推荐。

第 3 步：开始聊天！

搞定！现在启动 Hermes 的聊天界面，直接和 Gemini 对话吧：

hermes chat

进阶技巧：配置文件长什么样？

如果你喜欢直接改配置文件，可以打开 ~/.hermes/config.yaml，核心内容是这样的：

model:
  default: gemini-3-flash-preview  # 你选的模型
  provider: gemini                 # 服务商
  base_url: https://generativelanguage.googleapis.com/v1beta  # 原生接口地址

这里有个关键点：Hermes 默认连接的是 Gemini 的原生接口，而不是那个“兼容版”接口。就好比你直接找厂商买原厂配件，而不是买副厂兼容件，这样功能更稳定，工具调用也更顺畅。

遇到问题怎么办？

• 提示“API key”错误：检查一下 ~/.hermes/.env 文件里 GOOGLE_API_KEY= 后面是不是有正确的密钥。
• 提示“免费额度用尽”：去谷歌云平台开启计费，然后重新运行 hermes model。
• 提示“模型未找到 (404)”：说明这个模型对你不可用，重新运行 hermes model 换一个试试。
• 想中途换模型？ 在聊天界面直接输入 /model gemini-3-pro-preview 就能切换，不用退出。

总结与下篇预告

至此，你已经成功为 Hermes Agent 换上了 Gemini 引擎，可以开始体验了。核心就三步：配密钥、选模型、开聊。如果遇到问题，先运行 hermes doctor 检查一下配置。

下篇预告：发动机换好了，但一辆好车还需要好的仪表盘。下一篇，我们将聊聊如何通过 Hermes Gateway 把 Agent 接入 Telegram 或 Discord，让你在手机聊天窗口里就能指挥它干活，敬请期待！