返回

Hermes Agent 安装教程

图片模式

这是一份给第一次安装 Hermes Agent 的用户看的极简教程。目标只有一个：先把 Hermes 跑通，再逐步打开模型、Skills、Telegram、自动任务等能力。

这里的 Hermes 是 NousResearch 的 Hermes Agent，不是 React Native 里的 Hermes JavaScript Engine。

1. Hermes Agent 是什么

Hermes Agent 是一个本地 AI 助手。它可以在桌面 App 里聊天，也可以在终端里运行命令、读写文件、分析项目，还能连接 Telegram、Discord、Slack 等消息入口。

第一次使用先记住一句话：Hermes Desktop 是最容易上手的入口，CLI 是更适合进阶和自动化的入口。两者共用同一套配置、模型、会话、Skills 和本地数据。

2. 先准备系统环境

这一步是为了避免安装时卡在 git、Python、系统工具这些基础问题上。

Mac 用户先确认 Apple Command Line Tools 是否存在：

xcode-select -p

如果没有看到类似 /Library/Developer/CommandLineTools 的路径，运行：

xcode-select --install

弹窗可能藏在其他窗口后面。点“安装”，等它完成。不需要下载完整 Xcode App。

Windows 用户建议使用 Windows 10/11。只装桌面版的话，直接下载安装包即可；如果还要用命令行，建议提前安装 Git for Windows，并使用 PowerShell。

3. 最推荐：先安装 Hermes Desktop

这一步是为了先获得一个可视化入口，降低第一次使用难度。

官方下载页：

https://hermes-agent.nousresearch.com/desktop

Mac 用户下载 macOS / Apple Silicon 版本。打开 dmg，把 Hermes 拖进 Applications，再打开 Hermes.app。

Windows 用户下载 Windows 安装包，按提示安装即可。

第一次打开后，先不要急着配置复杂功能。先确认 App 能正常启动，能进入聊天界面。

4. 可选：安装命令行 CLI

这一步是为了让你可以在终端里使用 Hermes，也方便后续做排查、配置 gateway、自动任务和开发工作。

Mac / Linux / WSL2：

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

安装后刷新终端环境：

source ~/.zshrc

如果你用的是 bash：

source ~/.bashrc

Windows PowerShell：

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

如果你只想先体验桌面版，可以暂时跳过 CLI；但长期使用建议装上。

5. 安装后先体检

这一步是为了确认 Hermes 的基础环境是否正常。

运行：

hermes doctor

再看当前状态：

hermes status

新手判断标准：

  • hermes doctor 没有关键错误。

  • Hermes Desktop 能正常打开。

  • 终端里输入 hermes 能进入对话。

  • 发一条简单消息后能正常回复。

不要把 .env、 auth.json、 hermes status --all 或完整日志公开发给别人，里面可能包含 API Key 或登录 token。

6. 配置模型

这一步是为了让 Hermes 有一个可以调用的大模型。没有模型，Hermes 就不能正常工作。

新手最简单的方式：

hermes setup --portal

这会使用 Nous Portal，适合想快速跑通的人。

如果你已经有自己的 API 或账号，可以运行：

hermes model

常见选择：

  • Nous Portal：最省事，适合新手。

  • OpenRouter：一个账号接很多模型，适合备用和多模型切换。

  • DeepSeek 官方 API：适合低成本、长期日常任务。

  • Gemini / OpenAI / Anthropic / xAI / Kimi / Qwen：按你已有账号选择。

  • Ollama / LM Studio：本地模型，适合折腾，但对电脑配置要求更高。

记住：Hermes 是 Agent，不是普通聊天机器人。它会读文件、调用工具、执行多步任务，所以模型上下文太小或能力太弱，会更容易失败。

7. 跑通第一条任务

这一步是为了确认“模型 + Hermes + 当前工作区”已经连起来。

桌面版里可以输入：

“请总结当前工作区，并告诉我你能做哪些事。”

终端里可以运行：

hermes

第一次成功的标准：

  • 能正常回复。

  • 没有明显报错。

  • 能继续下一轮对话。

  • 需要读文件时，会按权限正常读取。

如果这里还没跑通，不要继续配置 Telegram、Home Assistant、cron 或 MCP。先把基础对话跑通。

8. 基础 Skills 怎么选

这一步是为了让 Hermes 在特定任务上更稳定。Skill 可以理解为给 Agent 的专项操作手册。

新手不用一开始装很多 Skill。默认 Skills 先用起来就够。

建议重点熟悉：

  • plan：复杂任务前先让 Hermes 写计划，避免乱改。

  • systematic-debugging：排查问题时更有条理。

  • codebase-inspection：快速理解一个项目结构。

  • requesting-code-review：改完代码后做自查。

  • github-auth：配置 GitHub 登录、SSH、token。

  • github-pr-workflow：分支、提交、PR、CI 流程。

  • hermes-agent：配置和排查 Hermes 自身。

  • native-mcp：接入更多外部工具。

Mac 用户可以额外关注：

  • macos-computer-use：操作本机 App 和界面。

  • apple-notes：管理 Apple Notes。

  • apple-reminders：管理提醒事项。

  • imessage：按需接入 iMessage/SMS。

原则：先少装，先跑通，再按实际需求加。

9. 推荐配置顺序

这一步是为了降低排查难度。不要一开始全都打开。

推荐顺序：

  1. 安装 Hermes Desktop。

  2. 按需补装 CLI。

  3. 跑 hermes doctor。

  4. 配好一个模型。

  5. 完成一次本地对话。

  6. 熟悉默认 Skills。

  7. 再配置 Telegram / Discord / Slack。

  8. 再配置 Home Assistant、cron、MCP、自动任务。

10. Telegram 远程入口怎么配

这一步是为了让你可以在手机上和 Hermes 对话。

流程：

  1. 在 Telegram 找 BotFather。

  2. 创建一个 bot。

  3. 保存 Bot Token。

  4. 获取自己的 Telegram 数字 User ID。

  5. 运行 hermes gateway setup。

  6. 勾选 Telegram。

  7. 填 Bot Token。

  8. 填 allowed/admin user ID。

  9. 启动 gateway。

重要提醒：

  • Bot Token 等同密码，不要公开。

  • @username 不是 User ID。

  • User ID 通常是一串纯数字。

  • 没填 allowed user 时，机器人可能不会响应。

  • 想长期在线，Mac 用后台服务/launchd，Linux/VPS 用 systemd。

建议：先本地跑通，再开 Telegram。否则你会分不清是模型问题、Hermes 问题，还是 Telegram gateway 问题。

11. 本地安装还是 VPS 安装

这一步是为了决定 Hermes 应该运行在哪里。

建议装在本地电脑的情况：

  • 要读写本机文件。

  • 要操作桌面 App。

  • 要管理 Mac mini、Surge、Home Assistant。

  • 要访问家里局域网设备。

  • 要使用 Hermes Desktop。

建议装在 VPS 的情况：

  • 让 Telegram bot 长期在线。

  • 跑轻量 webhook。

  • 做云端定时任务。

  • 不依赖家里局域网。

简单判断：需要控制本机和家庭网络，就放本地；只需要公网在线，就可以放 VPS。

12. 常见坑

Mac 安装时 git clone 失败：大概率是缺 Apple Command Line Tools。先运行 xcode-select --install，装完再重新安装 Hermes。

命令明明装了，却提示找不到：通常是 PATH 没刷新。Mac 可以运行 source ~/.zshrc，或者重开一个终端窗口。

Homebrew 不存在：如果提示 brew: command not found，说明没装 Homebrew 或 PATH 没配好。这不一定阻止 Hermes 启动，但会影响 ripgrep、ffmpeg 等工具安装。

ripgrep 和 ffmpeg 是什么：ripgrep 用来更快地搜索文件和代码；ffmpeg 用来处理语音、音频、视频能力。有条件建议补齐： brew install ripgrep ffmpeg

模型能聊天但任务做不好：通常是模型能力、上下文、工具权限或工作区不对。先换一个更强模型，再看 hermes doctor 和日志。

不要随便给自动 sudo 权限：新手建议先不要让 Agent 自动执行管理员权限命令。涉及删除文件、修改网络、修改代理、修改防火墙、大范围改代码、执行 sudo 时，最好人工确认。

13. 最快操作路线

如果你只想快速跑通，照这个做：

  1. 下载 Hermes Desktop： https://hermes-agent.nousresearch.com/desktop

  2. 安装并打开 Hermes。

  3. 配一个模型，优先 Nous Portal 或 OpenRouter。

  4. 发第一条消息测试。

  5. 按需安装 CLI。

  6. 运行 hermes doctor。

  7. 保留默认 Skills。

  8. 需要手机入口时，再配置 Telegram。

  9. 需要自动任务时，再配置 cron。

14. 官方入口

关联文章
分享到 WhatsApp分享到 X通过邮件分享
Cookie 设置

Cookie 说明