Hermes Agent从安装到调用全流程:解决模型接入痛点,小白也能照着做(2024实操)
前言
最近AI Agent工具更新很快,从之前的“养虾”(OpenClaw)到现在越来越多人开始“养马”(Hermes)。但很多人卡在环境配置上——官方账号难申请、模型调用总失败、教程碎片化。今天分享一篇从安装到使用的完整实操,帮你避开常见坑,快速把Hermes跑起来。
正文
一、先了解:Hermes Agent是什么?
Hermes Agent是Nous Research开源的AI Agent框架,核心定位是“和你一起成长的Agent”。和OpenClaw(龙虾)相比,它的优势在于:
- 记忆强:底层设计的记忆系统,重要信息存本地数据库并索引,需要时才调用,不会像龙虾那样容易丢记忆
- 自动沉淀Skill:复杂任务完成后自动把流程存为Skill,下次直接调用,不用手动维护
- 多身份隔离:每个Profile是独立助理,记忆、技能、配置互不干扰
二、下载安装Hermes
1. 下载安装包
官网地址:https://hermes-agent.nousresearch.com/
打开后会自动识别系统(Windows/MacOS),点击对应版本下载即可。
2. 安装流程
下载完成后打开安装包,按提示完成安装。首次打开时会进行后台配置,等待进度条结束,看到主界面即安装成功。

三、设置中文界面
默认是英文界面,先改语言:
- 点击右上角齿轮图标打开设置
- 选择“Appearance”(外观)
- 语言下拉框选“简体中文”,设置立即生效

四、接入模型:API中转+CC Switch配置
Hermes官方接入需要账号授权或API密钥,对国内用户不太友好。这里用API中转+CC Switch工具解决,步骤如下:
1. 获取API Key
这里以88api作为中转接口为例,其他的类似。主要是为了解决账号和环境问题,或者大家也可以用自己熟悉的服务。
具体步骤:
1.访问88api(https://api.88api.shop),注册登录后,点击 “API 令牌”
2.点击添加令牌
3. 创建令牌
名称随便写,没有含义,直接点击提交即可。

- 获取 API KEY
获得 API Key 后请妥善保管,API Key 是你的身份凭证,等同于账号密码,切勿公开或分享给他人。
- 点击“知道了”,可以看到我们刚才创建的,在这里也同样可以点击 复制 按钮去获取 API Key。

2. 用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;然后点击应用;快速选项也可以给它打开。

⚠️ ⚠️ 注意:若启动后因为连接问题无法使用,尝试修改API请求地址为
https://api.88api.shop(去除/v1),重启后再试。(我实操时遇到过这个问题,改地址后解决)。
五、开始使用
输入“你好”,能够正常回复。恭喜你已经可以开始使用啦!

六、创建新的Profile
前面我们已经介绍,一个 profile 就是一个独立的私人助理。现在展示如何新建一个 profile,点击左下角的加号。

这里需要填写名称,克隆来源,然后点击创建配置档案即可。
- 选择克隆 :相当于"抄作业"——你选一个已有的 Profile 作为起点,它的所有设置(记忆、知识等)都会复制过来,之后可以在此基础上修改。因为我们这里初次登录,所以只有一个默认的 default 可以克隆。
- 选择空白 :相当于从头开始,从零搭建完全符合自己需求的人设。

💡注意,创建完之后一个新的 Profile 之后,可以关掉Hermes ,重启一下,因为可能会出现新的 Profile 没有被加载的情况。
总结
本文从安装到模型接入,带你完整跑通了Hermes Agent的基础流程,重点解决了中文设置和模型调用的环境问题。Hermes的记忆和Skill沉淀功能值得深入体验,后续可以根据需求创建不同Profile。如果遇到其他配置问题,欢迎在评论区交流。
更多推荐


所有评论(0)