解锁 Hermes：从安装到启用（2）
上一篇《解锁 Hermes：从安装到启用（1)》我们已经深度认识了Hermes Agent，理清了它与OpenClaw的核心差异，也完成了Windows端WSL（Ubuntu）前置环境的搭建，配齐了所有基础依赖。今天，我们就进入核心环节——基于已搭建好的WSL环境，手把手教大家完成Hermes Agent的源码拉取、依赖安装、编译部署、初始化配置，全程实操无冗余，新手也能一步到位，顺利拥有属于自己的自主进化AI助手，同时安装Hermes的可视化界面。
目录
1.2 额外依赖补充（Hermes Agent专属，按既定命令安装）
安装Python运行环境及相关依赖（适配Hermes核心运行）
2.1 拉取Hermes Agent源码（GitHub，按既定地址拉取）
创建虚拟环境（环境名固定为hermes-venv，便于后续统一操作）
激活虚拟环境（激活成功后终端提示符前会显示(hermes-venv)标识）
2.3 安装Hermes Agent核心依赖（按既定命令，指定清华源）
2.5 初始化并启动Hermes Agent（既定最终步骤，一键执行）
一、安装前准备：确认环境与核心依赖
在正式安装Hermes Agent前，先确认WSL环境与基础依赖已全部就绪——这一步是避免后续编译、启动报错的关键，也是Hermes Agent与OpenClaw安装的核心差异之一（OpenClaw无需复杂依赖校验，可直接安装），严格按以下命令执行，不跳过任何一步。
1.1 环境校验（命令可直接复制）
打开Ubuntu终端（或Windows终端切换至Ubuntu标签），依次执行以下命令，验证环境是否符合要求，确保每一步都无报错：
运行以下命令检查是否为WSL2（若非WSL2需升级）：
wsl --version
验证Ubuntu系统版本
确认系统版本为22.04 LTS（其他版本可能导致依赖不兼容）：
lsb_release -a
验证基础依赖安装
检查以下必需依赖是否安装成功：
gcc --version
git --version
curl --version
正常输出对应版本信息，且无报错，说明环境达标；若提示某类依赖未安装，回到上一篇，重新执行依赖安装命令即可，不可跳过。
1.2 额外依赖补充（Hermes Agent专属，按既定命令安装）
相比OpenClaw，Hermes Agent由于支持自主学习、持久记忆等核心功能，需要额外安装部分依赖（主要用于编译、存储与模型交互），在Ubuntu终端依次执行以下命令：
安装Python运行环境及相关依赖（适配Hermes核心运行）
sudo apt install -y python3 python3-pip python3-venv
安装数据库支持组件（实现双文件记忆存储功能）
sudo apt install -y sqlite3 libsqlite3-dev
安装网络通信与安全组件（确保模型接口调用稳定性）
sudo apt-get install -y libssl-dev libcurl4-openssl-dev
二、核心步骤：Hermes Agent完整安装流程
本次安装严格采用“源码拉取→创建虚拟环境→安装依赖→编译配置→初始化启动”的既定流程，全程使用命令行操作，每一步都有详细说明，复制命令即可执行。
2.1 拉取Hermes Agent源码（GitHub，按既定地址拉取）
Hermes Agent开源托管在GitHub，我们直接通过git命令拉取最新源码（确保网络通畅，若拉取缓慢，可配置GitHub加速；若出现“网页解析失败”“无法连接”报错，可更换网络或使用GitHub镜像地址拉取，镜像地址可搜索“GitHub Hermes 镜像”获取）：
从GitHub克隆Hermes项目源码（使用官方仓库地址）
git clone https://github.com/NousResearch/Hermes.git
进入项目目录（后续操作均在此目录下进行）
cd Hermes
拉取完成后，执行 ls 命令，若能看到源码目录下的文件（如requirements.txt、hermes.py等），说明源码拉取成功；若拉取失败，优先检查网络，或替换镜像地址重新拉取。
2.2 创建并激活Python虚拟环境
为了避免依赖冲突（开发者常用规范操作），我们为Hermes Agent创建独立的Python虚拟环境，步骤固定，命令可直接复制，不修改环境名：
创建虚拟环境（环境名固定为hermes-venv，便于后续统一操作）
创建 Python 虚拟环境：
python3 -m venv hermes-venv
激活虚拟环境（激活成功后终端提示符前会显示(hermes-venv)标识）
source hermes-venv/bin/activate激活成功后，终端前缀会出现 (hermes-venv)，后续所有依赖安装、启动命令，都必须在虚拟环境中执行，若退出虚拟环境，需重新执行激活命令。
2.3 安装Hermes Agent核心依赖（按既定命令，指定清华源）
源码目录下已提供依赖清单（requirements.txt），我们直接通过pip安装，同时指定国内清华源加快安装速度：
安装核心依赖
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
安装必备适配组件（确保模型调用和记忆存储功能正常运行）
pip install openai openrouter-sdk pysqlite3-binary -i https://pypi.tuna.tsinghua.edu.cn/simple
安装过程中若出现“权限不足”报错，可在命令前加上 sudo（不推荐，优先确保虚拟环境激活）；若出现某依赖安装失败，可单独执行 pip install 依赖名 重新安装，若仍失败，更换镜像源后重试。
2.4 编译与配置Hermes Agent
这是Hermes Agent安装的核心步骤，主要配置模型接口、记忆存储路径，区别于OpenClaw的“即装即用”，Hermes需要简单配置后才能正常启动，严格按以下步骤操作，不跳过任何配置。
步骤1：复制配置文件并修改
复制默认配置文件
cp config/example.config.yaml config/config.yaml
使用nano编辑器修改配置文件
# 配置文件路径
nano config/config.yaml
步骤2：核心配置修改（重点，必改，按既定要求修改）
打开配置文件后，找到以下3个核心配置项，根据自身情况修改，其他配置可保持默认（注释已标注含义，无需额外修改）；若配置OpenAI模型时，出现API接口“网页解析失败”，可更换为国内可访问的模型（如Kimi、通义千问），对应修改配置即可：
-
模型配置（model）： 找到如下位置可替换为自己想使用的模型（如OpenAI的gpt-3.5-turbo、Kimi的moonshot-v1等）
model = "nous-hermes-2" -
同时配置对应模型的API密钥（若使用本地模型，可跳过API配置）：
示例（配置OpenAI模型，若接口解析失败，替换为Kimi示例）：
- OpenAI配置（接口解析失败时弃用）：
-
model: "gpt-3.5-turbo" api_key: "你的OpenAI API密钥" api_base: "https://api.openai.com/v1" - Kimi配置（替代方案，避免接口解析失败）：
-
model: "moonshot-v1" api_key: "你的Kimi API密钥" api_base: "https://api.moonshot.cn/v1"
3.记忆存储路径（memories）： 默认路径为 ~/.hermes/memories，无需修改，保持默认即可（对应上一篇提到的MEMORY.md和USER.md双文件存储），不自定义路径，避免权限问题。
4.技能库配置（skills）： 默认开启社区技能库，无需修改，配置后可自动加载内置+社区贡献的600+技能，若想关闭社区技能，可将 community_skills: true 改为 false，建议保持开启。
修改完成后，按 Ctrl+O 保存，按 Ctrl+X 退出编辑器，确保配置保存成功，不遗漏任何步骤。
步骤3：编译源码（可选，优化运行效率，按既定命令执行）
Hermes Agent支持源码编译，编译后可提升运行速度，尤其在自主学习、技能调用时更流畅，严格按以下命令编译，不修改编译参数：
核心代码编译（固定命令，请勿修改）
python3 setup.py build
安装编译包（固定命令，请勿修改）
python setup.py install
2.5 初始化并启动Hermes Agent（既定最终步骤，一键执行）
配置完成后，即可初始化并启动Hermes Agent，全程自动完成记忆目录创建、技能库加载，步骤固定，命令可直接复制，不修改任何参数：
2.6 可视化界面安装
pip install fastapi uvicorn streamlit webui-qrcode python-multipart
Hermes 使用指南
初始化 Hermes
运行以下命令创建记忆目录并加载技能库：
python3 hermes.py init
启动 Hermes Agent
执行以下命令进入交互模式（启动成功后即可开始使用）：
python3 hermes.py run
执行以下命令进入可视化模式（启动成功后即可开始使用）
streamlit run web_ui.py
启动成功后，终端会提示“Hermes Agent is ready! Type 'exit' to quit.”，此时即可开始与Hermes Agent交互，测试它的持久记忆、自主学习功能；若启动失败，对照下文常见问题排查，优先解决依赖或配置问题。
三、总结与后续使用建议（贴合既定安装方式）
到这里，基于WSL环境的Hermes Agent完整安装、初始化就全部完成了！本次实操严格遵循既定安装方式，从环境校验、依赖补充，到源码拉取、配置编译，再到启动测试，全程未新增额外步骤，命令可直接复制，确保大家能顺利按此方式完成安装。
回顾本次实操，我们全程覆盖了Hermes Agent安装的核心步骤，Hermes Agent虽安装步骤略繁琐，但配置更灵活、功能更强大，而OpenClaw更偏向“即装即用”，适合快速落地简单自动化任务，大家可根据自身需求选型。
后续使用建议，帮大家更好地发挥Hermes Agent的核心优势，贴合本次安装方式：
-
熟悉持久记忆：多与Hermes交互，让它记住你的工作习惯、项目细节，越用越贴合你的需求，按本次测试建议操作，验证记忆功能；
-
测试自主学习：让它完成复杂任务（如部署项目、编写复杂代码），观察它自动创建、优化技能的过程，体验其核心优势；
-
个性化配置：可根据自身需求，修改配置文件中的模型、记忆路径、技能库等，适配个人或企业场景，若模型接口解析失败，及时替换为国内可访问模型；
-
社区共建：若有自定义技能，可提交到Hermes GitHub社区，参与开源共建，同时也能获取更多社区贡献的实用技能，若GitHub访问失败，可通过社区镜像获取。
AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念，把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起，为开发者提供从开发、训练到部署的一站式体验。
更多推荐
17
0- 0
已为社区贡献9条内容
所有评论(0)