环境配置总卡壳?这篇Hermes Agent从0到1教程帮你少走弯路
前言
最近AI Agent工具更新太快,很多人想试试"养马"(Hermes)却被环境配置劝退——不是缺海外账号,就是API调用总出问题。网上教程要么太碎,要么步骤不完整,照着做还总失败。
这篇文章就带你从0到1搞定Hermes Agent:从下载安装、中文设置,到用API模型配置,每一步都附实操截图和避坑点,技术小白也能跟着做。
正文
一、先搞懂:Hermes Agent是什么?
之前大家熟悉的"养虾"(OpenClaw)强在多角色协同,而"养马"(Hermes)则是Nous Research开源的AI Agent框架,核心优势是记忆和自我进化,越用越懂你。
核心亮点:
- 记忆强:底层设计本地数据库+索引,按需召回信息,不会一股脑塞上下文(比龙虾更不容易丢记忆)
- 自动沉淀Skill:复杂任务做完自动存为技能,下次直接调用,不用手动维护
- 多身份隔离:每个Profile是独立助理,记忆、技能、配置互不干扰
二、下载安装Hermes
1. 下载安装包
官网地址:https://hermes-agent.nousresearch.com/
打开后会自动识别系统(Windows/MacOS),点击对应链接下载即可。
2. 安装流程
下载完成后打开安装包,按提示完成安装(一路默认下一步即可)。
3. 首次启动
首次打开会自动进行后台配置,等待进度条结束,看到主界面即安装成功。
三、设置中文界面
默认是英文界面,先改语言:
- 点击右上角齿轮图标(设置)
- 选择Appearance,语言下拉框选简体中文
- 界面会自动刷新为中文,无需重启。
四、接入模型
Hermes默认需要官方账号授权或API密钥,但国内用户可能觉得麻烦。这里用API中转+CC Switch实现配置,步骤如下:
4.1 获取 API Key
我这次用88api作为中转接口(网址:https://api.88api.shop),个人觉得较划算稳定,或者大家也可以用自己熟悉的。
具体步骤:
- 访问 88api (https://api.88api.shop),注册登录以后,点击侧边栏的 “API 令牌”
- 点击"添加令牌"
- 创建令牌,名称随意,直接提交
- 获取 API Key,注意妥善保管,不要公开或分享。
- 点击"知道了",在令牌列表中可以点击"复制"按钮获取 API Key
4.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 ;
- 然后直接点击添加就可以了。
5. 最后点击启用,重启 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的安装、中文设置、API对接和多身份配置,重点解决了国内环境下的模型调用问题。步骤都是实操验证过的,跟着做基本不会踩坑。
如果你在配置中遇到其他问题,欢迎在评论区留言,我会尽量回复。现在就去试试这个"越用越懂你"的AI助理吧!