Skip to main content
Hermes Agent

​
概述

Hermes Agent 是由 Nous Research 开发的开源自主学习 AI 智能体，具备持久记忆、自改进能力与丰富的工具生态。本文将指导你把 SenseAudio 的 S2 模型（模型 ID：senseaudio-s2）接入 Hermes Agent。

跨会话持久记忆

编程模式与项目上下文自动沉淀，用得越多越懂你。

自改进学习

内置技能系统会从每次交互中持续优化。

40+ 集成工具

覆盖代码、搜索、文件与外部服务等常用能力。

多平台支持

CLI、Telegram、Discord、Slack、WhatsApp 全平台可用。

​
前提条件

已订阅 SenseAudio Token Plan
已创建 Token Plan API Key
一台可访问终端的电脑（macOS、Linux、Windows WSL2 或 Windows PowerShell）
如果还没有 API Key，请先打开 API 密钥页面，点击 新增 API Key 并复制安全保存。 macOS、Linux 和 WSL2 需要先安装 Git，可运行 git --version 检查。Linux 和 WSL2 还需要 curl、xz-utils；Ubuntu / Debian 可运行 sudo apt install git curl xz-utils 安装。详见 官方安装前提。

​
安装 Hermes Agent

1

打开终端

  • macOS：按 Command + Space，搜索“终端”并按回车。
  • Linux：按 Ctrl + Alt + T，或从应用列表打开 Terminal。
  • Windows WSL2：按 Win 键，搜索“Ubuntu”或“WSL”，打开终端。
  • Windows PowerShell：按 Win 键，搜索“PowerShell”并打开。
2

一键安装

根据系统运行对应命令：
安装脚本会自动检测并安装 uv、Python、Node.js、ripgrep、ffmpeg，无需提前手动安装这些组件。Git 及 Linux / WSL2 的 curl、xz-utils 仍需按前提条件准备。
3

重新加载终端

安装完成后，关闭并重新打开终端。macOS、Linux 或 WSL2 也可以运行：
如果你使用 Bash，请改为运行 source ~/.bashrc。
4

验证安装

执行环境自检命令：
当命令未报告阻塞性错误时，继续配置模型。
Hermes Doctor 检查结果：核心 Python 环境和配置文件存在，仍有环境文件和可选依赖提示
此图采集于模型配置完成后，使用独立测试目录，并非所有检查均通过：本次检查仍报告 .env 缺失、Web/TUI/WhatsApp 组件依赖漏洞，以及部分工具密钥未配置。S2 对话另行验证成功；对话成功不代表这些问题已解决。
更多安装细节与进阶用法请参考 Hermes Agent 官方文档。

​
配置 Token Plan

Hermes Agent 安装完成后不会自动添加 SenseAudio。请在普通终端中运行下面的模型配置向导：
请运行终端命令 hermes model 添加 Provider。Hermes 会话中的 /model 只能切换已经配置好的模型，不能完成首次接入。
如果你已经配置了其他模型，也可以继续运行 hermes model 添加 SenseAudio。向导会保留已有配置，不需要覆盖 ~/.hermes/config.yaml。
1

选择 Provider

从 Provider 列表中选择 Custom endpoint。不同版本可能显示为 Custom endpoint (self-hosted / VLLM / etc.)。
选择 Custom endpoint
2

填写 API Base URL

输入 SenseAudio 的 API 接入地址：
3

输入 API Key

打开 API 密钥页面，复制刚才创建的 Token Plan API Key，然后粘贴到输入框并按回车。
Hermes 填写 SenseAudio API 地址和已遮挡的 API Key
4

选择 API 模式（如果出现）

如果向导询问 API mode，选择 Chat Completions 或名称中带有 OpenAI-compatible 的选项。如果当前版本没有这一步，直接继续，不需要额外设置。
Hermes 选择 Chat Completions，显示 API mode 为 chat_completions
5

输入模型名称

在 Model name 或 Model ID 中输入：
如果显示模型列表，选择 senseaudio-s2 对应的编号，或直接输入模型 ID；编号以当前列表为准。如果询问 Context length in tokens，留空以自动检测；Display name 填写 SenseAudio。
6

保存为默认模型

如果向导询问是否保存或设为默认模型，选择 Yes 或 Confirm。如果当前版本没有这一步，向导会自动保存。完成后应回到终端，并看到配置已保存的提示。
Hermes 选择 senseaudio-s2，并将 SenseAudio 保存为自定义 Provider 和默认模型
7

再次检查配置

运行：
如果没有阻塞性错误，即可开始使用。
还没有 API Key？ 请先订阅 Token Plan，再前往 API 密钥页面 创建专属 API Key。套餐额度用尽或达到限制后，可开启 Extra Usage，超出部分将按量计费并从账户余额扣除。

​
开始使用

1

启动 Hermes Agent

在终端运行：
2

发送测试消息

启动后输入下面的通用示例：
确认当前模型为 senseaudio-s2，且正常返回文本，表示这次请求成功。模型在回答中的自称仅供参考。
Hermes 成功回复测试问题，底部显示 senseaudio-s2 模型
接入成功后，你可以继续用自然语言下达任务，例如：
  • “帮我用 Python 写一个爬取网页标题的脚本”
  • “检查当前项目的依赖有没有安全漏洞”
  • “把 README.md 翻译成英文”
越用越聪明：Hermes Agent 会自动记录你的编程习惯、项目背景和偏好设置。下次打开时，无需重复说明。

​
常见问题

​
hermes model 找不到或配置项不一致

先运行 hermes --version 确认安装成功，再参考 Hermes Agent 官方文档 更新到当前版本。不同版本的字段名称可能略有差异，但需要填写的核心信息不变：Provider、API Base URL、API Key 和模型 ID。

​
配置后无法返回结果

按下面顺序检查：
  1. 重新运行 hermes model，确认 Base URL 是 https://api.senseaudio.cn/v1。
  2. 确认模型 ID 是 senseaudio-s2。
  3. 确认使用的是 Token Plan API Key，且 Key 没有多余空格。
  4. 运行 hermes doctor 查看具体错误。

​
相关资源

Claude Code

在 Claude Code 中接入 S2 模型

S2 使用技巧

发挥 S2 模型最佳效果

常见问题

订阅、限额、切换、开票等问题解答。