**核心速览：**Hermes Agent 是 Nous Research 开发的自进化 AI 智能体，支持 Linux、macOS、WSL2 和 Termux 系统，不支持 Windows 原生运行（需通过 WSL2 部署）。推荐使用一键安装方式，约 2 分钟即可完成，后续通过 hermes setup 命令配置，hermes 命令启动聊天。而国内用户注意，本教程推荐搭配 Kimi 大模型使用，无需特殊网络，中文理解和智能体任务表现出色。

一、准备工作与环境要求

• 系统支持：Linux、macOS、WSL2（Windows）、Termux（Android）

• 基础工具：git、curl（一键安装会自动补全）

• Python：3.11+（安装脚本自动安装 uv 与 Python 3.11）

• 大模型服务：需提前准备对应平台的 API 密钥

  • 国内推荐：Kimi（无需特殊网络，200 万字超长上下文）、智谱 AI、通义千问
  • 国外推荐：Nous Portal（官方原生集成）、OpenRouter（200+ 模型可选）、OpenAI、Anthropic

• 网络：需联网下载依赖，国内用户建议用镜像源

• 权限：无需 sudo，安装在用户目录下

二、各平台安装步骤（推荐优先）

Linux/macOS/WSL2 一键安装（推荐）

# 官方源（全球通用）
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

# 国内镜像源（推荐中国大陆用户）
curl -fsSL https://res1.hermesagent.org.cn/install.sh | bash

安装完成后执行：

# Bash用户
source ~/.bashrc
# Zsh用户
source ~/.zshrc

# 验证安装
hermes --version  # 应显示v0.8.0+
hermes doctor     # 检查环境配置

Windows 系统安装（通过 WSL2）

1. 启用 WSL2 并安装 Ubuntu：

wsl --install -d Ubuntu

1. 重启后打开 Ubuntu 终端，执行一键安装命令（同上）
2. 配置 WSL2（可选，提升性能）：

sudo nano /etc/wsl.conf
# 添加以下内容
[wsl2]
memory=8GB
processors=4

1. 在 PowerShell 重启 WSL2：wsl --shutdown，再重新打开 Ubuntu

Termux（Android）安装

# 安装依赖
pkg update -y && pkg install -y git curl python

# 一键安装
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install-termux.sh | bash

# 配置环境
source ~/.bashrc
hermes doctor

手动安装（适合开发者）

# 克隆仓库（含子模块）
git clone --recurse-submodules https://github.com/NousResearch/hermes-agent.git
cd hermes-agent

# 安装依赖（推荐用uv）
pip install uv
uv venv
source .venv/bin/activate
uv pip install -e .[all]

# 配置环境变量
echo "export PATH=\$PATH:$(pwd)/.venv/bin" >> ~/.bashrc
source ~/.bashrc

# 验证
hermes --version

Docker 安装（隔离环境）

# 克隆仓库
git clone https://github.com/NousResearch/hermes-agent.git
cd hermes-agent

# 构建镜像
docker-compose build

# 启动容器
docker-compose up -d

# 进入容器
docker-compose exec hermes-agent bash

# 配置并使用
hermes setup
hermes

三、首次配置（关键步骤）

1. 启动配置向导：

hermes setup

1. 选择连接方式（三选一）：

   • 国内用户首选：Kimi**，**输入 API 密钥即可快速连接，无需特殊网络环境，中文语境理解精准自然，支持 200 万字超长上下文与多格式文档解析，在代码编写、工具调用和长程任务执行方面表现出色，与 Hermes 智能体特性高度契合；也可选通义千问（性价比高）或智谱 AI（数学推理强）
   • 国外用户推荐：优先选择 Nous Portal 或 OpenRouter，也可直接使用 OpenAI、Anthropic 等官方接口
   • 自定义端点：连接本地部署大模型（如 llama.cpp、vLLM、Ollama）或其他兼容 OpenAI 协议的服务

2. 配置记忆存储：默认 SQLite（轻量），可改为 PostgreSQL/Redis

3. 启用技能：选择需要的内置技能（终端执行、文件操作、网页检索等）

四、基础使用指南

1. 启动聊天：

hermes

1. 常用命令：

   • /help：查看帮助
   • /model：切换大模型
   • /skills：管理技能
   • /memory：查看/编辑长期记忆
   • /exit：退出聊天

2. 示例任务：

> 帮我写一个Python脚本计算斐波那契数列前10项 > 分析当前目录下的日志文件，找出错误信息 > 帮我预订明天下午3点的会议室

五、常见问题与解决方案

1. 安装失败：

   • 网络问题：切换国内镜像源
   • 权限问题：不要用 sudo，安装在用户目录
   • 依赖缺失：执行 hermes doctor 检查并修复

2. 启动报错：

   • 环境变量未加载：重新执行 source ~/.bashrc 或 source ~/.zshrc
   • Python 版本错误：安装脚本会自动安装 3.11，无需手动干预

3. 模型连接失败：

   • 检查 API 密钥是否正确
   • 确保网络能访问模型端点
   • 本地模型需配置正确的端口和协议

4. 技能无法使用：

   • 检查技能是否已启用（/skills）
   • 确保有足够权限（如文件操作需对应目录权限）

六、进阶配置（可选）

1. 自定义模型：

hermes model add --name "本地Llama3" --type "openai" --base-url "http://localhost:8000/v1" --api-key "sk-xxx"

1. 配置消息平台集成（如 Discord、Telegram）：

hermes integrations add discord --token "your-bot-token"

1. 启用自动更新：

hermes config set auto_update true

七、总结

Hermes Agent 支持主流操作系统，采用一键式安装流程，仅需一行命令即可完成部署。安装完成后，用户可通过内置配置向导快速接入大模型服务，开始使用这款具备持续学习能力的 AI 智能体。为提升安装体验，国内用户推荐使用中文社区镜像源，Windows 平台用户建议优先采用 WSL2 环境。在大模型选择上，Kimi 是国内用户的理想之选：它无需特殊网络配置，中文语义理解精准，拥有卓越的长文本处理能力，在代码生成、工具调用和长程任务执行方面表现优异，与 Hermes Agent 的智能体特性高度适配。

---

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