Hermes Agent 模型接入
Hermes Agent 接入 Ollama Cloud API 密钥：托管机器人中文教程
在 API 密钥页面保存一次 Ollama 密钥，为 Hermes 机器人选好 Ollama Cloud 模型，就能用自己的 Ollama 套餐聊天。不用改配置文件，也不用填自定义端点。
核对日期：2026 年 10 月 9 日。Ollama 的模型列表和套餐限制会变化，以仪表盘里实时显示的列表为准。
Ollama Cloud 密钥卡片是做什么的？
API 密钥页面有一张 Ollama Cloud API 密钥卡片。保存密钥后，你的 Hermes 机器人就可以直接使用 Ollama Cloud 的模型。请求会从机器人带着你的密钥发到 https://ollama.com/v1，费用由 Ollama 按你的套餐计算。目前只支持 Hermes Agent 机器人。
以前只能通过通用的「自定义 API 提供商」卡片接入。那条路仍然可用，但专用卡片更省事：保存时会验证密钥，会列出 Ollama 当前的模型；更换或移除密钥时，所有正在使用 Ollama Cloud 的 Hermes 机器人也会同步更新。
三步完成接入
- 在 ollama.com/settings/keys 创建 API key。免费的 Ollama 账号就可以开始。
- 打开 openclawlaunch.com/api-keys，找到「Ollama Cloud API 密钥」卡片，粘贴密钥并点击「保存」。卡片会保存密钥，显示 Active 和打码后的密钥预览，并向 Ollama 发送一次极小的测试请求；如果测试未通过，卡片下方会出现提示。
- 在仪表盘打开 Hermes 机器人的模型选择器，在左侧选择 Ollama Cloud，再选一个模型。机器人会在后台重启几秒，之后就通过 Ollama 回复。
卡片里也有一个模型选择器和「设为主模型」按钮。这个按钮会一次性切换你账号下所有正在运行的 Hermes 机器人。如果只想改一个机器人，请在仪表盘上用该机器人自己的模型选择器。
可以选哪些模型？
模型列表实时来自 Ollama，新模型上线后会直接出现。2026 年 10 月 9 日列表中有 18 个文本模型，包括 gpt-oss:120b、gpt-oss:20b、gemma4:31b、glm-5.3、kimi-k2.6、deepseek-v4.1-flash 和 minimax-m2.7。
| Ollama 套餐 | 实测可用的模型 | 需要注意的限制 |
|---|---|---|
| 免费（未购买额度） | gpt-oss:120b、gpt-oss:20b、gemma4:31b、nemotron-3-nano:30b | 入门额度，同一时间只处理 1 个请求 |
| 已购买额度，或 Pro 及以上 | 列表中的全部模型，包括 glm-5.3 和 kimi-k2.6 | 按用量额度计费；Pro 及以上可同时处理更多请求 |
默认预选 gpt-oss:120b，因为它在免费套餐下就能使用。套餐详情见 Ollama 价格页面。
更换或移除密钥
保存新密钥后，所有正在运行、且使用 Ollama Cloud 模型的 Hermes 机器人都会换成新密钥。点击「移除」可以删除密钥；删除后，原本使用 Ollama Cloud 模型的 Hermes 机器人会切回默认模型，重新消耗套餐额度；如果你保存过自己的 OpenRouter 密钥，则使用该密钥。如果没有可用的默认模型，机器人会停止回复，直到你为它选择其他模型。
常见问题排查
- 保存后提示「未能在 Ollama 完成验证」：密钥填错、已被撤销，或当时无法连接 Ollama。先点击「移除」，检查密钥后重新粘贴保存；如果提示仍在，到 ollama.com/settings/keys 新建一个。移除密钥会让 Ollama Cloud 机器人切走模型，保存后请重新选择。
- 某个模型回复付费或额度相关的错误：这个模型需要 Ollama 用量额度。可以换成 gpt-oss:120b，或在 Ollama 账号中购买额度。
- 任务繁忙时回复变慢或失败：免费套餐同一时间只处理一个请求，并行的子任务可能被拖慢或拒绝。付费套餐可以同时处理更多请求。
- 模型选择器里没有 Ollama Cloud：这是 OpenClaw 机器人，或者密钥还没保存。卡片显示 Active 后，Hermes 机器人的选择器里才会出现这一栏。
常见问题
OpenClaw 机器人也能用 Ollama Cloud 密钥吗？
暂时不能。Ollama Cloud 密钥卡片目前只支持 Hermes Agent 机器人。OpenClaw 自带 Ollama 提供商，会自行处理 Ollama 地址，所以托管密钥这条路径还没有接入 OpenClaw。
用 Ollama Cloud 聊天会消耗 OpenClaw Launch 的额度吗？
不会。机器人切换到 Ollama Cloud 模型后，聊天请求会带着你的密钥直接发到 Ollama，用量计入你自己的 Ollama 套餐。
Ollama 免费套餐能用吗？
可以使用 Ollama 的入门模型。2026 年 10 月 9 日实测，免费密钥可以调用 gpt-oss:120b、gpt-oss:20b、gemma4:31b 和 nemotron-3-nano:30b。glm-5.3、kimi-k2.6、deepseek-v4.1-flash 等更大的模型需要 Ollama 用量额度：任何套餐都可以单独购买，Pro 及以上套餐每月自带。
这和自建 Hermes 接入 Ollama Cloud 有什么区别？
调用的模型相同，但托管机器人不需要编辑 config.yaml，也不需要运行 hermes model，仪表盘会替你写好提供商设置。自建流程请看英文版 Hermes Agent + Ollama Cloud 指南。