教程部署Hermes Agent 2026-06-18 293 次阅读

Hermes Agent 安装与配置完全指南：多平台部署专属 AI 助手

Hermes Agent 多平台安装教程（macOS / Windows / Linux），从安装到配置飞书机器人的完整指南。
Hermes Agent 安装与配置完全指南：多平台部署专属 AI 助手



macOS 安装教程

系统要求

项目 要求
操作系统 macOS 12 (Monterey) 或更高版本
处理器 Intel 或 Apple Silicon (M1/M2/M3)
内存 至少 2GB RAM
Python 3.11+（安装脚本会自动处理）
Git 需要预装（用于克隆源码）
网络 需要互联网连接

第一步：安装 Homebrew（如果未安装）

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

验证安装：

brew --version   # 应显示 4.x+

第二步：安装基础工具

brew install git curl

验证安装：

git --version   # 应显示 2.x+
curl --version  # 应显示 7.x+

第三步：一键安装 Hermes

官方源（默认，国际用户推荐）：

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

国内镜像加速（官方源下载慢时使用）：

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

安装器会自动处理所有依赖（Python 3.11、Node.js、ripgrep、ffmpeg）。

第四步：验证安装

hermes --version

应显示版本号，如 hermes v0.16.0。

如果提示 command not found：手动配置 PATH 后重试：

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

使用 Bash 的用户将 ~/.zshrc 替换为 ~/.bashrc。

第五步：配置 AI 模型

hermes model

按向导提示：

  • 选择模型提供商（如 MiMo、DeepSeek、minimax 等）
  • 输入对应的 API Key

如果后续需要更换模型，再次执行 hermes model 即可。

第六步：配置飞书消息通道

前置准备：安装飞书依赖库

~/.hermes/hermes-agent/venv/bin/pip install lark-oapi --upgrade

方式一：扫码配对（推荐）

hermes gateway setup

在向导中选择 飞书 / Lark，然后选择 扫码创建（推荐），用手机飞书扫码授权即可。Hermes 会自动创建机器人应用并配置好所有权限。

方式二：手动配置（备选）

如果扫码失败（如无管理员权限），改为手动模式：

  1. 在飞书开放平台创建应用，获取 App ID 和 App Secret
  2. 执行网关配置向导：
hermes gateway setup

选择 Feishu，粘贴 App ID 和 App Secret。

第七步：启动 Gateway 守护进程

hermes gateway start

设置开机自启（可选）：

launchctl load ~/Library/LaunchAgents/com.hermes.gateway.plist

查看运行状态：

hermes gateway status   # 应显示 active (running)

第八步：测试飞书机器人

  1. 打开飞书 App，搜索你的机器人名称
  2. 发送一条消息（如 你好）

如果使用扫码方式，授权即完成身份绑定，机器人应直接回复。

如果使用手动配置方式，可能需要批准配对码：

hermes pairing list feishu      # 查看配对码
hermes pairing approve feishu <配对码>   # 批准

运行诊断（可选）

hermes doctor

检查安装和配置是否完整。

Windows 安装教程

系统要求

项目 要求
操作系统 Windows 10 (1903+) 或 Windows 11
处理器 x64 架构 CPU
内存 至少 2GB RAM
Python 3.11+（安装脚本会自动处理）
Git 需要预装（用于克隆源码）
网络 需要互联网连接

第一步：安装 Git

以管理员身份打开 PowerShell，安装 Git：

winget install Git.Git

安装完成后关闭并重新打开 PowerShell，验证：

git --version   # 应显示 2.x+

第二步：安装 Hermes

以管理员身份打开 PowerShell，执行官方安装脚本：

官方源（默认，国际用户推荐）：

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

国内镜像加速（官方源下载慢时使用）：

iex (irm https://ghfast.top/https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1)

安装器会自动处理所有依赖（Python 3.11、Node.js、ripgrep、ffmpeg）。

第三步：验证安装

hermes --version

应显示版本号，如 hermes v0.16.0。

如果提示 command not found：重启 PowerShell 终端，或手动添加 PATH：

# 将 %USERPROFILE%\.local\bin 添加到用户 PATH
[Environment]::SetEnvironmentVariable("Path", $env:Path + ";$env:USERPROFILE\.local\bin", "User")
# 重启终端后生效

第四步：配置 AI 模型

hermes model

按向导提示：

  • 选择模型提供商（如 MiMo、DeepSeek、minimax 等）
  • 输入对应的 API Key

如果后续需要更换模型，再次执行 hermes model 即可。

第五步：配置飞书消息通道

前置准备：安装飞书依赖库

$env:USERPROFILE\.hermes\hermes-agent\venv\Scripts\pip install lark-oapi --upgrade

方式一：扫码配对（推荐）

hermes gateway setup

在向导中选择 飞书 / Lark，然后选择 扫码创建（推荐），用手机飞书扫码授权即可。Hermes 会自动创建机器人应用并配置好所有权限。

方式二：手动配置（备选）

如果扫码失败（如无管理员权限），改为手动模式：

  1. 在飞书开放平台创建应用，获取 App ID 和 App Secret
  2. 执行网关配置向导：
hermes gateway setup

选择 Feishu，粘贴 App ID 和 App Secret。

第六步：启动 Gateway 守护进程

hermes gateway start

设置开机自启（可选）：

hermes gateway install-service

查看运行状态：

hermes gateway status   # 应显示 active (running)

第七步：测试飞书机器人

  1. 打开飞书 App，搜索你的机器人名称
  2. 发送一条消息（如 你好）

如果使用扫码方式，授权即完成身份绑定，机器人应直接回复。

如果使用手动配置方式，可能需要批准配对码：

hermes pairing list feishu      # 查看配对码
hermes pairing approve feishu <配对码>   # 批准

运行诊断（可选）

hermes doctor

检查安装和配置是否完整。

Linux 安装教程（Ubuntu / Debian）

系统要求

项目 要求
操作系统 Ubuntu 20.04+、Debian 11+ 或其他 Debian 系发行版
处理器 x64 或 ARM64
内存 至少 2GB RAM
Python 3.11+（安装脚本会自动处理）
Git 需要预装（用于克隆源码）
网络 需要互联网连接

第一步：安装基础工具

如果系统未预装 Git 和 Curl：

sudo apt update && sudo apt install -y git curl

验证安装：

git --version   # 应显示 2.x+
curl --version  # 应显示 7.x+

第二步：一键安装 Hermes

官方源（默认，国际用户推荐）：

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

国内镜像加速（官方源下载慢时使用）：

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

安装器会自动处理所有依赖（Python 3.11、Node.js、ripgrep、ffmpeg）。

第三步：验证安装

hermes --version

应显示版本号，如 hermes v0.16.0。

如果提示 command not found：手动配置 PATH 后重试：

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

使用 Zsh 的用户将 ~/.bashrc 替换为 ~/.zshrc。

第四步：配置 AI 模型

hermes model

按向导提示：

  • 选择模型提供商（如 MiMo、DeepSeek、minimax 等）
  • 输入对应的 API Key

如果后续需要更换模型，再次执行 hermes model 即可。

第五步：配置飞书消息通道

前置准备：安装飞书依赖库

~/.hermes/hermes-agent/venv/bin/pip install lark-oapi --upgrade

方式一：扫码配对（推荐）

hermes gateway setup

在向导中选择 飞书 / Lark，然后选择 扫码创建（推荐），用手机飞书扫码授权即可。Hermes 会自动创建机器人应用并配置好所有权限。

方式二：手动配置（备选）

如果扫码失败（如无管理员权限），改为手动模式：

  1. 在飞书开放平台创建应用，获取 App ID 和 App Secret
  2. 执行网关配置向导：
hermes gateway setup

选择 Feishu，粘贴 App ID 和 App Secret。

第六步：启动 Gateway 守护进程

hermes gateway start

设置开机自启（可选）：

systemctl --user enable hermes-gateway

查看运行状态：

hermes gateway status   # 应显示 active (running)

第七步：测试飞书机器人

  1. 打开飞书 App，搜索你的机器人名称
  2. 发送一条消息（如 你好）

如果使用扫码方式，授权即完成身份绑定，机器人应直接回复。

如果使用手动配置方式，可能需要批准配对码：

hermes pairing list feishu      # 查看配对码
hermes pairing approve feishu <配对码>   # 批准

运行诊断（可选）

hermes doctor

检查安装和配置是否完整。

📚 常用管理命令速查

场景 命令
安装（Linux/macOS/WSL2） curl -fsSL https://hermes-agent.nousresearch.com/install.sh \| bash
安装（Windows 原生） iex (irm https://hermes-agent.nousresearch.com/install.ps1)
配置模型 hermes model
配置飞书 hermes gateway setup
启动网关 hermes gateway start
重启网关 hermes gateway restart
查看网关状态 hermes gateway status
查看配对码 hermes pairing list feishu
批准配对 hermes pairing approve feishu <配对码>
运行诊断 hermes doctor
查看所有配置 hermes config show

配置命令补充

作用 命令
运行完整配置向导（会覆盖所有配置） hermes setup
只修改模型/提供商 hermes setup model
配置消息平台（飞书） hermes setup gateway
直接设置某个配置项 hermes config set
#Hermes Agent #安装 #教程 #飞书
← 上一篇
Claude Code 完全干净卸载教程：完全清理 Claude Code 及其相关组件

评论 (0)

0 / 1000