Hermes Agent 配置指南

Nous Research 开发的自学习 AI Agent，支持终端交互、多平台消息（Telegram/Discord/Slack 等）、技能学习和记忆系统。

功能特点

特性	说明
多模型支持	支持 OpenRouter、Anthropic、OpenAI、Gemini 等 200+ 模型
自定义端点	支持任意 OpenAI 兼容 API
终端工具	完整的终端操作、文件读写、代码执行
消息平台	Telegram、Discord、Slack、WhatsApp、Signal
技能系统	自动创建和改进技能，支持 Skills Hub
记忆系统	跨会话持久记忆和用户画像

安装

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

安装完成后重载 shell：

source ~/.bashrc  # 或 source ~/.zshrc

⚠️ 注意

• 仅支持 Linux、macOS、WSL2 和 Android（Termux）
• Windows 用户需先安装 WSL2

配置 TokenSwitch

Hermes Agent 支持自定义 OpenAI 兼容端点，可以通过交互式设置或手动编辑配置文件来接入 TokenSwitch。

方式一：交互式配置（推荐）

hermes model
# 选择 "Custom endpoint (self-hosted / VLLM / etc.)"
# API base URL: https://tokenswitch.cc/v1
# API key: 你的 TokenSwitch 令牌
# Model name: 根据需要填写模型名称

方式二：手动编辑配置文件

编辑 ~/.hermes/config.yaml：

model:
  default: your-model-name
  provider: custom
  base_url: https://tokenswitch.cc/v1
  api_key: your-tokenswitch-token

也可以将 API Key 存放在 ~/.hermes/.env 中：

OPENAI_API_KEY=your-tokenswitch-token

配置说明

配置项	值	说明
base_url	https://tokenswitch.cc/v1	TokenSwitch API 端点
api_key	你的令牌	从 TokenSwitch 平台获取
provider	custom	使用自定义端点
default	模型名称	根据令牌组支持的模型选择

验证配置

hermes

如果成功进入交互界面并能正常对话，说明配置完成。

常见问题

模型无响应

• 确认 base_url 为 https://tokenswitch.cc/v1
• 确认 API Key 正确
• 确认令牌组支持所选模型

如何切换模型

在会话中使用 /model 命令切换已配置的模型，或退出后运行 hermes model 添加新的供应商。

更多信息

• GitHub 仓库：NousResearch/hermes-agent
• 官方文档：hermes-agent.nousresearch.com/docs
• AI Providers 配置：Providers 文档