安装 + 配置 + 接入

Hermes Agent 完整部署指南

本文将带你从零开始，在 Windows 和 Mac 环境下完成 Hermes Agent 的本地部署，并详细讲解如何将其接入钉钉，打造专属的 AI 员工。

1. Windows 环境安装

使用 PowerShell 一键安装脚本

执行一键安装命令

请以管理员身份运行 Windows PowerShell，然后复制并执行以下命令：

Windows PowerShell

irm https://res1.hermesagent.org.cn/install.ps1 | iex

**提示：** 安装过程中会自动检查并配置所需的依赖环境，请耐心等待。
安装完成后，可以在终端输入 hermes --version 验证是否安装成功。

2. Mac 环境安装

macOS 特供：零配置快速上手

环境要求与准备

Hermes Agent 在 Mac 上运行需要 Python 3.11+ 和 Node.js 环境。如果你还没有安装 Node.js，推荐使用 Homebrew 进行安装：

Mac 终端 (Terminal)

export HOMEBREW_INSTALL_FROM_API=1
export HOMEBREW_API_DOMAIN="https://mirrors.ustc.edu.cn/homebrew-bottles/api"
export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.ustc.edu.cn/homebrew-bottles"
export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.ustc.edu.cn/brew.git"
export HOMEBREW_CORE_GIT_REMOTE="https://mirrors.ustc.edu.cn/homebrew-core.git"
/bin/bash -c "$(curl -fsSL https://mirrors.ustc.edu.cn/misc/brew-install.sh)"
brew install node python@3.11

一键安装脚本

打开终端，运行官方的一键安装脚本，脚本会自动处理 Python 环境和相关依赖：

Mac 终端

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

3. 接入钉钉机器人

配置 Gateway 网关与 Chat 交互入口

将 Hermes Agent 接入钉钉，可以让你在熟悉的聊天软件中直接指挥 AI 智能体执行任务。

创建钉钉应用： 进入钉钉开发者平台 (open-dev.dingtalk.com)，在【应用开发】中创建一个新的钉钉应用，记录下 Client ID 和 Client Secret。
添加机器人能力： 在应用详情页的【添加应用能力】中，添加“机器人”能力，填写机器人名称并发布。
配置 Hermes Gateway： 在本地终端中运行以下命令启动网关配置：
```
hermes gateway setup
```
交互式设置：
- 在弹出的选项中，选择 DingTalk 作为渠道。
- 选择 手动输入模式。
- 依次填入刚才记录的 机器人ID (Robot ID)、Client ID 和 Client Secret。
- 输入完成后选择 Done 保存。
重启生效： 重启 Hermes Agent 服务，然后在钉钉中搜索你的机器人名称，发送任意消息即可验证是否接入成功。