安装指南

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

2026年4月13日

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

运行官方安装命令
在终端里用 hermes 启动 CLI
如果你想在飞书里继续用，再配置 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：做故障排查

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

先运行 hermes model
如果你希望一次把常用项配完整，再运行 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` 没反应怎么办？

建议按下面顺序排查：

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

Feishu 群里为什么 bot 不回复？

先检查这三项：

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

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

下一步建议

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

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

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

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

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