常见问题

当前推荐 Windows 用户使用 WSL2 运行 Hermes，这是最稳定的方案。直装版本可能遇到工具依赖缺失的问题，我们的教程以 WSL2 为主。

Hermes 支持多种模型提供商，你可以使用 Anthropic Claude、阿里通义千问、智谱 AI 等国产模型。只需在 config.yaml 中更换对应的 base_url 和 api_key。

请检查 webhook 地址是否更新为 Hermes 的服务地址，并确认 BotFather 中的 token 仍然有效。如果是轮询方式，请确保没有其他服务在打开该 token。

检查事件订阅里是否已正确勾选“消息”事件，确认 webhook 地址使用 HTTPS，并且服务器能够正常访问飞书的推送服务。

使用 pip 升级即可：pip install --upgrade hermes-agent。升级后建议重新检查 hermes --version 确认版本。

我们会在 Hermes 发布新版本后 7 天内检查并更新教程。你可以在页面顶部看到最后更新日期。