如何安装和使用 Hermes：从本地 CLI 到 Feishu 接入快速上手

2026年4月13日

想安装并开始使用 Hermes，最短路径其实只有三步：

1. 运行官方安装命令
2. 在终端里用 hermes 启动 CLI
3. 如果你想在飞书里继续用，再配置 hermes gateway setup

这篇文章不打算把 Hermes 的所有能力一次讲完，而是先帮你完成最关键的入门闭环：装上、跑起来、开始用，然后再接一个最常见的消息平台场景。

Hermes 是什么，适合谁用

Hermes Agent 是一个既可以在本地终端使用，也可以通过消息平台网关使用的 AI agent。

对大多数开发者来说，它有两个最常见的入口：

• CLI：在终端里输入 hermes，直接进入交互式界面
• Messaging Gateway：运行 hermes gateway，再从 Feishu、Telegram、Discord、Slack 等平台和它对话

如果你现在的目标只是快速上手，建议顺序不要反过来，先走这条路线：

• 先安装 Hermes
• 先从 CLI 验证是否可用
• 再决定要不要接消息平台

这样更容易定位问题，也更适合第一次接触 Hermes 的用户。

安装 Hermes 之前要知道什么

根据 Hermes README，官方快速安装路径支持这些环境：

• Linux
• macOS
• WSL2
• Android via Termux

Windows 用户注意事项

Hermes 当前不支持原生 Windows 直接运行。如果你使用 Windows，推荐先安装 WSL2，再在 WSL2 里执行安装命令。

这点最好在文章开头就说清楚，因为很多安装失败其实不是命令问题，而是运行环境不符合要求。

如何安装 Hermes

Hermes README 给出的快速安装命令是：

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

这条命令会执行官方安装脚本，处理平台相关的初始化流程。

安装完成后刷新 shell

安装结束后，先重新加载 shell 环境。最常见的是：

source ~/.bashrc

如果你用的是 zsh，也可以改成：

source ~/.zshrc

如何确认 Hermes 已经装好

最直接的检查方式就是运行：

hermes

如果你想进一步确认配置和依赖是否正常，可以再执行：

hermes doctor

hermes doctor 适合在这些时候使用：

• 安装后命令行为不正常
• 模型配置失败
• gateway 启动失败
• 不确定环境依赖是否完整

第一次如何开始使用 Hermes

先从 CLI 开始

如果你只是想尽快确认 Hermes 能不能用，最简单的方法就是：

hermes

这会启动 Hermes 的交互式 CLI。对于第一次接触 Hermes 的用户，这也是最推荐的起点，因为你可以先验证最核心的几件事：

• 命令是否真的可用
• 当前模型配置是否正常
• 终端工具链是否工作正常
• 交互体验是不是你需要的那种方式

这几个命令足够你完成第一轮配置

Hermes README 里列出的几条高频命令，基本就构成了第一轮上手路径：

hermes model
hermes tools
hermes config set
hermes setup
hermes update
hermes doctor

如果你不知道它们各自是做什么的，可以先这样记：

• hermes model：选模型、切模型
• hermes tools：看和配当前可用工具
• hermes config set：改具体配置项
• hermes setup：跑一次完整初始化向导
• hermes update：更新 Hermes
• hermes doctor：做故障排查

对新手最实用的顺序通常是：

1. 先运行 hermes model
2. 如果你希望一次把常用项配完整，再运行 hermes setup

Hermes 最常见的两种使用方式

1. 在终端里把 Hermes 当成日常开发助手

CLI 模式适合这些场景：

• 本地写代码时直接问问题
• 查项目、改文件、跑命令
• 做一次性调试或 review
• 在当前工作目录里持续协作

它最大的优点就是路径最短：不用额外接平台，不用先处理机器人配置，也最适合建立第一轮使用习惯。

2. 通过消息平台使用 Hermes

如果你希望在飞书、Telegram、Discord 等平台上和 Hermes 对话，就需要使用 messaging gateway。

最常见的入口命令是：

hermes gateway setup
hermes gateway

其中：

• hermes gateway setup 用来做交互式平台配置
• hermes gateway 用来启动网关进程

根据官方文档，gateway 是一个统一的后台进程，用来连接你已配置的平台、管理会话，并处理定时任务等功能。

以 Feishu 为例，如何把 Hermes 接入消息平台

如果你的日常工作主要在飞书里，那么 Feishu/Lark 会是一个很自然的 Hermes 接入方式。

最小可行接入方式

官方文档对 Feishu/Lark 的推荐入口是：

hermes gateway setup

运行后，在向导中选择 Feishu / Lark 即可。

Feishu 文档给出的两种连接模式是：

• websocket：推荐
• webhook：可选

如果 Hermes 跑在你的笔记本、工作站或者私有服务器上，优先使用 websocket 会更简单，因为不需要额外暴露公网回调地址。

如果你手动配置，至少要知道这些变量

如果你不是通过向导配置，而是手动写配置，Feishu 文档里列出的核心变量包括：

FEISHU_APP_ID=cli_xxx
FEISHU_APP_SECRET=***
FEISHU_DOMAIN=feishu
FEISHU_CONNECTION_MODE=websocket

FEISHU_ALLOWED_USERS=ou_xxx,ou_yyy
FEISHU_HOME_CHANNEL=oc_xxx

其中最值得注意的是两项：

• FEISHU_ALLOWED_USERS：建议配置，避免任何能接触到 bot 的人都可以直接使用它
• FEISHU_HOME_CHANNEL：可以预先指定一个 home chat，用来接收 cron 结果或默认通知

Feishu 群聊里为什么有时不回复

这一点很容易被忽略：在 Feishu 群聊里，Hermes 默认不是看到每条消息都响应。

官方文档明确说明：

• 私聊时，Hermes 会响应消息
• 群聊里，必须显式 @ bot，它才会处理消息

如果你想把某个飞书会话设成 home channel，也可以在聊天里使用：

/set-home

或者提前在配置里写：

FEISHU_HOME_CHANNEL=oc_xxx

新手最值得先记住的 Hermes 命令

不管你是在 CLI 里，还是在消息平台里，先记住下面这些命令就已经够用了：

• /new 或 /reset：开始新会话
• /model：查看或切换模型
• /retry：重试上一轮
• /undo：撤销上一轮交互
• /compress：手动压缩上下文
• /help：查看帮助

如果你主要在消息平台里使用，再额外记住一个：

• /sethome 或 /set-home：把当前聊天设为 home channel

这些命令覆盖了新手阶段最常见的操作：重开、调整、回退、查看和继续用。

常见问题

Windows 能直接安装 Hermes 吗？

不能。当前官方文档明确说明，原生 Windows 不支持，推荐使用 WSL2。

安装之后输入 hermes 没反应怎么办？

建议按下面顺序排查：

1. 先重新加载 shell，例如 source ~/.bashrc
2. 再重新运行 hermes
3. 如果还是异常，执行 hermes doctor

Feishu 群里为什么 bot 不回复？

先检查这三项：

• 你有没有在群里 @ Hermes
• FEISHU_ALLOWED_USERS 是否限制了当前用户
• 当前群聊策略是否允许处理群消息

根据官方 Feishu 文档，群聊场景里，显式 @mention 是必要条件。

下一步建议

如果你只是想尽快开始使用 Hermes，最推荐的顺序是：

1. 先执行安装命令
2. 先用 hermes 在本地 CLI 里开始
3. 再用 hermes model 和 hermes setup 补齐基础配置
4. 如果你希望在飞书里继续使用，再配置 hermes gateway setup

如果这篇文章作为一个系列的第一篇，它最适合承担的角色不是“把所有高级功能一次讲完”，而是先把用户带进门。

后续更适合继续拆分成这些主题：

• Hermes Feishu 接入完整指南
• Hermes 常用 slash commands 指南
• Hermes gateway 配置与排错指南

如果你准备继续做 Hermes 内容，这篇就可以作为后续文章的起点，并逐步把内部链接体系补起来。

标签:

• Hermes
• CLI
• 安装指南
• Feishu

如何实现 Claude Code 和 Codex 等 Agent CLI 的自动重试

AI 编程助手的幻觉问题：如何用 OpenSpec 实现规范驱动开发