Skip to main content
Hermes Agent 是由 Nous Research 开发的开源 AI 编程助手，具备跨会话持久化记忆、可复用技能和自我改进能力。

​
前置条件

​
安装 Hermes Agent

一键安装（推荐）：
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
Macshot Clipboard FF99DB5D 8340 4229 BB29 FC689F113E65
选择快速配置
Macshot Clipboard 567B1034 36AA 4787 B908 922C83DC3B4E
选择提供商： Custom endpoint
Macshot Clipboard 8D1E86AA 569E 42ED 9DC3 75BC874004EB
输入 API 地址：https://teio.me/v1
Macshot Clipboard 0F2209EA 1577 41B4 9A82 59F8BE114670
输入 API 密钥：你的密钥
Macshot Clipboard B2827E97 53D7 44EB 95F3 7FE1185C280A
请确保 API 地址和密钥填写正确，否则下一步验证会失败。
输入模型序号或者模型名称，例如 在这里是 claude-sonnet-4-6
Macshot Clipboard 49389A5D 8E00 4717 8778 3C7E878836CF
上下文长度（留空自动检测）：这里默认回车
Macshot Clipboard 720DD72E 7E70 4C49 9987 0656AC455AC3
显示名称 [Teio.me]：这里默认回车
Macshot Clipboard F970D193 A11C 4FDE AB7F 595A38C0B53C
已保存为自定义提供商 [Teio.me]（可在 config.yaml 中编辑）
如果配置过程中遇到问题，可以随时运行 hermes model 重新开启配置向导。

​
启动

hermes
如果配置正确，你会进入 Hermes Agent 的交互界面。
Macshot Clipboard 4DDDB033 D86B 40DE B002 E595A68024E8

​
常见问题

这是因为 npm 在下载浏览器相关依赖（如 Playwright/Chromium）时网络较慢。可以先耐心等待几分钟，通常会自动完成。如果长时间没有进展，可以设置 npm 镜像源后重试：
npm config set registry https://registry.npmmirror.com
然后按 Ctrl+C 中断当前安装，重新执行安装脚本即可。如果你有代理，也可以直接配置 npm 代理：
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
遇到问题？请参考 常见问题。