后面配置QQ和微信，完全可以直接使用hermes对话完成，让hermes给你配。你只要扫码即可。
下面由AI整理的：
# Hermes Agent 在 NAS 上的完整部署指南
> 本文档记录了在 **TOS（铁威马NAS操作系统）** 系统上手动部署 Hermes Agent 的全过程。由于 NAS 网络环境受限，无法直接使用官方一键安装脚本，因此采用纯手动方式逐步完成安装。
---
##
准备工作：了解 Hermes Agent**Hermes Agent** 是由 Nous Research 开发的**自我进化型 AI 智能体**。它具备以下核心特性：
* **持续学习循环**：能从经验中创建技能，在使用中自我改进，并跨会话保持记忆
* **多平台接入**：支持 Telegram、Discord、Slack、WhatsApp、Signal 及 CLI 等多种交互方式
* **模型无关性**：支持 OpenAI、OpenRouter、自建端点等任意模型，通过 `hermes model` 命令随时切换
* **轻量部署**：可在 $5 VPS、GPU 集群或无服务器架构上运行
---
##
第一步：获取源代码由于 NAS 通常无法直接访问 GitHub（网络限制），推荐采用**本地下载后上传**的方式：
### 方式一：本地下载后上传（推荐）
1. 在**本地电脑**上访问项目仓库：
```bash
# 使用浏览器访问或通过 git 克隆
git clone https://github.com/NousResearch/hermes-agent.git
```
>
**注意**：由于网络环境限制，NAS 可能无法直接使用 `git clone`，因此建议在本地完成下载。2. 将下载的 `hermes-agent` 文件夹通过 **SMB/FTP/WebDAV** 等协议上传至 NAS 的用户目录（例如 `~/`）
### 方式二：直接在 NAS 上尝试克隆（如果网络条件允许）
```bash
cd ~
git clone https://github.com/NousResearch/hermes-agent.git
```
---
##
第二步：安装 UV 包管理器**UV** 是一个极速的 Python 包安装和项目管理工具，由 Astral 团队开发（Ruff 的作者）。Hermes Agent 官方推荐使用 UV 管理 Python 环境。
在 NAS 的终端中执行：
```bash
# 下载并安装 UV
curl -LsSf https://astral.sh/uv/install.sh | sh
# 安装完成后，重新加载 shell 环境使其生效
source ~/.bashrc
```
**验证安装：**
```bash
uv --version
# 应输出类似：uv 0.5.0 或更高版本
```
---
##
第三步：创建 Python 3.11 虚拟环境Hermes Agent **要求 Python 3.11 或更高版本**。但 TOS 系统默认自带的 Python 版本通常为 3.10（或更低），**为了避免破坏系统级 Python 环境**，我们使用 UV 创建独立的虚拟环境。
```bash
# 在用户目录下创建名为 hermes_env 的虚拟环境，指定 Python 3.11
uv venv ~/hermes_env --python 3.11
```
**如果提示找不到 Python 3.11：**
UV 会自动下载缺失的 Python 版本，无需手动安装。
---
##
第四步：激活虚拟环境激活后，所有 Python 和 pip 操作都将局限在该环境中，不会影响系统：
```bash
source ~/hermes_env/bin/activate
```
**检查 Python 版本：**
```bash
python --version
# 应该显示：Python 3.11.x
```
---
##
第五步：安装 Hermes Agent 及依赖进入项目目录并激活虚拟环境后，使用 pip 安装 Hermes Agent。
```bash
# 进入项目目录
cd ~/hermes-agent-main
# 确保虚拟环境已激活
source ~/hermes_env/bin/activate
# 使用清华镜像源安装（解决网络问题）
pip3 install -e . -i https://pypi.tuna.tsinghua.edu.cn/simple
```
>
**关于 `-e` 参数**：`-e` 表示以"可编辑模式"安装，方便后续更新代码。---
###
安装失败排查由于 Hermes Agent 包含大量编译型依赖（如 `chromadb`、`sentence-transformers` 等），安装过程中可能出现编译错误。
#### 常见问题 1：缺少编译工具
**错误现象**：`error: command 'gcc' failed` 或 `fatal error: Python.h: No such file or directory`
**解决方案**：安装基础编译工具和 Python 开发头文件
```bash
# 更新包列表
sudo apt-get update
# 安装编译工具链
sudo apt-get install -y build-essential python3-dev
# 部分依赖可能需要额外库
sudo apt-get install -y cmake libopenblas-dev
```
**重新尝试安装：**
```bash
pip3 install -e . -i https://pypi.tuna.tsinghua.edu.cn/simple
```
#### 常见问题 2：内存不足
NAS 设备内存可能较小，编译大型依赖时容易失败。可尝试：
```bash
# 启用 swap 分区（临时增加虚拟内存）
sudo fallocate -l 4G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
```
安装完成后可关闭 swap：
```bash
sudo swapoff /swapfile
sudo rm /swapfile
```
---
##
第六步：创建全局软链接为了能够在**任何目录**下直接使用 `hermes` 命令，而不必每次都进入虚拟环境目录，创建一个软链接：
```bash
# 创建用户本地 bin 目录（如果不存在）
mkdir -p ~/.local/bin
# 创建软链接
ln -sf ~/hermes_env/bin/hermes ~/.local/bin/hermes
# 确保 ~/.local/bin 在 PATH 中
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
```
**验证是否生效：**
```bash
hermes --version
# 应正常显示版本信息
```
---
##
第七步：初始配置（hermes setup）运行设置向导，完成基础配置：
```bash
hermes setup
```
1. **浏览器授权**：首次运行会提示点击链接跳转至认证页面
2. **选择套餐**：选择 **Free（免费版本）** 即可
3. **点击 Connect**：完成账户连接
---
##
后续配置：接入大模型（可选）`hermes setup` 完成基础配置后，可通过以下方式接入自定义模型：
```bash
# 查看当前模型设置
hermes model
# 切换至 DeepSeek（示例）
hermes model deepseek
# 切换至 OpenAI
hermes model openai:gpt-4
# 切换至自定义端点
hermes model custom:http://localhost:8080/v1
```
>
更多模型配置方式请参考：[官方文档 - 模型集成](https://hermes-agent.nousresearch.com/d ... /providers)---
##
快速启动配置完成后，即可开始使用：
```bash
# 启动交互式 CLI
hermes
# 或启动消息网关（Telegram/Discord 等）
hermes gateway start
```
---
##
常见问题速查表| 问题 | 可能原因 | 解决方案 |
|------|----------|----------|
| `hermes: command not found` | 软链接未加入 PATH | 执行 `source ~/.bashrc` 或检查 `~/.local/bin` 是否在 PATH 中 |
| `Python.h: No such file or directory` | 缺少 Python 开发头文件 | `sudo apt-get install python3-dev` |
| `gcc: command not found` | 缺少编译工具 | `sudo apt-get install build-essential` |
| 安装依赖时网络超时 | 默认 PyPI 源访问慢 | 使用清华源：`-i https://pypi.tuna.tsinghua.edu.cn/simple` |
| 内存不足导致编译失败 | NAS 内存较小 | 启用 swap 交换分区或关闭其他进程 |
---
##
参考资源* [Hermes Agent 官方文档](https://hermes-agent.nousresearch.com/docs/)
* [GitHub 仓库](https://github.com/NousResearch/hermes-agent)
* [UV 官方文档](https://docs.astral.sh/uv/)
* [清华 PyPI 镜像](https://mirrors.tuna.tsinghua.edu.cn/help/pypi/)
---
> **最后更新**：2026-08-01
> **环境**：TOS（铁威马NAS） + Python 3.11 + UV
