Hermes Agent 安装与接入指南(Windows/WSL2 + Telegram)

Hermes Agent 和 OpenClaw 都能接入聊天软件、能记忆、能用工具，但产品重心完全不同。

>

- Hermes 是 agent-first：核心是“一个智能体持续工作”。重点放在长期运行、跨会话记忆、技能沉淀和逐步调顺。

- OpenClaw 是 gateway-first：核心是“多个助手统一接入和调度”。重点放在跨平台消息接入、会话路由、多 agent 编排与治理。

- 怎么选：如果你要的是一个助手越用越顺、经验能持续沉淀，Hermes 更合适；如果你要的是多渠道、多助手、统一入口和统一管理，OpenClaw 更合适。

我两个都要试一试。

一、先说结论：Windows 原生不支持，推荐 WSL2

Hermes Agent 的官方快速安装脚本主要面向 Linux/macOS 环境。

Windows 原生（PowerShell / CMD）并不在支持范围内。

所以 Windows 用户最稳的路线是：

• 先装 WSL2（相当于在 Windows 里跑一套 Ubuntu）
• 然后在 Ubuntu 终端里按 Linux 的方式安装 Hermes

官方 README 也明确写了：Windows 需要 WSL2。

二、Windows 安装（WSL2 + Ubuntu 22.04 推荐）

2.1 安装 WSL2

用管理员权限打开 PowerShell，执行：

执行后按提示重启。重启后从开始菜单打开 Ubuntu，首次启动会让你创建 Linux 用户名与密码。

确认 WSL 版本：

看到 VERSION 为 2 即可。

2.2 在 Ubuntu（WSL2）中一键安装 Hermes

打开 Ubuntu 终端，执行：

装完后刷新你的 shell 环境（按你使用的 shell 选一个）：

验证安装：

这一键安装脚本会处理大部分依赖（Python/Node 等），你通常不需要手动装一堆环境。

三、首次配置：选择模型提供商与密钥

Hermes 有两种常见入口：

• hermes setup
  ：一次性完成大部分配置（推荐新手）
• hermes model
  ：专门切换/配置模型提供商

3.1 推荐：先跑全量向导

向导会引导你：

• 选择 LLM provider（比如 OpenRouter、OpenAI 等）
• 填写 API Key

-（可选）配置 Gateway（Telegram 等）

3.2 关于 Anthropic（Claude）的现实情况

最近一个很现实的变化是：Anthropic 基本不再允许“直接用订阅/账号做第三方连接”的方式，通常只能走 API Key（按量计费）。

• 代价：按 token 计费，重度使用会明显更贵

因此很多人现在会更倾向：

• 用 OpenRouter 之类的聚合平台（可在多个模型间切换，账单更可控）
• 或者使用更便宜/更适配任务的模型组合

四、接入 Telegram（以及其他消息平台）

Hermes 的“跨平台对话”靠的是 Gateway：它是一个后台进程，负责把 Telegram/Discord/飞书等平台收到的消息转给 Hermes，再把回复发回去。

Hermes 官方文档把它称为 Messaging Gateway。

4.1 快速配置（交互式向导）

这个向导会：

• 让你选择要接入的平台（Telegram / Discord / Slack / Feishu…）
• 提示你填入对应的凭证
• 完成后可引导你启动/重启 gateway

4.2 Gateway 常用命令（建议收藏）

为了在公众号里不乱序、又不显得啰嗦，建议用一组“命令 + 注释”写在同一个代码块里：

4.3 Telegram 需要准备什么（实操要点）

你一般需要：

• Bot Token
  （通过 Telegram 的 @BotFather 创建 bot 获取）
• 一个安全策略：只允许你自己使用（强烈推荐）

Hermes 的 Gateway 文档里明确提到：

• 可以使用 allowlist（允许的用户 ID 列表，例如 TELEGRAM_ALLOWED_USERS=...）
• 或者使用 DM pairing（私聊配对码，hermes pairing approve ...）

这一点很关键：因为一旦你的 bot 被陌生人聊到，而 Hermes 又有终端/文件权限，会有安全风险。

4.4 会话重置策略（可选但很实用）

Gateway 支持“不同平台不同会话重置策略”，文档给了一个例子：在 ~/.hermes/gateway.json 里配置。

示例可以直接写成一行，公众号里更干净：{"reset_by_platform":{"telegram":{"mode":"idle","idle_minutes":240},"discord":{"mode":"idle","idle_minutes":60}}}

这段配置的意思很简单：Telegram 按空闲 240 分钟重置会话，Discord 按空闲 60 分钟重置会话。也就是说，不同平台可以单独设置“多久没人说话就开新上下文”。我经常一天后还要接着上次的对话，还不知道如何设置。我在openclaw都是主动用/new重开对话。

五、常见问题

5.1 安装完找不到 hermes 命令

• 先 source ~/.bashrc（或 source ~/.zshrc）刷新环境
• 再试 hermes --version

5.2 Gateway 配好了但 Telegram 没反应

• 先在终端跑前台模式看日志：

• 检查你是否配置了 allowlist / pairing，但还没把自己放行
• 检查 bot token 是否填错