2026年Hermes-Agent 安装配置完全指南

大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。

Hermes-Agent 是由 Nous Research 开发的开源自改进型 AI 智能体框架，定位为"与你共同成长的智能体"，核心优势在于具备持续学习能力、跨会话记忆沉淀和多场景适配性，可通过插件化架构灵活扩展功能，支持本地、云端等多种部署方式，所有对话、记忆及技能数据均存储在本地，保障隐私安全。

本文档将详细介绍其安装、配置、启动及常见问题排查方法，适用于 Linux、macOS、WSL2 及 Android（Termux）环境，助力用户快速上手使用。

推荐系统：Linux（任意发行版）、macOS，体验**，可直接安装部署
Windows 系统：不支持原生安装，需先安装 WSL2（Windows Linux 子系统），在 WSL2 环境中执行后续操作
Android 系统：支持通过 Termux 终端安装，官方提供专用安装路径
不支持：原生 Windows 系统（非 WSL2 环境）

Hermes-Agent 安装脚本会自动处理大部分依赖，用户仅需提前安装以下必备软件：

Git：用于拉取项目相关资源，确保终端可执行 git 命令
网络环境：需保证网络通畅，用于下载安装脚本及相关依赖包，若网络受限，可配置代理

其余依赖（如 Python 3.11、Node.js v22、ripgrep、ffmpeg 等）将由安装脚本自动下载配置，无需手动操作。

Hermes-Agent 本身仅作为 AI 模型 API 客户端，不本地运行模型，因此硬件要求极低：

CPU：无特殊要求，普通家用/办公 CPU 即可
内存：建议 ≥2GB，满足基础运行需求
硬盘：预留 ≥100MB 存储空间，用于存储安装文件、配置及本地数据
GPU：无需独立 GPU，仅在本地部署模型（如通过 Ollama）时，建议配备 GPU 提升推理速度

所有支持系统（除 Android 外）均采用一键安装命令，步骤简洁，Android（Termux）环境安装需参考官方专用路径。

打开终端（Linux/macOS 直接打开终端，Windows 打开 WSL2 终端）

执行一键安装命令，该命令将自动下载安装脚本并完成全部依赖配置：

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

安装完成后，需重新加载 shell 配置，使 Hermes-Agent 命令生效：
- bash 终端：source ~/.bashrc
- zsh 终端：source ~/.zshrc
安装验证：在终端输入 hermes --version，若能正常显示版本信息，说明安装成功

需先在 Android 设备上安装 Termux 终端，打开 Termux 后，参考官方专用安装路径执行安装命令（具体命令可查阅 Hermes-Agent 官方文档，确保与最新版本适配），安装流程与上述步骤类似，安装完成后同样需验证命令可用性。

若之前使用过 OpenClaw，Hermes-Agent 支持一键迁移其数据（记忆、偏好、技能、API 密钥等），且两者可共存，互不干扰：

自动迁移：安装完成后首次运行 hermes setup，系统会自动检测 ~/.openclaw 目录，并询问是否迁移
手动迁移：若未触发自动迁移，可执行以下命令手动迁移：
- 全量迁移（含密钥等敏感信息）：hermes claw migrate --preset full
- 仅迁移用户数据（不含敏感信息）：hermes claw migrate --preset user-data

Hermes-Agent 安装完成后，需进行基础配置（主要为模型提供商配置），部分高级配置可根据需求选择性调整，所有配置均通过终端命令完成，无需修改配置文件。

运行以下命令进入模型配置界面，根据引导选择合适的 LLM 提供商：

hermes model

主要支持的模型提供商及配置说明：

Nous Portal：基于订阅制，零配置，通过 OAuth 登录即可使用
OpenRouter：支持 200 多种模型，需提前获取 API 密钥并输入配置
本地/自定义端点：支持所有兼容 OpenAI API 的端点（如 Ollama、vLLM、SGLang 等），适合离线使用，需配置对应端点地址
其他提供商：包括 OpenAI（Codex）、Anthropic（Claude）、Kimi/月之暗面、MiniMax、DeepSeek、千问等，国内模型均为内置，无需中转，按引导输入 API 密钥即可

可同时配置多个模型提供商，在对话中使用 /model (provider:model) 命令快速切换模型，满足不同场景需求（如写作用 Claude、代码用 DeepSeek）。

若需在手机端（如 Telegram、Discord、飞书等）与 Hermes-Agent 交互，需配置消息网关：

执行网关配置命令，根据引导选择需要连接的平台并完成授权：
```
hermes gateway setup
```
配置完成后，启动网关后台进程：
```
hermes gateway start
```

支持的消息平台：Telegram、Discord、Slack、飞书（推荐，配置简单）、钉钉、企业微信、WhatsApp、Signal、Email、Home Assistant 等；微信可接入，但存在封号风险，谨慎使用。

多实例运行：可同时运行多个 Hermes-Agent 实例，每个实例拥有独立的配置、记忆和技能，适用于不同场景（如工作助手、新闻整理）
子代理配置：支持启动最多 3 个子代理，可将大任务拆分为多个子任务并行执行，提升效率
辅助模型配置：Hermes-Agent 内置 Auxiliary Models 模块，自动分配轻量模型处理图像分析、网页提取等侧任务，默认优先使用 Gemini Flash，无需手动配置

CLI 模式（推荐，基础使用）：终端输入以下命令，进入全交互式终端界面，可直接与 Hermes-Agent 聊天并使用工具：
```
hermes
```
消息网关模式（手机端使用）：已完成网关配置后，启动网关进程（hermes gateway start），即可通过已连接的消息平台与 Hermes-Agent 交互
后台运行：可结合 nohup 命令实现后台运行，避免终端关闭后进程终止（如：nohup hermes &）

在 CLI 模式或消息交互中，可使用以下斜杠命令提升使用效率：

/new 或 /reset：开启新对话，清除当前会话上下文
/model (provider:model)：快速切换模型提供商及具体模型
/skills：浏览当前已安装的所有技能
/usage：查看当前 Token 使用情况

问题现象：执行安装命令后报错，提示"curl: (7) Failed to connect to raw.githubusercontent.com port 443"

解决方案：检查网络连接，若网络受限，配置代理后重新执行安装命令，或手动下载安装脚本后执行。

问题现象：安装完成后，输入 hermes 命令提示"command not found"

解决方案：重新执行 shell 配置加载命令（source ~/.bashrc 或 source ~/.zshrc），若仍无效，重启终端后重试。

问题现象：权限不足，安装过程中提示"Permission denied"

解决方案：在安装命令前添加 sudo 提升权限，即 sudo curl -fsSL ... | bash。

问题现象：配置模型后，无法正常使用，提示"API key invalid"

解决方案：检查 API 密钥是否输入正确，确认密钥未过期，若为第三方提供商（如 OpenAI），检查账号是否有可用额度。

问题现象：本地模型（如 Ollama）无法连接

解决方案：确认本地模型已启动，检查端点地址配置正确，确保 Hermes-Agent 可访问本地模型端口。

问题现象：启动 Hermes-Agent 后，终端卡住或报错"Memory initialization failed"

解决方案：检查 ~/.hermes 目录权限，确保当前用户有读写权限，若权限异常，执行 chmod -R 755 ~/.hermes 赋予权限。

问题现象：消息网关启动失败，提示"Gateway connection failed"

解决方案：检查网络连接，确认已完成对应平台的授权配置，重新执行 hermes gateway setup 重新配置。

问题现象：执行 OpenClaw 迁移命令后，提示"No OpenClaw directory found"

解决方案：检查 OpenClaw 安装目录是否为 ~/.openclaw，若目录路径不同，需手动指定目录，或确认 OpenClaw 已正确安装。

数据存储：所有对话记录、记忆、技能及配置文件均存储在 ~/.hermes 目录下，可手动备份该目录，避免数据丢失
版本更新：执行 hermes update 命令可更新 Hermes-Agent 至最新版本
开源协议：Hermes-Agent 采用 MIT 协议开源，可自由部署、修改及商用，无需支付任何费用，仅需承担模型 API 相关费用（若使用第三方模型）
技能生态：支持直接使用 OpenClaw 社区的技能，可通过 Skills Hub 安装，也可通过迁移功能导入原有 OpenClaw 技能
官方资源：若需更详细的配置说明或问题排查，可查阅 Hermes-Agent 官方 GitHub 仓库及文档

（注：文档部分内容可能由 AI 生成）

2026年Hermes-Agent 安装配置完全指南

相关推荐