Hermes Agent 兼容 Linux、macOS、WSL2、Windows 10 及以上系统、Android Termux 全类运行环境，共提供四种安装方式：官方一键部署脚本、PowerShell 专属安装、pip 包安装、源码编译部署。部署完毕后需要配置大模型 API 密钥，国内使用场景优先选择 Kimi；如果需要离线运行，可搭配 Ollama 完成纯本地离线推理，本文内所有终端命令都能直接复制执行。

一、部署前置环境准备

系统与硬件要求

Hermes Agent 具备全平台跨端适配能力，覆盖主流终端与服务器系统，具体配置要求如下：

• 支持系统：Windows 10/11 原生、Linux（Ubuntu/CentOS/Debian）、macOS、Android（Termux 终端）
• 架构支持：x86_64、ARM64
• 最低配置：256MB 内存、100MB 可用存储、标准 CPU 架构（仅运行 Hermes 调度框架，调用云端大模型）
• 推荐配置：4 核 CPU + 8GB 内存，可流畅运行多工具并发调用、复杂长链路任务
• 网络要求：稳定公网连接，可访问国内软件源与大模型 API；国内用户可使用内置镜像加速，无需全局代理

前置依赖说明

官方提供的一键安装脚本可自动处理绝大多数依赖组件，自动完成 Python3.11、Node.js22、uv 包管理器等核心环境的安装，一般无需手动配置。仅特殊场景需提前准备：

• 如需使用 hermes update 自动更新功能，需提前安装 Git
• Windows 用户推荐使用 PowerShell7 及以上版本，系统自带 PowerShell5.1 也可兼容运行
• Linux 极简系统若安装报错，可手动预装基础依赖：sudo apt install git curl build-essential

国内用户专属镜像加速

官方镜像脚本已内置单仓库专属加速配置，无需手动配置全局镜像，可降低镜像配置冲突的概率：

• Git 镜像：CNB.cool Hermes 专属同步镜像（仅作用于本项目）
• PyPI 镜像：清华源优先，自动切换至阿里云、中科大源或官方源
• NPM 镜像：npmmirror 官方国内源
• Node.js、uv、Python：Hermes 中文社区自建加速节点

注意：不建议执行全局 Git 镜像替换命令。全局替换会覆盖所有 GitHub 项目配置，可能导致其他代码仓库操作失败，仅使用脚本内置的单项目镜像即可满足需求。

二、全平台一键安装部署方案

Windows 原生安装（无需 WSL，推荐）

支持 Win10/11 原生运行，CLI、网关、终端工具、浏览器相关功能均已适配。打开 PowerShell 执行一键命令即可：

irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex

自动安装组件

脚本可自动完成运行环境的部署配置，无需手动干预，包含：Python3.11、uv 包管理器、Node.js22、ripgrep 高速搜索工具、ffmpeg 多媒体工具、便携 Git 环境。

安装规则与路径

• 安装目录：%LOCALAPPDATA%\hermes\hermes-agent
• 自动创建 Python 虚拟环境，与系统环境相互隔离
• 自动将 hermes 命令加入用户 PATH 环境变量

必做操作：安装完成后需重启终端，环境变量方可生效。

Linux /macOS 通用安装

打开终端，执行一键安装命令：

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

常用可选参数（按需叠加）：

• --skip-setup：跳过初始化配置向导
• --with-browser：安装浏览器工具依赖
• --full：安装全部扩展功能（WhatsApp 桥接、RL 训练、完整依赖）

Android Termux 安装

适配手机端 Termux 终端环境，先更新系统组件，再执行安装脚本：

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

三、核心模型配置：Kimi 大模型

安装完成后需配置大模型 API 才可正常使用。使用 Kimi 大模型的标准配置为：模型名 moonshot/k2.6，环境变量 MOONSHOT_API_KEY，配置无参数冲突。

Kimi API Key 获取步骤

1. 注册并登录月之暗面开放平台
2. 在左侧菜单栏进入「API Key 管理」
3. 点击「新建 API Key」，自定义名称后确认
4. 复制生成的密钥（请妥善保存）

额度说明：新用户可获得免费调用额度，无最低消费要求，额度用完后可按需付费使用。

交互式配置（新手推荐）

执行配置向导，全程可视化操作：

hermes setup

配置流程：

1. LLM 服务商选择：Moonshot (Kimi, China)
2. 粘贴你的 Moonshot API Key
3. 默认模型选择：moonshot/k2.6
4. 新手可勾选基础工具：网页检索、终端操作、文件处理
5. 自动保存配置，完成初始化

手动命令配置（高阶用户）

可直接通过命令行写入配置，无需交互：

hermes config set model moonshot/k2.6
hermes config set MOONSHOT_API_KEY sk-你的API密钥

配置文件路径

• Windows：%LOCALAPPDATA%\hermes\config.yaml、%LOCALAPPDATA%\hermes\.env
• Linux/macOS/Termux：~/.hermes/config.yaml、~/.hermes/.env

四、启动验证与基础使用教程

首次启动测试

终端输入命令启动交互界面：

hermes

出现 What can I do for you today? 即代表启动成功，可直接进行对话测试：

• 基础对话：你好，请介绍一下你自己
• 实操任务：统计当前目录下所有 Python 文件数量

两种核心运行模式

• 单次任务模式：适合一次性简单任务，执行后自动退出

hermes "帮我整理当前文件夹文件并统计大小"

• 交互多轮模式：保留上下文记忆，适合复杂连续任务

hermes

常用快捷命令

• /help：查看全部指令
• /skill list：查看已加载技能
• /skill run 技能名：运行自定义技能
• /save 会话名：保存当前对话记忆（本地持久化）
• /exit 或 Ctrl+C：退出交互模式

记忆文件备份方法

所有跨会话记忆、自定义技能、配置文件均存储在本地对应目录中，直接复制该文件夹即可完成全量备份，重装系统或更换设备后替换目录即可恢复所有数据。

五、常见问题排查方案

安装失败

• 不建议使用 sudo / 管理员权限安装，框架默认在用户目录内部署
• 检查网络连接，若镜像访问异常可切换手机热点重试
• Linux 极简系统可手动安装基础依赖：sudo apt install git curl build-essential

hermes: command not found

• 关闭当前终端，重启新终端后环境变量即可生效
• Linux/macOS 可执行环境刷新命令：source ~/.bashrc 或 source ~/.zshrc
• Windows 可手动添加 PATH：将 %LOCALAPPDATA%\hermes\hermes-agent\venv\Scripts 加入用户环境变量

大模型连接 / 调用失败

• 核对配置参数：模型名应为 moonshot/k2.6，密钥变量应为 MOONSHOT_API_KEY
• 检查 API 密钥无多余空格、换行，确认账户余额 / 调用额度充足
• 国内环境无需配置代理，关闭全局代理可避免网络冲突

六、总结

1. 普通用户：Windows 用 PowerShell 一键脚本、Linux/macOS 用 curl 一键脚本，最简部署；
2. 短期试用：优先pip install hermes-agent快速体验；
3. 二次开发：源码编译安装，可自定义修改项目代码；
4. 国内优选搭配：Hermes Agent + Kimi API，规避网络问题，长文本、自动化任务、代码能力发挥最佳。

---

「免责声明」：以上页面展示信息由第三方发布，目的在于传播更多信息，与本网站立场无关。我们不保证该信息(包括但不限于文字、数据及图表)全部或者部分内容的准确性、真实性、完整性、有效性、及时性、原创性等。相关信息并未经过本网站证实，不对您构成任何投资建议，据此操作，风险自担，以上网页呈现的图片均为自发上传，如发生图片侵权行为与我们无关，如有请直接微信联系g1002718958。