Hermes 是 NousResearch 开源的 AI 代理框架，支持自托管 + 学习用户偏好 + Telegram Bot 接入。不需要原生订阅 OpenAI / Anthropic，挂上 VisionCoder 就能用。

​
前提

  • 在 API Key 管理 创建 API Key
  • 已装 Node.js 18+
  • Windows 用户：强烈推荐用 WSL2，Hermes 主要在 Unix 环境下测试

​
安装 Hermes

打开 Terminal：
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
耐心等装完（会拉依赖、初始化数据目录）。

​
配置模型（关键步骤）

装完后 Hermes 会问你走哪个上游，选 Custom endpoint（不是 Quick setup，那个是接 OpenAI 官方订阅）。 进入设置： 
hermes model
填以下两项： 
Base URL:  https://coder.api.visioncoder.cn/v1
API Key:   YOUR_API_KEY
再选模型 ID。Hermes 通过 OpenAI Chat Completions 协议调用 VisionCoder，所以所有 chat 模型都能选：
推荐适合场景
gpt-5.4日常默认
gpt-5.5复杂推理
claude-sonnet-4-6偏好 Claude 风格
claude-opus-4-7最强 Claude 推理
deepseek-v4-pro中文场景 / 高性价比
不确定支持哪些模型？跑 curl https://coder.api.visioncoder.cn/v1/models 拿实时列表。

​
接入 Telegram Bot

Hermes 最有意思的能力是把代理挂到 Telegram，用手机直接聊。

​
1. 申请 Telegram Bot

1

打开 BotFather

Telegram 里搜 @BotFather，发起对话。
2

创建 Bot

发 /newbot，按提示填名字（必须以 bot 结尾，比如 my_hermes_bot）。
3

保存 Token

BotFather 返回一串 123456:ABC-DEF... 格式的 Token。这是 Bot 的密钥，保管好。

​
2. 拿自己的 Telegram 数字 ID

Hermes 需要知道哪个用户能跟 Bot 说话，避免被陌生人调用。
  • 在 Telegram 里搜 @userinfobot，发任意消息
  • Bot 返回的 Id: 12345678 就是你的数字 ID

​
3. 在 Hermes 配置消息通道

安装流程到「选择消息通道」时：
1

选 Telegram

按空格选中、回车。
2

粘贴 Bot Token

从 BotFather 拿到的那串。
3

粘贴自己的 Telegram 数字 ID

从 @userinfobot 拿到的。
部署完，在 Telegram 里给你的 Bot 发消息，它会调用 VisionCoder 后端、回复你。

​
常用命令

hermes model      # 查看 / 切换模型
hermes setup      # 重新跑配置向导
hermes --help     # 完整命令清单

​
故障排查

Hermes 安装脚本要从 GitHub 拉东西。国内网络不稳的话，先 git clone https://github.com/NousResearch/hermes-agent 手动拉，然后看 README 的本地安装方式。
  • 数字 ID 填错：Bot 只回复你的 ID，错了就装聋
  • 网络问题：Bot 进程要能访问 api.telegram.org，被墙就要走代理
  • 检查 Hermes 日志：默认在 ~/.hermes/logs/
hermes model 重设 Base URL 与 Key。注意 Base URL 必须带 /v1 后缀。
hermes setup
会重新走一遍配置向导，模型 / 消息通道全部重设。

​
相关

​
加群 & 客服

AI 技术交流群二维码
专属客服二维码