建议收藏，用到时照着做。Kimi K3 接进 Hermes Agent 要改配置文件？官方文档说了：密钥绝不能写进 config.yaml，而且还能让它看懂… · @swordBluesy · TwKit

@swordBluesy

建议收藏，用到时照着做。Kimi K3 接进 Hermes Agent 要改配置文件？官方文档说了：密钥绝不能写进 config.yaml，而且还能让它看懂视频 这是 Kimi 开放平台官方文档里的《Use Kimi K3 in Hermes Agent》一页，官方写明截图基于 Hermes Agent v0.18.2。先说结论：一共四步，hermes model 选 Kimi 并粘贴密钥，hermes config edit 贴一段配置，hermes tools enable video 开视频工具，最后输入 hermes 启动。最容易踩的坑：密钥只能走提示框输入，不能写进配置文件。 先说清词。 Hermes Agent，是 Nous Research 做的开源 AI 智能体，自带持久记忆和工具调用，可以在命令行、Telegram、Discord、Slack、WhatsApp 里用。 API 密钥（API key），是你在 Kimi 开放平台生成的一串口令，要保密。 上下文窗口，是模型一次能记住的文字量，官方写 kimi-k3 是 100 万 token。 base_url，是调用模型的接口地址，这里官方要求只填 http://api.moonshot.ai 后面加 /v1。 先把话说全： 官方说这份指南用国际版 Kimi 开放平台的密钥，不要换成别的 Kimi 服务或别的地区的密钥。 官方说菜单文字可能随 Hermes 版本变化。 调用 API 需要账户有可用余额；公司如果设了 IP 白名单，要把调用 API 那台电脑的公网 IPv4 加进去。 官方页面没有写 K3 的单价，以官网价格页为准。 一、动手前准备三样 第一，按 Hermes 官方说明装好或更新 Hermes Agent。 第二，在 Kimi 开放平台控制台创建 API 密钥，自己留好。 第三，确认账户有可用余额，再看限额和组织设置。 二、第一步：选供应商 终端输入 hermes model，在列表里选 Kimi / Moonshot。官方说 v0.18.2 里要选第一个子菜单项，当前叫 Kimi / Kimi Coding Plan，它同时也是国际版 Moonshot API 的内置入口。提示输入 KIMI_API_KEY 时粘贴密钥，输入时会被遮住。 成功标志：终端打印 Using Moonshot endpoint，后面是 http://api.moonshot.ai 加 /v1。 如果模型列表里没有 kimi-k3，就选 Enter custom model name，手动输入 kimi-k3，前面不要加 moonshot/。 三、第二步：贴完整配置 输入 hermes config edit，把官方给的 kimi-k3-global 这一项追加到已有的 custom_providers 列表里，再把其余字段合并到对应的顶层段落。段落已存在就改字段，别重复建，别动无关设置。 配置里要点：base_url 是 http://api.moonshot.ai 加 /v1，key_env 是 KIMI_API_KEY，api_mode 是 chat_completions，model 是 kimi-k3，reasoning_effort 设 max，上下文长度 1048576，supports_vision 设为 true。官方说 reasoning_effort 可选 low、high、max，默认 max。 官方强调：base_url 只能填到 v1，不要写完整的 chat/completions 地址。 四、第三步：打开视频工具 输入 hermes tools enable video，只需运行一次。以后在对话里给出本地视频的绝对路径，明确让它调用 video_analyze 就行。官方写 v0.18.2 支持 MP4、WebM、MOV、AVI、MKV、MPEG，编码后约 50MB 的上限来自 Hermes 客户端，不是 Kimi 接口的限制，太大的视频先压缩。 五、第四步：启动 新开一个会话，输入 hermes。状态栏应该显示 kimi-k3 和 1M，这就是成功的标志。看图片可以输入 /image 加图片绝对路径，或者复制图片后输入 /paste。 六、卡住怎么办 列表里没有 kimi-k3：重新跑 hermes model，选 Kimi / Moonshot，再手动输入 kimi-k3。 接口地址不对：必须看到 Using Moonshot endpoint 那一行，用国际版平台建的密钥重新跑 hermes model。 密钥被拒：重新输入国际版密钥，并检查 IP 白名单。 报 429：减少并发，等一会再试，检查余额和限速等级。 视频工具没被调用：确认运行过 enable video，明确要求调用 video_analyze，并用绝对路径。 收藏版：5 步速查 一，装 Hermes，平台建密钥，账户要有余额。 二，hermes model，选 Kimi / Moonshot，粘贴密钥。 三，hermes config edit，贴 kimi-k3-global 配置。 四，hermes tools enable video。 五，输入 hermes，状态栏看到 kimi-k3 和 1M 就成了。 S1哥观点 这篇官方文档最实在的地方，是反复提醒密钥别进配置文件、截图和 Git。配置文件会被备份、会被同步，密钥一进去就等于公开了，这一条比所有技巧都值钱。 真正的信号是 K3 的视频理解被做成了一个现成工具，一行命令打开。以前要自己抽帧再拼提示词，现在直接丢文件路径，门槛低了一大截。 同系列前几篇在我主页。 参考：Kimi 开放平台官方文档（S1哥 整理）

曝光 127 · 评论 4 · 点赞 1 · 书签 0