Hermes Agent 从零安装到微信接入（Mac 2026 完整教程）

2026年最火的AI Agent框架是什么？不是Claude Code，不是Codex，而是Hermes Agent——来自Nous Research开源的AI智能体，上线不到3个月GitHub星标突破52K。它最厉害的地方：一个API Key可以接入600+模型，支持微信/Telegram/Discord等10+平台，还能自我进化。今天这篇带你从零开始，在Mac上装好Hermes，接上DeepSeek，再打通微信，全程不超过20分钟。

一、Hermes Agent 是什么？为什么值得装？

Hermes Agent 是 Nous Research 在2026年推出的开源AI Agent框架。官方给它的定位是：「The agent that grows with you」——一个会和你一起成长的智能体。

和 Claude Code、Codex 这些纯粹的编程助手不同，Hermes 从一开始就走的是"全能私人助理"路线：

• ✅ 多模型支持：支持20+提供商（DeepSeek、OpenAI、Anthropic、MiniMax、百炼……），一个Key接入天下模型
• ✅ 多平台接入：微信、Telegram、Discord、Slack、Signal……你在哪聊天它就在哪
• ✅ 自我进化：通过Skill系统积累经验，越用越聪明，越用越懂你
• ✅ 持久记忆：跨会话记住你的偏好，换个平台聊天也不失忆
• ✅ 定时任务：Cron调度，每天自动推送早报、监控基金、抓热搜

简单说：装一个Hermes，等于拥有了一个会写代码、会聊天、会帮你盯盘的私人AI管家。

二、安装前准备

在开始安装之前，确保你的 Mac 满足以下条件：

2.1 系统要求

• macOS 12.0 及以上（推荐 macOS 14+）
• Python 3.10 及以上
• Node.js 18 及以上（微信网关需要）
• Git
• 至少 2GB 可用磁盘空间

2.2 检查环境

打开终端，逐一检查：

# 检查 Python
python3 --version
# 输出：Python 3.11.x（或更高）

# 检查 Node.js
node --version
# 输出：v18.x.x（或更高）

# 检查 Git
git --version
# 输出：git version 2.x.x

如果缺少某个工具，用 Homebrew 安装：

# 安装 Homebrew（如果没有的话）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装 Python
brew install python@3.11

# 安装 Node.js
brew install node@18

# 安装 Git
brew install git

2.3 准备 DeepSeek API Key

Hermes 需要一个大模型来驱动。推荐使用 DeepSeek V4 Pro：

1. 访问 DeepSeek Platform 注册账号
2. 进入「API Keys」页面，点击「创建 API Key」
3. 复制保存好 Key（格式如 sk-xxxxxxxx）
4. 新用户注册赠送 500 万 tokens 免费额度，够玩很久了

三、安装 Hermes Agent

3.1 一键安装（推荐）

打开终端，复制下面的命令直接运行：

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

安装过程大约需要 1-3 分钟，脚本会自动完成：

• 下载 Hermes Agent 代码到 ~/.hermes/hermes-agent/
• 创建 Python 虚拟环境并安装依赖
• 在 ~/.hermes/ 下创建配置目录

安装完成后，验证一下：

hermes --version
# 输出：hermes 0.x.x（具体版本号）

3.2 配置模型

安装完成后，运行配置向导来设置模型：

hermes setup model

会进入交互式界面，按以下步骤操作：

1. 选择 Provider：DeepSeek
2. 选择模型：deepseek-v4-pro（推荐）
3. 输入 API Key：粘贴你刚才在 DeepSeek Platform 获取的 Key

或者直接修改配置文件：

hermes config set model.default deepseek-v4-pro
hermes config set model.provider deepseek
hermes config set model.base_url https://api.deepseek.com

API Key 写在 ~/.hermes/.env 文件中：

echo "DEEPSEEK_API_KEY=sk-你的Key" >> ~/.hermes/.env

3.3 测试是否配置成功

hermes doctor

如果输出全部绿色 ✅，说明配置成功。可以试一下聊天：

hermes chat -q "你好，介绍一下自己"

看到回复就说明一切正常运行了！

四、接入微信（WeChat）

光是终端聊天多没意思？接下来把 Hermes 接入微信，让你在手机上随时随地召唤它。

4.1 安装微信网关依赖

微信网关需要额外的Python依赖：

pip3 install aiohttp cryptography

4.2 启动网关扫码登录

Hermes 微信接入通过 iLink Bot API 实现，需要扫码登录。

步骤1：先停止已有网关

hermes gateway stop

步骤2：运行网关登录

hermes gateway setup

选择 Weixin/WeChat，系统会生成一个 https://liteapp.weixin.qq.com/... 的链接。

步骤3：扫码登录

在手机上打开这个链接，用微信扫码确认登录。成功后系统会自动保存凭证。

步骤4：验证连接

hermes gateway status
# 看到 Weixin → configured / OK 就说明连上了

4.3 安装网关为后台服务（可选但推荐）

为了让 Hermes 开机自启、持续在线，安装为系统服务：

hermes gateway install
# 启动
hermes gateway start
# 查看状态
hermes gateway status

现在你就可以在微信里给 Hermes 发消息了！试着发一句"你好"，它会秒回你。

五、进阶玩法推荐

装好只是第一步，Hermes 还有这些骚操作：

5.1 安装实用 Skill

# 浏览可用的 skills
hermes skills browse

# 安装热搜监控
hermes skills install hot-topics

# 安装基金监控
hermes skills install fund-monitor

5.2 设置每日定时任务

让 Hermes 每天早上 7:30 自动给你推送早报：

# 在 Hermes 对话中直接说：
# "帮我建一个每天早上7:30推送新闻简报的定时任务"

5.3 配置多个模型

日常聊天用 Flash（快又便宜），写代码切 Pro（强）：

# 对话中直接切模型
/model deepseek-v4-flash
/model deepseek-v4-pro

六、常见问题排查

七、总结

回顾一下整个安装流程：

1. 准备 Python 3.10+、Node.js 18+、Git
2. 注册 DeepSeek 获取 API Key
3. 一行命令安装 Hermes：curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
4. 配置模型：hermes setup model 选 DeepSeek V4 Pro
5. 接入微信：hermes gateway setup 扫码登录
6. 安装后台服务：hermes gateway install

Hermes Agent 是目前体验最完整的开源AI Agent之一。它不像Claude Code那样只专注代码，也不像Codex那样需要折腾协议转换，而是一个开箱即用的全能助理——从聊天到写代码，从推送到监控，一个Agent全搞定。

更何况它是完全开源免费的，配上DeepSeek的便宜API，日常使用的成本几乎可以忽略不计。

下篇预告：Hermes Agent vs OpenClaw 深度对比——同为52K Star的明星项目，到底谁更适合你？敬请期待。

如果这篇文章帮到了你，欢迎转发给更多朋友 🚀

]]>

本文链接：https://www.kkkliao.cn/?id=3892 转载需授权！