Hermes

项目介绍

• 项目定位: Hermes Agent 是 Nous Research 开源的全功能 AI Agent，可在终端中对话编程，也可以作为常驻服务接入 Telegram、Discord、Slack、WhatsApp 等社交平台。

• 核心特色:

• 完整的 CLI 对话体验，内置工具调用、记忆（Memory）与技能（Skills）系统。

• 支持 Nous Portal、OpenRouter、OpenAI 等多种供应商，也支持任意 OpenAI / Anthropic 兼容端点，因此可以直接接入脑生云。

• hermes gateway 一条命令即可把 Agent 挂到社交软件上作为机器人使用。

• 数据全部保存在本地 ~/.hermes/ 目录，无遥测上报。

• 支持本地终端、Docker、SSH 远程等多种执行后端。

• 平台支持: Linux、MacOS、WSL2（原生 Windows 处于实验阶段，推荐使用 WSL2）。

安装与初始化

1. 打开终端，运行以下命令进行一键安装（脚本会自动安装 uv、Python 3.11 等依赖，无需 sudo）

Linux / MacOS / WSL2

Windows（PowerShell，实验性）

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

2. 安装完成后重载一下 shell 配置，再输入 hermes 能看到交互界面即安装成功

3. 首次启动会进入设置向导，供应商选择部分可以先跳过，下面我们通过 CC-Switch 配置脑生云渠道。

配置脑生云渠道

1. 查看 CC Switch下载一节的内容，下载并安装 CC-Switch 到本地，安装并打开软件

2. 上方配置项选择到 Hermes，然后点击添加供应商按钮

3. 进行多项配置：

• 在预设供应商中选择自定义

• 在供应商标识中填写名称（只能使用小写字母、数字和连字符），比如脑生云

• API 模式保持 Anthropic Messages，API 端点保持https://api\.naoshengyun\.com/

- 在 `API Key` 中填入创建 API Key 一节中你创建的Key

接入提示：以下操作保留参考教程的流程，模型名称与兼容能力请以脑生云实际开通情况为准。

• 在模型列表中配置ApiKey对应分组下正确的模型名，每个模型需要填写模型 ID 和显示名称（高级选项保持默认即可），每个分组下的模型可在已开通的模型与密钥权限一节中查询。

比如现在我的ApiKey对应的是claude分组，那么我可以配置：

• 默认模型 → 模型 ID：claude-opus-4-8 显示名称：Claude Opus 4.8

• 备选模型 → 模型 ID：claude-sonnet-4-6 显示名称：Claude Sonnet 4.6

• 全部配置好后，点击右下角添加按钮

4. 在界面中选择刚配置好的脑生云渠道，点击启用按钮，即可完成渠道启用

提示

CC-Switch 实际写入的是 ~/.hermes/ 目录下的 .env（ApiKey 等敏感信息）与 config.yaml（供应商、模型等配置），熟悉 Hermes 的用户也可以直接手动编辑这两个文件。

验证配置

1. 重新打开终端，输入 hermes 进入对话界面

2. 输入 /model 命令，在模型选择器中能看到刚配置的脑生云渠道及模型列表，选中想要的模型回车确认；后续切换渠道时回到 CC-Switch 一键切换即可

3. 随便发送一句话，能正常收到回复即表示配置成功，开始愉快的对话吧~

常用命令速查

命令	说明
hermes	进入交互式 CLI
hermes model	交互式选择供应商 / 模型
hermes dashboard	启动 Web 界面
hermes config set KEY VALUE	写入配置（密钥会保存到 .env）
hermes gateway setup	配置 Telegram / Discord 等社交平台机器人
hermes doctor	诊断环境问题
hermes update	更新 Hermes 到最新版本

Hermes

Hermes#

项目介绍#

安装与初始化#

Linux / MacOS / WSL2#

Windows（PowerShell，实验性）#

配置 脑生云 渠道#

验证配置#

Hermes

项目介绍

安装与初始化

Linux / MacOS / WSL2

Windows（PowerShell，实验性）

配置脑生云渠道

验证配置