新手也能搞定!Hermes Agent安装与多模型接入全流程,附避坑细节(亲测有效)

📅 2026/7/21 15:15:00 👁️ 阅读次数 📝 编程学习
新手也能搞定!Hermes Agent安装与多模型接入全流程,附避坑细节(亲测有效)

前言

最近AI Agent工具更新很快,从之前的“养虾”(OpenClaw)到现在越来越多人开始“养马”(Hermes)。但很多朋友卡在安装配置环节,要么官方账号难申请,要么国内环境调用不稳定。这篇文章就以实操角度,带你从0到1完成Hermes的安装、中文设置,以及通过API中转和CC Switch解决账号和环境问题,尽量让每个步骤都清晰可操作。

正文

一、认识Hermes:为什么值得一试?

Hermes Agent是Nous Research开源的AI Agent框架,核心定位是“和你一起成长的Agent”。和其他工具相比,它有三个突出优势:

  • 记忆能力强:底层设计就注重记忆管理,重要信息存入本地数据库并建立索引,需要时才调用,不会像有些工具那样“丢三落四”。
  • 自动沉淀Skill:完成复杂任务后会自动把流程存为Skill,下次遇到类似任务直接调用,不用重复配置。
  • 多身份隔离:每个Profile都是独立“助理”,记忆、技能、配置互不干扰,相当于同时拥有多个专属助手。

二、下载与安装Hermes

1. 下载安装包

访问官方下载地址:https://hermes-agent.nousresearch.com/
网站会自动识别你的操作系统(Windows/MacOS),点击对应版本下载即可。

2. 安装流程

下载完成后打开安装包,按提示完成安装(一路“下一步”即可)。

3. 首次启动

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

三、设置中文界面

默认界面是英文,先把语言切换为中文:

  1. 点击右上角齿轮图标打开设置
  2. 选择“Appearance”(外观)
  3. 语言下拉框选择“简体中文”,设置立即生效

四、接入模型:API中转+CC Switch配置

Hermes官方支持账号授权或API密钥接入,但都需要官方账号。这里用更简单的“API中转+CC Switch”方案,无需官方账号即可调用主流模型。

1. 获取API Key

为减少环境配置和账号切换的麻烦,我这次用88api中转服务(网址:https://api.88api.shop)为例;其他中转服务类似。

具体步骤:
1.点击 “API 令牌”

2.点击添加令牌

3. 创建令牌

名称随便写,没有含义,直接点击提交即可。

  1. 获取 API KEY

获得 API Key 后请妥善保管,API Key 是你的身份凭证,等同于账号密码,切勿公开或分享给他人。

  1. 点击“知道了”,可以看到我们刚才创建的,在这里也同样可以点击 复制 按钮去获取 API Key。
2. 用CC Switch配置模型切换

CC Switch是开源的模型切换工具,能帮Hermes快速配置不同模型,无需手动修改配置文件。

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

具体下载版本链接: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 ;
  • 然后直接点击添加就可以了。

  1. 最后点击启用,重启 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从下载安装到模型接入的全流程,重点解决了官方账号难获取、国内调用配置复杂的问题。核心步骤是通过中转获取Key,配合CC Switch实现模型快速切换。如果在操作中遇到其他问题,欢迎在评论区交流,一起完善这个“会成长的助理”使用体验。