Hermes Agent 安装指南

✓

环境检查

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

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

🍺 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 聊天了。