Hermes Agent 桌面版保姆级教程：从安装到接入飞书机器人，小白也能拥有的本地 AI Agent

下载安装包双击安装，电脑就有了一个 7×24 小时在线的 AI 助手，还能接飞书

📌 一、引言

你有没有想过，给你的电脑装一个 AI 管家？

不是那种网页里聊几句就断的 ChatGPT，而是一个一直活着、随叫随到、能帮你干活的 AI。

它可以：

• 帮你写代码、部署项目、修 bug
• 在飞书群里自动回复消息、执行任务
• 定时发日报、查天气、监控服务器
• 记住你的偏好，越用越懂你
• 甚至替你管理其他 AI 工具

以前想搭一个这样的 AI Agent，需要懂 Python、配环境、搞命令行，没点技术基础还真搞不定。

但现在不一样了。

Hermes Agent 桌面版 正式发布了——一个安装包搞定全部环境，Windows / macOS / Linux 全平台支持，下载双击就能用。

由 Nous Research 开发，完全开源，支持 DeepSeek、OpenAI、Claude 等 20 多种模型，还能接入飞书、Telegram 等聊天平台。

它还有一个「技能」机制：它做过的事情可以保存为技能，下次遇到类似任务直接复用，越用越顺手。

这篇文章手把手带你从零搭建 Hermes Agent，从下载安装到配置飞书机器人，跟着步骤走就行。

🔍 二、Hermes Agent 是什么？

一句话

Hermes Agent 是一个开源的 AI Agent 框架，它跑在你的电脑上，可以调用各种工具（写文件、执行命令、搜索网页），通过聊天平台或终端与你交互。

桌面版跟以前最大的区别是：安装不再需要敲命令行。 下载一个安装包，双击运行，自动配置好全部环境。

它和 ChatGPT 有什么区别？

核心特色

1. 多平台接入

Hermes 有一个叫 Gateway 的网关模块，可以把同一个 AI Agent 连接到多个聊天平台。你在飞书上跟它说话，和在电脑终端里跟它说话，用的是同一个能力。

支持的平台包括：飞书、Telegram、Discord、Slack、WhatsApp、微信、钉钉等。

2. 模型自由切换

Hermes 不绑定任何模型。你可以随时切换：

• DeepSeek（推荐国内用户使用）——国内直连，便宜，中文好，注册送 500 万 token
• OpenAI GPT-4o——综合能力最强
• Anthropic Claude——编程和长文档最强
• 通义千问 / GLM 智谱——国内厂商，直连可用
• 本地模型（通过 Ollama）

同一个工作流，换模型不需要改任何配置。

3. 技能机制

这是 Hermes 最独特的设计。当它完成一个复杂任务后，你可以把解决步骤保存为一个「技能」。以后遇到类似问题，技能会自动加载，它就知道怎么做了。

技能会随着使用不断积累和优化——相当于你的 AI 持续在变聪明。

4. 持久记忆

Hermes 能跨会话记住你的信息：你的名字、偏好、常用路径、API 位置等等。你不需要每次都重新介绍自己。

5. 定时任务

支持 cron 定时任务。设置一次，Hermes 会按时自动执行，把结果发到你的飞书或 Telegram。

📥 三、下载与安装桌面版

系统要求

下载 Hermes 桌面版安装包

打开官网 https://hermes-agent.nousresearch.com，点击「Download Desktop」按钮，下载对应系统的安装包：

⚠️ 国内用户注意： 官方网站可以直接访问，不需要科学上网。如果下载慢，可以试备用方式（见文末）。

安装步骤（Windows）

1. 双击下载的 Hermes-Setup.exe
2. 按照安装向导的提示完成安装（一路默认即可）
3. 安装完成后，桌面会出现 Hermes 的图标
4. 双击图标启动 Hermes

安装程序会自动完成：

• 安装 Python 环境（Hermes 自带，不影响你电脑上已有的 Python）
• 安装全部依赖
• 创建默认配置文件
• 弹出配置向导

整个过程不需要敲任何命令。

首次配置：选择 AI 模型

首次启动时，配置向导会引导你设置 AI 模型。这里推荐国内用户选择 DeepSeek：

1. 在向导中选择 DeepSeek
2. 输入你的 API Key
3. 选择模型版本（推荐 deepseek-v4-flash，速度快性价比高）
4. 点击保存

怎么获取 DeepSeek API Key：

1. 打开 https://platform.deepseek.com
2. 用手机号注册账号
3. 进入「API Keys」页面
4. 点击「创建 API Key」，复制保存（创建后只显示一次，记得立即复制）
5. 新用户有 500 万 token 赠送，够用很久

其他国内容易获取的模型：

验证是否安装成功

配置完成后，在命令行（CMD 或 PowerShell）中输入：

hermes doctor

如果看到类似下面的输出，说明安装成功：

✅ Environment: OK✅ Dependencies: OK

然后发一条消息测试：

hermes chat -q "你好，用一句话介绍你自己" -Q

正常回复了，就说明跑起来了！🎉

📱 四、接入飞书机器人（扫码绑定，超简单）

这是很多人最期待的功能——让 Hermes 变成你的飞书 AI 助手。

而且现在超级简单了，因为 Hermes 支持两种方式：

1️⃣ 推荐：扫码绑定（最简单）

• 运行一条命令 → 弹出二维码 → 飞书扫码 → 自动完成
• 不需要公网 IP，不需要端口转发（用 WebSocket 模式）
• 飞书应用会自动创建，权限自动配好

2️⃣ 备选：手动配置

• 传统方式，适合需要自定义设置的高级用户

下面介绍第一种，也是最推荐的方式。

扫码绑定（全程 2 分钟）

第一步：运行配置命令

打开命令行（CMD 或 PowerShell），输入：

hermes gateway setup

用方向键选择 Feishu / Lark，回车。

第二步：扫码授权

终端会显示一个二维码。打开手机飞书，扫描二维码，确认授权。

Hermes 会自动完成以下全部操作：

• 在飞书开放平台创建机器人应用
• 配置好所有权限
• 保存凭证
• 设置 WebSocket 连接

不需要你自己去飞书开放平台手动创建应用。

第三步：启动 Gateway

hermes gateway run

看到如下输出说明连接成功：

INFO: Starting gateway...INFO: Feishu platform connected ✓ (WebSocket)

然后去飞书给你的机器人发一条消息试试吧！🎉

💡 小提示： 如果想让 Gateway 在关掉命令行后继续在后台运行：

hermes gateway installhermes gateway start

可选：手动配置方式

如果扫码不可用（比如你在没有手机扫码的环境），也可以手动配置：

1. 打开 飞书开放平台
2. 创建应用 → 获取 App ID 和 App Secret
3. 运行 hermes gateway setup，选择 Feishu，手动输入凭证
4. 在飞书开放平台配置需要的权限和事件
5. 发布应用
6. 启动 Gateway

⚠️ 手动配置的注意： 默认使用 WebSocket 模式，不需要配置回调地址和公网 IP。只有你需要用 Webhook 模式时才需要公网地址。

📡 五、接入 Telegram

如果你更习惯用 Telegram，配置比飞书简单。

⚠️ 国内用户注意： Telegram 需要科学上网才能使用。如果你没有科学上网条件，直接用飞书就好。

第一步：创建 Telegram Bot

1. 在 Telegram 中搜索 @BotFather
2. 发送 /newbot
3. 按提示设置名称和用户名（用户名必须以 _bot 结尾）
4. BotFather 会返回一个 token，格式如 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11

第二步：配置 Hermes

运行：

hermes gateway setup

选择 telegram，粘贴刚才的 token。

第三步：启动或重启 Gateway

如果 Gateway 已经启动过，重启即可：

hermes gateway restart

现在去 Telegram 搜索你的机器人名字，发送 /start 就可以开始对话了。

🎯 六、实战场景

场景 1：分析服务器日志

直接在飞书或终端中说：

帮我分析一下 /var/log/nginx/access.log，找出过去一小时内访问最频繁的 10 个 IP，保存到桌面上的 report.txt

Hermes 会自动完成。

场景 2：搭一个 Web 服务

在当前目录下创建一个 Flask Web 应用，用户注册登录功能，使用 SQLite 数据库，创建完成后启动

Hermes 会创建目录、写代码、装依赖、初始化数据库、启动服务。

场景 3：自动日报（定时任务）

设置一个每天早上的定时任务，自动生成日报发到飞书：

hermes cron create "0 9 * * 1-5" \  --name "日报生成" \  --prompt "查看 ~/work/notes/ 目录下的今日笔记，生成一份工作日报，用 Markdown 格式发到飞书" \  --deliver feishu

周一到周五每天早上 9 点，Hermes 自动执行，日报直接发到你飞书。

场景 4：保存常用技能

每次完成复杂任务后，可以问 Hermes：

把这个工作流保存为技能，以后叫我用「部署 Flask 项目」来执行

下次你直接说「部署 Flask 项目」，Hermes 就自动知道怎么做了。

⚠️ 七、常见问题

Q1：下载不了安装包怎么办？

官网可以直接访问。如果下载慢，可以试试：

• 私信发送“2121”
• 或者在 GitHub Releases 页面找最新版的安装包（可能需要科学上网）

Q2：飞书机器人没响应？

按顺序排查：

1. 确认 hermes gateway run 已经启动，没有报错
2. 确认飞书开放平台的回调地址填写正确
3. 确认应用已经发布上线
4. 检查日志：cat ~/.hermes/logs/gateway.log | grep error

Q3：国内能用吗？

完全可以用。推荐方案：

• 模型用 DeepSeek（国内直连、便宜、中文好）
• 平台接 飞书（国内正常使用）
• 下载安装包从官网直接下（国内可访问）

Q4：要花多少钱？

只花模型 API 的费用。

DeepSeek 的价格：输入 1 元/百万 token，输出 2 元/百万 token。日常使用一个月大概几块钱到十几块钱。新用户还送 500 万免费 token，够用很久。

相比 ChatGPT Plus 一个月 20 美元（约 140 元人民币），Hermes 不到十分之一的费用。

Q5：能同时接飞书和 Telegram 吗？

可以。Hermes 支持同时接入多个平台，各平台互不影响。

💭 八、写在最后

Hermes Agent 桌面版最大的意义在于——它把 AI Agent 带到了普通用户面前。

以前想拥有一个自己的 AI 助手，要么会编程，要么懂命令行，要么愿意折腾环境配置。现在只需要下载一个安装包，双击运行，几分钟就能搞定。

每个月花几块钱的 API 钱，就换来一个 7×24 小时在线的 AI 助手。它不会请假，不会摸鱼，而且越用越好用。

动手试试吧。

下载链接：私信发送“2121”获取夸克下载链接

有问题欢迎在评论区留言交流。

本文基于 Hermes Agent 桌面版 v0.17.0（2026 年 6 月版本）编写。开源项目迭代很快，建议定期运行 hermes update 保持最新。