环境配置总卡壳?这篇Hermes Agent从0到1教程帮你少走弯路

环境配置总卡壳?这篇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. 首次启动

首次打开会自动进行后台配置,等待进度条结束,看到主界面即安装成功。

三、设置中文界面

默认是英文界面,先改语言:

  1. 点击右上角齿轮图标(设置)
  2. 选择Appearance,语言下拉框选简体中文
  3. 界面会自动刷新为中文,无需重启。

四、接入模型

Hermes默认需要官方账号授权或API密钥,但国内用户可能觉得麻烦。这里用API中转+CC Switch实现配置,步骤如下:

4.1 获取 API Key

我这次用88api作为中转接口(网址:https://api.88api.shop),个人觉得较划算稳定,或者大家也可以用自己熟悉的。

具体步骤:

  1. 访问 88api (https://api.88api.shop),注册登录以后,点击侧边栏的 “API 令牌”

  1. 点击"添加令牌"

  1. 创建令牌,名称随意,直接提交

  1. 获取 API Key,注意妥善保管,不要公开或分享

  1. 点击"知道了",在令牌列表中可以点击"复制"按钮获取 API Key

4.2 用CC Switch配置模型切换

CC Switch是开源工具,能快速切换大模型,无需手动改配置文件。

不明白没关系,直接跟着操作就行。

具体下载版本链接:https://github.com/farion1231/cc-switch/releases

  1. 一直往下拉,拉到下面这个位置下载


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”是我刚创建的供应商标识名称。

  1. 在第二个下拉框里面,这里可以选择 GPT 模型,我最近在用 GPT 5.5;然后点击应用;快速选项也可以给它打开。

⚠️ ⚠️ 注意:若启动后因为连接问题无法使用,尝试修改API请求地址为https://api.88api.shop(去除/v1),重启后再试。(我实操时遇到过这个问题,改地址后解决)。

五、开始使用

输入“你好”,能够正常回复。恭喜你已经可以开始使用啦!

六、创建新的Profile

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

这里需要填写名称,克隆来源,然后点击创建配置档案即可。

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

💡注意,创建完之后一个新的 Profile 之后,可以关掉Hermes ,重启一下,因为可能会出现新的 Profile 没有被加载的情况。

总结

本文带你完整走通了Hermes Agent的安装、中文设置、API对接和多身份配置,重点解决了国内环境下的模型调用问题。步骤都是实操验证过的,跟着做基本不会踩坑。

如果你在配置中遇到其他问题,欢迎在评论区留言,我会尽量回复。现在就去试试这个"越用越懂你"的AI助理吧!