从零开始安装、配置、接入消息平台，手把手教你让 Hermes Agent 跑起来。

第一步

安装 Hermes Agent 运行环境

Hermes Agent 支持 Linux、macOS、WSL2 和 Android Termux。原生 Windows 不受支持，必须先安装 WSL2。安装前唯一需要预装的是 Git，其余依赖由 Hermes Agent 安装脚本自动处理。

# 一键安装 Hermes Agent（自动配置 Python 3.11, Node.js v22, ripgrep, ffmpeg）
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

# 安装完成后刷新环境变量
source ~/.bashrc

# 验证 Hermes Agent 是否安装成功
hermes --version
hermes doctor

如果你更偏好手动安装以精确控制 Hermes Agent 的依赖，也可以通过 git clone --recurse-submodules 克隆 Hermes Agent 仓库后，用 uv pip install -e ".[all]" 手动安装。Hermes Agent 会在 ~/.hermes/ 目录下创建完整的配置结构。

第二步

为 Hermes Agent 配置 API 密钥

Hermes Agent 需要至少一个 LLM 提供商的 API 密钥才能工作。编辑 ~/.hermes/.env 文件添加密钥，或使用 Hermes Agent CLI 命令直接设置：

# 方法一：通过命令行直接设置
hermes config set OPENROUTER_API_KEY sk-or-v1-你的密钥

# 方法二：编辑环境文件
nano ~/.hermes/.env

以下是 Hermes Agent 支持的主要 API 密钥配置：

配置完密钥后，运行 hermes model 交互式选择 Hermes Agent 的默认模型。注意 Hermes Agent 要求底层模型至少支持64,000 token 上下文长度。

第三步

选择 Hermes Agent 的 AI 模型

# 交互式选择提供商和模型
hermes model

# 也可以在会话中随时切换模型
/model claude-sonnet-4
/model openrouter:anthropic/claude
/model custom:qwen-2.5

# 使用本地模型（零 API 费用，需16GB+ 显存）
# 先安装 Ollama，然后在 Hermes Agent 中选择 Ollama 后端
hermes model # 选择 "Custom Endpoint" -> 填入 Ollama 地址

Hermes Agent 支持通过 Nous Portal 订阅实现零配置 OAuth 登录，也支持通过 OpenRouter 一个密钥路由200种以上模型。对于国内用户，Hermes Agent 兼容智谱AI和 Kimi 等国产模型，无需科学上网。

第四步

启动并验证 Hermes Agent

# 启动 Hermes Agent 交互式终端
hermes

# 或一次性查询测试
hermes chat -q "你好，列出你可用的工具"

# 运行全量配置向导（推荐首次使用）
hermes setup

首次启动后，建议运行 hermes setup 进入 Hermes Agent 全量配置向导，依次完成模型选择、工具启用、终端后端和安全策略的配置。Hermes Agent 的 hermes doctor 命令可以自动诊断环境问题并尝试修复。完成配置后的 Hermes Agent 就已经具备了持久记忆和技能学习能力。

第五步（可选）
使用 Docker 部署 Hermes Agent
对于生产环境，Docker 是部署 Hermes Agent 最推荐的方式。Hermes Agent 在容器沙箱中隔离运行，保护宿主系统安全，–restart unless-stopped 确保 Hermes Agent 崩溃后自动恢复。

# 初始化配置
mkdir -p ~/.hermes
docker run -it --rm -v ~/.hermes:/opt/data nousresearch/hermes-agent setup

# 以网关模式持久运行 Hermes Agent
docker run -d \
  --name hermes \
  --restart unless-stopped \
  -v ~/.hermes:/opt/data \
  nousresearch/hermes-agent gateway run

# 传递 API 密钥
docker run -d --name hermes \
  -v ~/.hermes:/opt/data \
  -e ANTHROPIC_API_KEY="sk-ant-你的密钥" \
  nousresearch/hermes-agent gateway run

Hermes Agent Docker 部署的资源要求：最低1GB内存/1核CPU/500MB磁盘，推荐2-4GB内存/2核。如果 Hermes Agent 需要使用浏览器自动化功能，添加 --shm-size=1g 参数分配共享内存。

第六步

接入消息平台：让 Hermes Agent 上线工作

Hermes Agent 的消息网关是让 Hermes Agent 上线到各沟通平台的核心组件。运行 hermes gateway setup 进入 Hermes Agent 交互式配置向导：

# 配置消息网关
hermes gateway setup

# 启动网关（前台模式，方便调试）
hermes gateway

# 注册为系统服务（Linux，后台常驻）
hermes gateway install
hermes gateway start
hermes gateway status

Telegram 接入

Hermes Agent 对接 Telegram 机器人

在 Telegram 搜索 @BotFather，发送 /newbot 创建机器人并获取 Token。然后在 ~/.hermes/.env 中配置 TELEGRAM_BOT_TOKEN 和 TELEGRAM_ALLOWED_USERS（通过 @userinfobot 获取用户ID）。若需在群组中使用 Hermes Agent，需通过 BotFather 关闭隐私模式并重新拉入群组。

钉钉接入

Hermes Agent 接入钉钉企业应用

通过 hermes gateway setup 选择 DingTalk 平台，按向导填入钉钉开放平台的应用凭据。Hermes Agent 的钉钉接入支持单聊和群聊场景，可通过 DINGTALK_ALLOWED_USERS 配置访问白名单，消息通过钉钉机器人 Webhook 投递。

飞书接入

Hermes Agent 接入飞书开放平台

在飞书开放平台创建应用，获取 App ID 和 App Secret。在 Hermes Agent 配置中填入 app_id、app_secret 和 verification_token。Hermes Agent 的飞书适配器支持事件订阅、消息卡片、群聊以及图片文件附件。配置 FEISHU_ALLOWED_USERS 限制可访问用户。

企业微信接入

Hermes Agent 对接企业微信

Hermes Agent 的企业微信适配器使用 WebSocket 网关，无需公网端点即可部署。配置 WECOM_BOT_ID 和 WECOM_SECRET，Hermes Agent 会自动处理 AES 加密解密。支持文本、图片、语音和视频消息，以及群聊场景。

感谢您的来访，获取更多精彩文章请收藏本站。