Hermes Agent接入SenseNova大模型API的完整教程

Hermes Agent 配置教程：Nous Research 开源 AI agent 通过 OpenAI 兼容接口接入商汤日日新 SenseNova，命令行与交互向导两种配置方式

摘要

Hermes Agent 是 Nous Research 维护的开源 AI agent，支持 OpenAI 兼容协议。这篇文章分享 Hermes Agent 接入 SenseNova（商汤日日新）大模型 API 的完整方法，包括安装脚本执行、shell 重载、命令行配置和交互向导两种接入方式，重点说明 model.default 这个必填配置项，最后给出验证配置是否成功的操作步骤。

大家好 这里是「代码简单说」，这篇文章主要分享一下 Hermes Agent 接入 SenseNova 大模型 API 的配置方法。

Hermes Agent 是 Nous Research 出品的开源终端 AI agent，模型服务支持自定义 Provider。SenseNova 提供 OpenAI 兼容接口，Base URL 为 https://token.sensenova.cn/v1，两者可以直接对接。这篇文章从安装讲到配置再到验证，其中 model.default 这个配置项非常容易漏掉，我会重点说明。

一、Hermes Agent 和 SenseNova 是什么

Hermes Agent 是由 Nous Research 维护的开源 AI agent，项目地址为 https://github.com/NousResearch/hermes-agent 。它在终端中运行，支持 OpenAI 兼容协议，可以自由对接第三方模型服务。

SenseNova（商汤日日新）的大模型 API 同时兼容 OpenAI 和 Anthropic 协议。Hermes Agent 使用的是 OpenAI 兼容接口：

可用的对话模型包括 sensenova-6.8-flash-lite、deepseek-v4-pro、deepseek-v4-flash、glm-5.2、kimi-k3 等。

注意： sensenova-u1-fast 是图像生成专用接口，不支持作为对话模型配置到 Hermes Agent，配置时不要填它。

二、准备工作

开始前需要准备：

• 运行环境：Hermes Agent 的安装脚本适用于 macOS / Linux / WSL2 环境，Windows 用户建议在 WSL2 里使用。
• SenseNova API Key：在 SenseNova 控制台 https://platform.sensenova.cn/console/keys 申请 API Key，并确认账号对要使用的模型有调用权限和可用额度。
• 网络环境：安装脚本需要从 GitHub 拉取内容，确保可以访问 raw.githubusercontent.com。

三、Hermes Agent 安装方法

1. 执行安装脚本

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

2. 重新加载 shell

安装完成后，重新加载 shell 配置使命令生效：

source ~/.bashrc   # bash
# 或
source ~/.zshrc    # macOS 默认 zsh

重载后在终端输入 hermes 相关命令就能正常识别了。

四、接入 SenseNova 配置方法

Hermes Agent 提供两种配置方式，任选其一即可。

方式一：命令行配置（推荐）

依次执行下面的命令，把 $SENSENOVA_API_KEY 替换为你在 https://platform.sensenova.cn/console/keys 申请的 API Key：

hermes config set model.provider custom
hermes config set model.base_url https://token.sensenova.cn/v1
hermes config set model.api_key "$SENSENOVA_API_KEY"  # 替换为你的 API Key
hermes config set model.name sensenova-6.8-flash-lite
hermes config set model.default custom/sensenova-6.8-flash-lite

五个配置项的作用：

重点： model.default 是必填项。它不设置会导致 hermes 使用默认模型并报错。很多人配完前四项就以为结束了，结果启动就出错，问题基本都出在这里。

如果想换模型，把 model.name 和 model.default 里的 sensenova-6.8-flash-lite 换成其他可用模型（如 deepseek-v4-pro、glm-5.2）即可，注意 model.default 要同步修改。

方式二：交互向导

如果不想逐条敲命令，可以用向导配置：

hermes setup   # 全量向导
# 或
hermes model   # 仅模型配置

向导询问 provider 时选择 custom (OpenAI-compatible)，然后依次填入：

• Base URL：https://token.sensenova.cn/v1
• API Key：你的 Key
• Model name：sensenova-6.8-flash-lite

填完保存即可。

五、验证与使用方法

配置完成后，在终端执行：

hermes

进入 Hermes Agent 交互界面后，发送「你好」。

判断标准： 能返回中文回答，就说明配置成功，模型已经通过 SenseNova 的接口正常工作。之后就可以在交互界面里正常使用 agent 的各项能力了。

六、常见问题

1. 启动后报模型相关错误怎么办？

最常见的原因是漏配了 model.default。它是必填项，不设置会导致 hermes 使用默认模型并报错。执行下面的命令补上：

hermes config set model.default custom/sensenova-6.8-flash-lite

2. 命令行执行hermes提示找不到命令怎么办？

安装脚本执行完后需要重新加载 shell。bash 用户执行 source ~/.bashrc，macOS 默认 zsh 用户执行 source ~/.zshrc，然后重开终端再试。

3. 发送「你好」没有返回 回答怎么办？

按顺序检查：

• API Key 是否正确：确认 Key 来自 SenseNova 控制台，且仍在有效额度内。
• Base URL 是否正确：必须是 https://token.sensenova.cn/v1，注意末尾带 /v1。
• Model ID 是否正确：确认填的是对话模型（如 sensenova-6.8-flash-lite），不要填 sensenova-u1-fast 这种图像生成专用接口。
• provider 是否选对：命令行方式的 model.provider 必须是 custom；向导方式必须选 custom (OpenAI-compatible)。

4. 如何修改已经配置好的模型？

用命令行方式直接覆盖即可，例如换成 glm-5.2：

hermes config set model.name glm-5.2
hermes config set model.default custom/glm-5.2

或者重新运行 hermes model 向导配置。

七、总结

Hermes Agent 接入 SenseNova 的要点就两个：一是安装脚本执行后记得重载 shell；二是配置时五条命令一条都不能少，尤其是 model.default custom/sensenova-6.8-flash-lite 这条必填项。配置完进入 hermes 交互界面发「你好」验证即可。

以上就是 Hermes Agent 接入 SenseNova 大模型 API 的完整教程，按照上面的步骤操作即可完成配置。如果遇到其他问题，可以结合具体报错信息进行排查。

到此这篇关于Hermes Agent接入SenseNova大模型API的完整教程的文章就介绍到这了,更多相关Hermes Agent接入SenseNova内容请搜索脚本之家以前的文章或继续浏览下面的相关文章，希望大家以后多多支持脚本之家！

最新评论