前言
在安装 Hermes Agent 时可以选择 Kimi 大模型，核心是两者设计理念高度契合，Kimi 能够支撑 Hermes 长程任务自主执行、多工具协同调用和技能自动沉淀的核心功能，尤其是 K2.6版本，凭借强势的超长上下文处理能力、原生且稳定的边思考边工具调用能力、有所提升的代码水平，能够缓解其他模型常见的失忆、误操作以及多 Agent 场景下的限流阻塞问题，同时在任务规划、输出一致性和成本效益上表现良好，经社区实测在复杂多 Agent 协同和完整链路任务中稳定性较好，再加上其良好的中文支持、开源私有化部署选项和原生多模态能力，成为目前与 Hermes Agent 匹配度较高的大模型之一。
一、Hermes核心简介
Hermes Agent 以「一次学习，终身复用」为核心设计，能自动从任务中提取经验，抽象成标准化 Markdown 技能文件，形成 “执行 - 沉淀 - 复用 - 进化” 的自主闭环。它还内置语义记忆引擎和多领域原生工具链，支持并发子智能体，适配全平台。
本文提供一份实测可复现的部署方案，将依次完成基础环境校验、一键脚本安装、Kimi大模型接入配置、反向代理网关部署、核心功能验证五大环节，严格按序执行即可成功部署。
自主技能沉淀：自动生成 Markdown 技能文件，经验可复用，系统持续进化
持久化语义记忆：智能存储并快速召回历史信息，减少长任务信息丢失
原生多工具集成：内置搜索、终端、文件、浏览器等工具，开箱即用
并发子智能体：动态生成隔离子智能体，并行处理多任务
全平台兼容：原生支持 Linux、macOS，Windows 通过 WSL2 运行，单条命令部署
二、前置准备
版本控制工具：安装 Git 2.0 及以上版本
模型 API 密钥：提前获取 Kimi 等大语言模型服务商的 API 密钥
Windows 环境：Windows 用户须预先安装 WSL2 环境，安装过程中需要系统管理员权限
三、安装hermes agent
1.1 Windows详细安装教程
方式一：WSL2 安装（推荐新手使用）
检查 Windows 版本：WSL2 需要 Windows 10（版本 2004 或更高）或 Windows 11。
选择终端 (管理员) 或 Windows PowerShell (管理员)，在 UAC 弹窗点击 “是”。
安装 WSL2，在 PowerShell 里输入这条命令，然后按回车：
wsl --install注意：等待安装完成，可能需要几分钟。完成后会提示你重启电脑。
重启后设置 Linux 用户名和密码
在 WSL2 里安装 Hermes Agent，现在你已经在 Ubuntu 里了，输入这条命令：
curl -fsSL https://ghfast.top/https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash等几分钟，安装完成后输入：
source ~/.bashrc hermes看到欢迎界面就成功了！
方式二：PowerShell 原生安装
打开 PowerShell：按 Win 键，输入
PowerShell，点击"Windows PowerShell"。（这次不需要管理员权限）运行安装命令，复制下面这行，粘贴到 PowerShell 里，按回车：
irm https://ghfast.top/https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex等待安装完成：安装过程可能需要 3-5 分钟，期间会自动下载 Python、Node.js 等依赖。看到"Installation complete"就成功了。
1.2 macOS 详细安装教程
克隆项目到本地
git clone https://gitcode.com/GitHub_Trending/he/hermes-agent.git将下面代码复制到安装目录
mkdir -p ~/.hermes cp -r ~/hermes-agent ~/.hermes/hermes-agent进入目录并执行安装脚本
cd ~/.hermes/hermes-agent && bash scripts/install.sh重载环境变量
# Zsh 用户执行source ~/.zshrc # Bash 用户执行（二选一）# source ~/.bashrc1.3 Linux 详细安装教程
克隆项目到本地
git clone https://gitcode.com/GitHub_Trending/he/hermes-agent.git将下面代码复制到安装目录
mkdir -p ~/.hermes cp -r ~/hermes-agent ~/.hermes/hermes-agent进入目录并执行安装脚本
cd ~/.hermes/hermes-agent && bash scripts/install.sh重载环境变量
# source ~/.zshrc四、Kimi 大模型接入配置向导
安装完成后，运行hermes命令，你会看到一个配置向导界面。输入1并按回车，进入快速设置模式。
1、选择模型提供商
在这一步内，可以选择你想使用的 AI 模型提供商。
在模型提供商选择列表中，国内用户推荐选择 Kimi（Moonshot）。在国内网络环境下，Kimi 凭借稳定的连接速度、出色的中文语义理解能力和高性价比，成为绝大多数开发者部署 Hermes Agent 的优选方案。
2、输入 API 密钥
选择提供商后，系统会提示你输入 API 密钥，以Kimi提供商为例展示获取方式：
登录Kimi网站获取API Key，访问 https://platform.moonshot.cn/console 点击登录
点击左侧的API Key管理，创建API Key，复制弹出的密钥字符
回到hermes agent继续配置
3、选择默认模型
将复制的API Key贴入终端并敲击回车，然后选择Moonshot/Kimi-K2.6模型并敲击回车确认。
4、配置工具
接下来会询问你想启用哪些工具。新手建议先启用基础工具：
web # 网络搜索和网页提取 terminal # 执行命令 file # 读写文件 browser # 浏览器自动化（可选）5、配置完成
全部配置完成后，就可以开始对话啦~
6、安装后的第一件事
装好之后，我建议你立刻做一件事：设置持久记忆。
在对话中输入——hermes "请记住：我的主力编程语言是 Python，我偏好使用 Docker 部署服务，回复请用中文"
Hermes Agent 会把这些偏好写入持久记忆文件。之后每次对话，它都会带着这些上下文，让回复更贴合你的习惯。
你也可以直接编辑~/.hermes/memory/prompt.md文件，手动写入你的偏好信息。记住这个文件有 3575 字符的限制，言简意赅就好。
五、常见问题及解决办法
1、环境准备类问题（Windows 用户高发）
Windows 直接安装失败（未用 WSL2）
错误表现：安装脚本报错、命令无法执行、界面无响应
核心原因：Hermes Agent 仅支持 Linux/macOS/WSL2，不支持 Windows 原生 PowerShell/CMD
解决方案：
# 以管理员身份运行PowerShell，启用WSL2 wsl --install -d Ubuntu # 安装后设置默认启动WSL wsl --set-default Ubuntu2、网络与资源下载问题（国内用户常见）
官方脚本下载失败（GitHub 访问受限）
错误表现：
curl: (7) Failed to connect toraw.githubusercontent.com核心原因：国内网络无法直接访问 GitHub 资源
解决方案：
方法 1（推荐）：使用离线安装包
cd /mnt/d/Downloads # 进入安装包目录sudo apt install -y unzipunzip hermes-agent-2026.4.8.zip cd hermes-agent && bash install.sh方法 2：配置代理后重试
export http_proxy=http://代理地址:端口 export https_proxy=http://代理地址:端口 curl -sSL https://get.hermesagent.com | bash
Python 依赖安装超时（PyPI 访问慢）
错误表现：
pip install长时间卡住、ReadTimeoutError解决方案：使用国内镜像源加速
pip install --trusted-host pypi.tuna.tsinghua.edu.cn -i https://pypi.tuna.tsinghua.edu.cn/simple/ 依赖包名3、命令与环境变量问题
hermes: command not found（安装后无法识别命令）
错误表现：终端输入
hermes提示未找到命令核心原因：环境变量未加载或 PATH 未更新
解决方案：
# 重新加载环境变量source ~/.bashrc # 或~/.zshrc（根据Shell类型）# 或直接重启终端版本不匹配（Python/Node.js 版本冲突）
Python 问题：
Python 3.9 or older in PATH，安装器需要 Python 3.11
# 手动创建虚拟环境并指定版本 python3.11 -m venv hermes-venv source hermes-venv/bin/activateNode.js 问题：
ENOENT/EACCES错误，Node.js 安装不完整
# 删除残留文件并重新安装rm -rf ~/.nvm ~/.node-gyp curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash nvm install 184、依赖冲突与缺失问题
Pydantic 版本冲突
错误表现：
TypeError: BaseModel.validate() takes 1 positional argument but 2 were given核心原因：Hermes 依赖 Pydantic v1，系统安装了 v2（语法不兼容）
解决方案：
pip uninstall -y pydantic pydantic-core pip install pydantic==1.10.13六、结语
至此，Hermes Agent 全流程私有化部署已圆满收官。经过多轮环境调试、功能验证与模型选型对比，我们最终选择Kimi 大模型作为系统的核心推理引擎 —— 这也是当前社区中绝大多数开发者部署 Hermes Agent 时的公认优选方案。
在 Kimi 大模型精准的逻辑推理、稳定的多工具协同调用以及出色的长上下文理解能力的强力支撑下，当前系统运行状态稳定可靠，核心功能模块全部上线并通过生产级测试。Kimi 专为代码与长任务场景优化的特性，与 Hermes Agent 自主执行、多步骤规划的设计理念完美契合，不仅让系统能够独立承担代码开发、文档处理、数据分析、自动化运维等多样化复杂任务，更显著提升了任务完成的准确率与执行效率。
愿这个由 Kimi 赋能的强大智能伙伴，能够帮助你从繁琐的重复性工作中解放出来，大幅提升日常工作效率，同时也成为你探索人工智能技术边界、解锁更多可能性的得力助手。
