Hermes Agent从安装到调用全流程:告别复杂配置,用API中转轻松跑通(附CC Switch模型切换)
前言
最近AI Agent工具更新太快,很多朋友想体验Hermes却被环境配置劝退——最大的卡点就是环境模型接入问题。这篇文章就用 API 中转去解决,整篇文章整理了从安装到调用的完整流程,尽量把每个环节讲清楚,帮你少踩坑。
正文
Hermes 是什么?
圈内常说“养虾”(OpenClaw)和“养马”(Hermes),Hermes Agent是Nous Research开源的AI Agent框架,核心定位是“和你一起成长的Agent”。和龙虾(OpenClaw)相比,龙虾强在多角色协同调度,而Hermes的优势在于记忆和自我进化,像个越用越懂你的私人助理。
核心亮点
- 记忆强:底层架构重点设计记忆能力,关键信息存入本地数据库并建立索引,需要时才检索调用,避免上下文窗口过载,比部分Agent更稳定。
- 自动沉淀Skill:完成复杂任务后自动把流程沉淀为Skill,下次遇到类似任务直接调用,无需手动创建维护。
- 多身份隔离:每个Profile是独立身份,记忆、技能、配置互不干扰,相当于拥有多个不同助理。
一、下载安装
下载安装包
访问官方下载地址:https://hermes-agent.nousresearch.com/,网站会自动识别你的系统(Windows/MacOS),点击对应链接下载。运行安装程序
下载完成后打开安装包,按提示完成安装(过程和普通软件一致,无需特殊配置)。
3.首次启动初始化
首次打开Hermes会自动进行后台安装,等待进度条结束后,看到主界面即安装成功。
二、设置中文
默认界面是英文,先切换为中文:
- 点击右上角齿轮图标打开设置
- 选择“Appearance”(外观),语言下拉框中选择“简体中文”,设置立即生效。
三、接入模型
Hermes支持账号授权和API密钥接入,但官方方式需要海外账号。这里我们用API中转+CC Switch实现国内直连,步骤如下:
获取 API KEY
这里以88api作为中转接口(网址:https://api.88api.shop);或者大家可以用自己熟悉的步骤,类似。具体步骤:
1.点击 “API 令牌”
2.点击添加令牌
3. 创建令牌
名称随便写,没有含义,直接点击提交即可。
- 获取 API KEY
获得 API Key 后请妥善保管,API Key 是你的身份凭证,等同于账号密码,切勿公开或分享给他人。
- 点击“知道了”,可以看到我们刚才创建的,在这里也同样可以点击 复制 按钮去获取 API Key。
CC Switch 配置切换模型
CC Switch是个开源工具,能快速切换大模型,无需手动改配置文件,操作如下:
不明白没关系,直接跟着操作就行。
具体下载版本链接:https://github.com/farion1231/cc-switch/releases
- 一直往下拉,拉到下面这个位置下载
2. 根据你的操作系统,下载对应的安装包。Linux、MacOS、Windows看文件名能区分。或点击 “show all 18 assets” 往下拉找更多的版本。
3.安装后打开 CC Switch,点击 Hermes 的图标,再点击 【+】号进行配置模型。
4.直接默认选择「自定义配置」:
- “供应商标识” 和 “供应商名称” 自己取;
- API KEY 还是上面的直接复制过来;
- API 请求地址就是刚才复制的 Base URL:https://api.88api.shop/v1 ;
- 然后直接点击添加就可以了。
- 最后点击启用,重启 Hermes
启用完毕之后,需要重启Hermes,使得配置生效。
6.重新打开 Hermes,点击右上角的设置按钮。在左侧选择“模型”,第一个下拉框里选择刚才创建的供应商,这里的“88”是我刚创建的供应商标识名称。
- 在第二个下拉框里面,这里可以选择 GPT 模型,我最近在用 GPT 5.5(最新的5.6也不错,很好用);然后点击应用;快速选项也可以给它打开。
一个小建议,对于复杂应用,可以使用高级的模型;对于简单应用,切换为低级模型,这样可以节省token。
⚠️ ⚠️ 注意:若启动后因为连接问题无法使用,尝试修改API请求地址为
https://api.88api.shop(去除/v1),重启后再试。(我实操时遇到过这个问题,改地址后解决)。
五、开始使用
输入“你好”,能够正常回复。恭喜你已经可以开始使用啦!
六、创建新的Profile
前面我们已经介绍,一个 profile 就是一个独立的私人助理。现在展示如何新建一个 profile,点击左下角的加号。
这里需要填写名称,克隆来源,然后点击创建配置档案即可。
- 选择克隆 :相当于"抄作业"——你选一个已有的 Profile 作为起点,它的所有设置(记忆、知识等)都会复制过来,之后可以在此基础上修改。因为我们这里初次登录,所以只有一个默认的 default 可以克隆。
- 选择空白 :相当于从头开始,从零搭建完全符合自己需求的人设。
💡注意,创建完之后一个新的 Profile 之后,可以关掉Hermes ,重启一下,因为可能会出现新的 Profile 没有被加载的情况。
总结
本文带你走完了Hermes从安装、中文设置到API接入的全流程,重点解决了模型调用的环境问题,还介绍了多Profile的创建方法。按照步骤操作,基本能避开大部分配置坑。如果过程中遇到其他问题,欢迎在评论区交流,一起完善这个“会成长的助理”使用体验。