Hermes Agent 接入 Kimi：Moonshot 开放平台国内站 Key、Kimi Code 订阅 Key 与模型选择

先弄清你手里是哪种 Kimi Key

Kimi 在 Hermes 里最容易配错的不是选项，而是 Key 的来源。三种 Key 对应三条路：

• Moonshot 开放平台国内站（platform.moonshot.cn）的 API Key：按量计费，走 OpenAI 兼容接口 https://api.moonshot.cn/v1。Hermes 里选 Kimi / Moonshot (China)，环境变量 KIMI_CN_API_KEY。
• Kimi Code 订阅（kimi.com 的编程套餐）的 Key：以 sk-kimi- 开头，只能用在 https://api.kimi.com/coding。Hermes 看到这个前缀会自动改走该端点，并切换到 Anthropic Messages 协议，你不用手动改地址。
• 海外站 platform.moonshot.ai 的 Key：选 Kimi / Moonshot，环境变量 KIMI_API_KEY，端点 https://api.moonshot.ai/v1。

国内站在配置文件里的 Provider ID 是 kimi-coding-cn，别名 kimi-cn、moonshot-cn。海外站是 kimi-coding，别名 kimi、moonshot、kimi-for-coding。三种 Key 互不通用：Kimi Code 的 Key 在开放平台端点不生效，开放平台的 Key 也进不了 Kimi Code 端点。

其他国内 Provider 的选项名和环境变量汇总在 国内安装与使用指南，MiniMax 和智谱 GLM 的配置见 接入 MiniMax 国内站 和 接入智谱 GLM。

申请 Key

按量用户在 platform.moonshot.cn 控制台创建 API Key 并充值；订阅用户在 kimi.com 的 Kimi Code 页面拿 sk-kimi- 开头的 Key。平台菜单会变，以当前界面为准；Key 只粘到 Hermes 里，不要进聊天记录、截图或代码仓库。

配置方式一：hermes model 向导

hermes model
# → 选 "Kimi / Moonshot (China)"
# → 粘贴 platform.moonshot.cn 的 Key，或 sk-kimi- 开头的 Kimi Code Key
# → 模型选 kimi-k2.5 或 kimi-k2.6

和 MiniMax 不同，Moonshot 国内站有模型列表接口，hermes model --refresh 能拉到平台当前开放的型号，列表里没有的新模型先刷新再说。

配置方式二：直接写 .env 和 config.yaml

echo 'KIMI_CN_API_KEY=你的Key' >> ~/.hermes/.env
hermes config set model.provider kimi-coding-cn
hermes config set model.default kimi-k2.5

• ~/.hermes/.env 的优先级高于 shell 里 export 的同名变量，重启后以文件为准。
• 不要手动把 base URL 指到 api.kimi.com/coding/v1。Anthropic SDK 会自己在后面加 /v1/messages，多出来的 /v1 会导致 404；Hermes 自动改写用的是不带 /v1 的地址。国内站选项没有单独的 base URL 覆盖变量，一般也不需要。
• 只想临时试一次，用 hermes chat --provider kimi-coding-cn --model kimi-k2.5，这是官方文档的示例写法。

验收：三条命令确认链路

hermes doctor
hermes -z "用一句话确认你能正常回复"
hermes gateway restart

hermes doctor 会用 KIMI_CN_API_KEY 探一次 api.moonshot.cn 的模型列表；Kimi Code 的 Key 则探 api.kimi.com/coding/v1 下的列表。hermes -z 跑一句短问答能回复，就说明 Key、端点和模型名都对。Gateway 已经在跑的话，最后一条让它重新加载 Key。

选哪个模型

• kimi-k2.5、kimi-k2.6：新旧版本 Hermes 的列表都有，k2.5 是官方文档示例，k2.6 更新，先用其中一个跑通。
• kimi-k2-thinking：长推理型号，适合需求拆解和研究综述；kimi-k2-turbo-preview：快，适合高频短任务。
• kimi-k3：只在较新版本 Hermes 的目录里，hermes update 之后出现，Hermes 按 100 万 token 记录它的上下文。
• kimi-k2.7-code、kimi-k2.7-code-highspeed：带 code 的型号面向 Kimi Code 订阅，按量 Key 能不能用以平台为准。

其余 Kimi 型号 Hermes 默认按 262,144 记录上下文，并且会无视平台偶尔上报的 32K 旧值。价格方面，Hermes 内置的计价表里没有 Moonshot 官方价目，用量统计不会显示费用，成本要自己从控制台抄到 成本记录模板 里。

常见报错

1. 401：Key 的来源和选项不匹配。海外站 Key 选了国内站、开放平台 Key 想走 Kimi Code 端点，都会 401。先对照上面三条路确认，再用 grep KIMI ~/.hermes/.env 看 Key 是否真的在文件里。
2. Kimi Code 下 404 Not Found：多半是手动设过带 /v1 的 base URL。删掉覆盖，让 Hermes 按 Key 前缀自动处理。
3. 模型列表里没有新型号：hermes model --refresh 重拉平台列表；刷新后还没有，说明 Hermes 版本旧，hermes update。
4. 上下文被截得很短：Hermes 对 Kimi 系列有 32K 低报保护，正常不会出现；如果仍然异常，先 hermes update。
5. CLI 正常、群里还是旧模型：hermes gateway restart。

更多排查思路见 Hermes Agent 故障排查清单。

顺手：把 Kimi 设成兜底模型

kimi-coding-cn 在上游 fallback_model 的官方支持列表里。主模型遇到 429、503、529 或连接失败时自动切过来：

fallback_model:
  provider: kimi-coding-cn
  model: kimi-k2.5

核对说明

本文的选项名、环境变量、端点、sk-kimi- 前缀改写规则、模型目录和上下文数值对照上游 v2026.9.24（v0.21.5）的 hermes_cli/auth.py、auth_zai_kimi.py、providers.py、models_catalog_static.py、doctor_connectivity.py、agent/model_metadata.py 和官方 Providers 文档核对，命令参数在本地 v0.15.1 验证过。编辑组没有用 Moonshot 账号做真实计费测试，价格和套餐内容以你的控制台为准。

下一步

国内 Provider 还有 小米 MiMo 可选。链路通了以后按 setup 输出验收清单 把 Memory、Skills 和 Gateway 逐项过一遍，再回到 模型接入指南 看按任务分层选模型的思路。

还没有真实场景？可以先领取 Free Starter 模板包，从低风险只读任务开始试跑。