> ## Documentation Index
> Fetch the complete documentation index at: https://docs.teio.me/llms.txt
> Use this file to discover all available pages before exploring further.
# Hermes Agent
> 在终端中配置 Teio API 使用 Hermes Agent
> Hermes Agent 是由 Nous Research 开发的开源 AI 编程助手，具备跨会话持久化记忆、可复用技能和自我改进能力。
## 前置条件
* 已 [创建 API 密钥](/create-token)
* macOS 系统（Windows 需要 WSL2）
## 安装 Hermes Agent
一键安装（推荐）：
```bash theme={null}
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
```
需要先安装 WSL2，然后在 WSL2 终端中执行：
```bash theme={null}
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
```
## 配置
Hermes Agent 的配置文件位于：
* macOS / Linux：`~/.hermes/config.yaml`
* Windows (WSL2)：`\\wsl$\Ubuntu\home\你的用户名\.hermes\config.yaml`
选择快速配置
选择提供商： `Custom endpoint`
输入 API 地址：`https://teio.me/v1`
输入 API 密钥：`你的密钥`
请确保 API 地址和密钥填写正确，否则下一步验证会失败。
输入模型序号或者模型名称，例如 在这里是 `claude-sonnet-4-6 `
上下文长度（留空自动检测）：这里默认回车
显示名称 \[Teio.me]：这里默认回车
已保存为自定义提供商 \[Teio.me]（可在 config.yaml 中编辑）
如果配置过程中遇到问题，可以随时运行 `hermes model` 重新开启配置向导。
## 启动
```bash theme={null}
hermes
```
如果配置正确，你会进入 Hermes Agent 的交互界面。
## 常见问题
这是因为 npm 在下载浏览器相关依赖（如 Playwright/Chromium）时网络较慢。可以先耐心等待几分钟，通常会自动完成。如果长时间没有进展，可以设置 npm 镜像源后重试：
```bash theme={null}
npm config set registry https://registry.npmmirror.com
```
然后按 `Ctrl+C` 中断当前安装，重新执行安装脚本即可。如果你有代理，也可以直接配置 npm 代理：
```bash theme={null}
npm config set proxy http://你的代理地址:端口
npm config set https-proxy http://你的代理地址:端口
```
Hermes 每次只能使用一个模型，`/model` 不支持多选。切换模型有两种方式：
1. 运行 `hermes model` 重新配置，选择新的模型名称（如 `claude-opus-4-7`）
2. 直接编辑 `~/.hermes/config.yaml`，修改模型字段即可
如果你经常需要在多个模型间切换，建议在 config.yaml 中预先配置多个 provider，这样切换时只需选序号，不用重新填写地址和密钥。
Hermes Agent 不支持原生 Windows，需要通过 WSL2 运行。请先安装 WSL2：
1. 以管理员身份打开 PowerShell
2. 执行 `wsl --install`
3. 重启电脑后在 WSL2 终端中安装 Hermes
遇到问题？请参考 [常见问题](/faq)。