Question 1

Windows 一定要装 WSL2 吗？（直装版可行吗？）

Accepted Answer

目前推荐通过 WSL2 安装，因为 Hermes 的依赖在 Linux 环境下更稳定。Windows 直装版仍在实验阶段，遇到问题可以优先使用 WSL2 方案。

Question 2

没有 OpenAI API key 怎么办？（国产模型接入方案）

Accepted Answer

你可以在 ~/.hermes/config.yaml 中配置国产模型（如 DeepSeek、豆包、通义千问）的 API key。格式与 OpenAI 兼容，只需修改 base_url 和 model 名称即可。

Question 3

迁移后 Telegram bot 为什么不回复？

Accepted Answer

请检查三点：1) BotFather 中是否设置了 webhook；2) token 是否已过期；3) Hermes 日志中是否有连接报错。常见修复方式是重新获取 token 并重启 Hermes。

Question 4

飞书机器人配置时 webhook 报错怎么办？

Accepted Answer

飞书 webhook 需要正确的 IP 白名单和事件订阅配置。请确认你的服务器地址可以被公网访问，并在飞书开发者后台开启「机器人」和「事件订阅」权限。

Question 5

如何更新 Hermes 到最新版本？

Accepted Answer

运行 pip install -U hermes-agent 即可升级到最新版本。升级后建议执行 hermes --version 确认版本号。

Question 6

本指南内容多久更新一次？

Accepted Answer

我们承诺在 Hermes 发版后 7 天内检查并更新命令和截图。同时每月进行一次全站内容巡检，确保教程与最新版本保持一致。

常见问题