核心速览（30秒快速决策）

✅ 国内用户最优安装方案：使用ghfast国内加速一键脚本，10-15分钟完成全平台部署 

✅ 模型优选推荐：

• 长文本与复杂代码Agent任务优选：Kimi K2.6（256K实际可用上下文，12小时连续编码，企业级缓存优化）

• 高性价比通用任务优选：DeepSeek V3

• 本地免费运行方案优选：Ollama + Hermes 3

✅ 核心痛点解决：全链路国内镜像加速，无需科学上网即可完成安装和使用 

✅ 验证标准：运行hermes --version显示v0.14.0即安装成功

本教程是针对国内网络环境优化的社区版安装指南，基于Hermes Agent最新稳定版v0.14.0编写，完整覆盖Windows/macOS/Linux三大平台。Hermes Agent是Nous Research开源的通用AI智能体框架（MIT协议），支持接入200+主流大模型，内置代码编写、文件操作、浏览器自动化等50+工具，通过技能库与记忆系统实现重复任务效率优化。

一、部署前检查清单

1.1 硬件配置要求

硬件配置分为基础运行要求和流畅体验要求两个档次。基础运行要求为：x86_64或ARM64架构CPU，256MB内存，100MB可用磁盘空间，以及稳定的互联网连接。流畅体验要求为：2核及以上CPU，2GB及以上内存，1GB及以上可用磁盘空间（含浏览器内核所需空间），10Mbps以上带宽的互联网连接。

1.2 系统支持

• Windows：Windows 10 2004+ / Windows 11（两种安装方式可选）

  • ✅ 推荐：PowerShell原生安装（最简单，无需虚拟机）

  • ⚙️ 备选：WSL2 Ubuntu 20.04+（适合Linux习惯用户）

• macOS：12 Monterey及以上（Intel/Apple Silicon全兼容）

• Linux：Ubuntu 20.04+、Debian 11+、CentOS 8+、Fedora 36+

1.3 国内主流模型提供商解析与选型建议

国内网络环境下，不同模型提供商在能力侧重、适用场景、成本结构和访问体验上各有特点，以下是详细解析：

• Kimi K2.6：核心能力体现在超长上下文处理和长程任务稳定性上，拥有256K实际可用上下文（已通过行业标准大海捞针测试），支持最长12小时的连续编码任务，可同时调度300个子Agent并行执行。其独有的企业级缓存机制，缓存命中率可达75%-83%，能大幅降低重复任务的调用成本。适用于大型代码库分析、整本书籍处理、多轮复杂Agent任务和企业文档自动化等场景。成本方面，标准输入为6.5元/百万Token，输出为27元/百万Token，缓存命中时仅需1.1元/百万Token。国内可直接访问，无需额外网络配置。

• DeepSeek V3：核心特点是成本友好，同时提供充足的免费体验额度，代码生成能力也较为突出。适用于日常对话、轻量脚本编写和预算有限的通用场景。成本方面，输入为0.7元/百万Token，输出为2.1元/百万Token。国内可直接访问。

• 通义千问4：核心优势在于多模态能力，对图文混合内容的理解和处理能力较强，同时与阿里生态有良好的集成。适用于图文混合任务和办公自动化场景。成本方面，输入为1.5元/百万Token，输出为4.5元/百万Token。国内可直接访问。

• 字节豆包4：核心特点是响应速度快，免费额度充足，适合高频次的轻量交互。适用于日常问答和轻量内容生成场景。成本方面，输入为0.8元/百万Token，输出为2.0元/百万Token。国内可直接访问。

• OpenAI GPT-4o：作为行业标杆，功能覆盖最全面，工具调用的兼容性和稳定性最好。适用于国际网络用户和对功能完整性要求极高的复杂通用任务。成本方面，输入为18元/百万Token，输出为54元/百万Token。国内访问需要额外配置代理。

特别说明：对于需要处理超过30页文档、5万行代码或连续执行超过1小时的高复杂度长程任务，Kimi是目前国内市场上表现最稳定的解决方案。其缓存机制对重复任务极为友好，企业用户实际使用成本可降低70%以上。

1.4 准备工作

1. 注册对应模型提供商账号并获取API Key（Kimi新用户注册即送免费体验额度）

2. 国内用户建议提前配置清华PyPI镜像，加速依赖下载

3. Linux/WSL2用户准备sudo权限，Windows开启WSL2功能需管理员权限

二、各平台详细安装步骤

2.1 Windows安装教程

方式一：PowerShell原生安装（推荐所有新手）

1. 按Win+R输入powershell打开终端（无需管理员权限）

2. 运行国内加速安装命令：

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

   官方原始命令（可科学上网用户使用）：

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

3. 等待3-8分钟，脚本自动安装Python 3.11、Node.js 22、Git等所有依赖

4. 看到Installation Complete!提示即成功，重启终端后输入hermes --version验证

方式二：WSL2 Ubuntu安装（备选）

1. 管理员身份打开PowerShell，运行：

   wsl --install -d Ubuntu

2. 重启电脑后设置Ubuntu用户名和密码

3. 在Ubuntu终端中运行下文2.3节的Linux安装命令

2.2 macOS安装教程

方式一：官方一键脚本（推荐）

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

方式二：手动克隆安装（适合源码修改用户）

# 克隆国内GitCode镜像仓库
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 ~/.bashrc

2.3 Linux安装教程

方式一：官方一键脚本（推荐）

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

方式二：手动克隆安装（适合源码修改用户）

# 克隆国内GitCode镜像仓库
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

2.4 常用安装参数（高级用户）

在命令后添加以下参数定制安装过程：

• --skip-browser：跳过Playwright浏览器安装（节省200MB+空间）

• --no-venv：不创建虚拟环境（不推荐新手）

• --skip-setup：跳过安装后配置向导（后续手动运行hermes setup）

示例（跳过浏览器安装）：

curl -fsSL https://ghfast.top/.../install.sh | bash -s -- --skip-browser

三、模型配置与API密钥设置

3.1 通用配置流程

安装完成后运行hermes setup进入配置向导，输入1选择快速设置模式：

1. 选择模型提供商（输入对应编号）

2. 输入API Key

3. 选择默认模型

4. 选择启用的工具

5. 完成配置并验证

3.2 Kimi专属配置指南（重点推荐）

步骤1：获取Kimi API Key

1. 访问月之暗面开发者平台

2. 手机号注册并完成实名认证（新用户自动获得免费体验额度）

3. 进入控制台 → API Keys → 点击"创建密钥"

4. 复制生成的以sk-开头的密钥（仅显示一次，请妥善保存）

步骤2：在Hermes中配置Kimi

1. 运行hermes setup

2. 在模型提供商列表中选择Moonshot（Kimi官方品牌名）

3. 粘贴刚才复制的API Key

4. 选择默认模型：优选kimi-k2.6版本，这是目前Kimi系列中能力最全面的版本

5. 工具选择：建议启用web、file、terminal（Kimi工具调用准确率接近100%）

6. 完成配置

步骤3：Kimi高级参数优化（提升长文本任务性能）

编辑~/.hermes/config.yaml文件，添加以下配置：

models:
  moonshot:
    api_key: "你的API Key"
    default_model: "kimi-k2.6"
    parameters:
      temperature: 0.3  # 长文本任务建议降低温度，提高输出准确性
      max_tokens: 128000  # 充分利用256K上下文窗口的处理能力
      cache_prompt: true  # 启用缓存机制，大幅降低重复任务成本

Kimi专属技巧：处理大型代码库时，先运行hermes index ./your-project建立代码索引，Kimi会自动缓存项目结构和关键信息，后续查询速度可提升10倍，同时降低80%的调用成本。

四、常见问题与解决办法

4.1 安装类问题

问题：Windows PowerShell提示"执行策略不允许"

解决方案：管理员身份打开PowerShell，运行：

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

问题：uv包管理器安装失败

解决方案：手动安装uv后重试

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

问题：下载依赖超时

解决方案：配置清华PyPI镜像

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

4.2 模型配置类问题

问题：API调用提示"上下文长度超出限制"

解决方案：

1. 升级到kimi-k2.6模型，该版本支持256K上下文窗口

2. 使用hermes index命令建立文档索引，系统会自动对大文件进行分块处理

3. 适当降低max_tokens参数至64000以下

问题：长文本任务成本过高

解决方案：

1. 确保启用cache_prompt: true配置，缓存命中时价格仅为标准价格的17%

2. 对于使用固定system prompt的任务，缓存命中率可达80%以上

3. 使用代码索引功能，避免重复上传相同的文件内容

问题：Agent任务中途中断

解决方案：

1. 升级到Hermes v0.14.0，该版本优化了长程任务的支持能力

2. 使用kimi-k2.6模型，该模型支持最长12小时的连续执行

3. 添加--resume参数恢复中断的任务：hermes run task.yaml --resume

4.3 其他常见问题

问题：安装完成后提示hermes: command not found

解决方案：

1. 重启终端（环境变量需要重启才能生效）

2. 手动添加环境变量：

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

   问题：Playwright浏览器安装失败

解决方案：手动运行

hermes setup tools browser

五、安装后验证与进阶操作

5.1 基础验证

运行以下命令验证安装和配置是否成功：

# 验证版本
hermes --version
# 验证模型连接
hermes chat -q "你好，请介绍一下自己" --model moonshot/kimi-k2.6
# 验证工具调用
hermes chat -q "请列出当前目录下的文件" --tools file

5.2 进阶操作

• 自定义智能体性格：编辑~/.hermes/SOUL.md文件

• 安装第三方技能：hermes skills install <技能名称>

• 配置消息网关：支持Telegram、Discord、企业微信等平台

• 版本更新：hermes update一键升级到最新版本

• 本地模型运行：配合Ollama使用Hermes 3等开源模型，完全免费

六、总结与下一步建议

总结

• 国内用户使用ghfast加速脚本可10-15分钟完成全平台部署

• 在长文本处理、代码分析和复杂Agent任务场景下，Kimi K2.6是国内用户的优选方案

• 合理利用Kimi的缓存机制和代码索引功能，可大幅降低使用成本

• 本教程所有步骤均基于官方v0.14.0版本，与官方流程完全兼容

下一步建议

1. 先运行基础验证命令，确保安装和配置正确

2. 尝试一个简单的Agent任务：hermes run https://github.com/nousresearch/hermes-agent/examples/hello-world.yaml

3. 对于有长文本需求的用户，测试Kimi的文档处理能力：hermes analyze your-document.pdf

4. 加入官方Discord社区，获取最新更新和技术支持

免责声明：本文仅作技术交流使用，所有第三方服务的使用请遵守其用户协议和隐私政策。本教程为社区维护的优化指南，官方信息以Nous Research发布的内容为准。