Hermes Agent 安装指南

在 Mac mini M4 上从零装好
并连接 Telegram 和微信

⏱ 真正安装只需 5 分钟

环境检查

先打开终端,跑下面的命令检查。

如果没装,点击这行展开安装步骤。

🍺 Homebrew brew --version 未安装?点我展开

Homebrew 是 Mac 的软件管家。

$ /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

中途按回车继续,输入 Mac 密码(输入时看不到字符)。

装完后:

$ echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc && source ~/.zshrc

验证:

$ brew --version
Homebrew 4.x
🐍 Python 3.11+ python3.11 --version 未安装?点我展开

用 Homebrew 安装 Python 3.11:

$ brew install python@3.11

验证:

$ python3.11 --version
Python 3.11.x
🟢 Node.js 22+ node --version 未安装?点我展开

用 Homebrew 安装 Node.js:

$ brew install node

验证:

$ node --version
v22.x.x
🔀 Git git --version 未安装?点我展开

用 Homebrew 安装 Git:

$ brew install git

验证:

$ git --version
git version 2.x
✅ 四个环境都装好了?直接跳到第 1 步。
1

一键安装 Hermes Agent

$ curl -fsSL https://raw.githubusercontent.com/NousResearch/Hermes-Agent/main/scripts/install.sh | bash

装完后刷新终端配置:

$ source ~/.zshrc

验证:

$ hermes --version
→ 显示版本号
2

在 Telegram 创建 Bot

打开 Telegram,搜索 @BotFather

给他发消息:

/newbot

按提示操作:

① 输入显示名称(比如 Hermes

② 输入用户名(必须以 bot 结尾,比如 YourNameHermesBot)

③ BotFather 返回一个 Token:

Use this token to access the HTTP API:
7234567890:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw

复制 Token 保存好。

⚠️ Token 是密码,不要发给别人。

再搜索 @userinfobot

给他发任意消息,返回的数字就是你的用户 ID。

比如 85259801528,也记下来。

3

配置 Telegram 连接

$ hermes gateway setup

按提示填入 Token 和用户 ID。

其他选项保持默认即可。

4

启动并测试

$ hermes gateway run

看到:

✓ Telegram gateway started

打开 Telegram,给你的 Bot 发 你好

能回复说明配置成功。

⚠️ 关掉终端 Hermes 就会停。
下一步设置开机自启就不用管了。
5

设置开机自启

$ hermes gateway install

搞定。以后 Mac 开机 Hermes 自动运行。

💡 其他命令:
hermes gateway status 查看状态
hermes gateway stop 停止
hermes gateway restart 重启
hermes logs 查看日志
hermes update 升级
6

(可选)配置微信

微信连接方式与 Telegram 不同。

需要用到微信的 ilink 协议,稍微复杂一些。

建议先配好 Telegram。

到时候需要帮助可以随时问我。

🎉

全部完成

出门在外,打开 Telegram 就能跟 Hermes Agent 聊天了。