Hermes Agent
安装配置指南

按下键盘上的 Command + 空格，弹出搜索框。

输入 终端（或 Terminal），按回车打开。

之后所有操作都在这个黑窗口里输入命令。

• □ 终端已经打开了

复制下面这行命令，粘贴到终端里按回车：

安装过程中会问你要不要继续，按回车确认即可。可能会让你输入 Mac 密码（输入时屏幕上看不到字符，正常现象）。

• □ Homebrew 安装完成
• □ brew --version 显示版本号

复制并运行这两条命令（一条一条执行）：

• □ Git 安装完成
• □ Python 3.12 安装完成

复制并执行：

• □ Hermes 仓库下载完成

依次执行以下三条命令：

• □ 虚拟环境创建完成
• □ 依赖安装完成（无红色错误）

Hermes 需要一个 AI 模型的 API Key 才能工作。推荐方案：

复制模板文件并编辑：

然后用以下命令打开配置文件（会打开一个文本编辑器）：

找到文件中的 provider: 部分，改成这样：

把 你的API密钥 替换成你在 OpenRouter 复制的真实 Key。

保存文件（Command + S），然后关闭。

• □ 已注册 OpenRouter
• □ 已创建 API Key 并填入 config.yaml
• □ 文件已保存

① 创建 Bot

在 Telegram 搜索 @BotFather，点 Start，然后输入：

按提示输入你的 Bot 名字（比如 MyHermesBot），然后输入用户名（比如 my_hermes_bot）。

BotFather 会给你一个 Token，类似 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11——复制保存好。

② 获取你的 Chat ID

在 Telegram 搜索 @userinfobot，点 Start，它会直接发给你一个数字 ID（比如 123456789）。复制下来。

③ 填到配置里

再次打开 config.yaml，找到 telegram: 部分，改成：

保存文件。

• □ Bot Token 已获取
• □ Chat ID 已获取
• □ 配置已保存

在终端中（确保在 ~/hermes-agent 目录，虚拟环境已激活）：

看到类似这样的输出就成功了：

现在打开手机 Telegram，找到你刚创建的 Bot，发一条消息试试！

• □ Hermes 成功启动
• □ Telegram Bot 回复成功

打开 Mac 的 系统设置 → 通用 → 登录项。

点 + 号，添加一个启动脚本：

先创建一个启动文件：

在打开的编辑器里输入以下内容：

按 Control + O 保存，然后 Control + X 退出。

最后让这个文件可执行：

然后再去 系统设置 → 通用 → 登录项，把这个文件加进去。

• □ 启动脚本已创建
• □ 已添加到登录项