专栏系列第一篇认知导论从 Harness 工程到 Hermes五大核心概念厘清第二篇核心内核拆解五大支柱深度解析Memory/Skill/Soul/Crons/自进化闭环本篇为第三篇实战部署篇面向想要跑通实例的开发者提供可复制、可调试完整流程支持Windows本地、Linux VPS两套环境。前置阅读建议务必看完前两篇理解Memory、Skill五大支柱概念本篇不讲解底层原理专注动手跑通。0. 写在部署前硬件环境前置评估很多同学部署Agent踩坑第一步就是硬件预估错误Hermes不是重度微调大模型框架它属于Agent编排层框架本身不跑大模型推理模型可以外接OpenAI兼容接口DeepSeek、通义千问、Ollama本地模型。✅ 硬件最低要求Windows本地部署开发调试CPU4核8G内存起步推荐8核16G显卡非必需如果你用Ollama本地跑大模型则显存≥8G7B模型使用远程API显卡无要求系统Windows10/11开启PowerShell安装GitLinux VPS线上运行生产测试配置2核4G最低推荐4核8G磁盘≥40G系统Ubuntu 22.04 / 24.04推荐⚠️重要提醒Hermes只是智能体运行框架大模型推理消耗资源另算绝大多数新手建议优先使用API接口不要本地跑大模型减少调试障碍。✅ 需要提前准备Git环境Python 3.11小于3.13版本不兼容坑不要用3.13一个大模型API KeyDeepSeek、OpenAI、阿里云百炼均可兼容OpenAI接口格式VPS环境开放端口默认CLI模式不需要开放端口如果后续启动网关需要放行端口常见踩坑预告Python版本过高、git克隆网络超时、API代理错误、配置文件路径写错、权限不足。本篇所有命令均为PowerShell命令Windows直接复制运行文末附带Linux适配说明。1. 源码拉取克隆Hermes仓库PowerShell注意不要直接下载zip压缩包部分skill模板、子模块会缺失优先git clone。打开PowerShell切换到你想要存放项目的目录例如D:\ai_project# 切换工作目录cd D:\ai_project# gitee镜像仓库解决github访问慢问题git clone https://gitee.com/mirrors/hermes-agent.git cd hermes-agent执行完成后目录结构预览你可以在终端输入ls查看关键目录hermes-agent/ ├── config/ # 核心配置文件夹.env、人格配置hermes.md放这里 ├── skills/ # skill技能库自动生成的技能全部存在此处 ├── memory/ # memory持久化记忆存储目录运行后自动生成 ├── crons/ # Crons定时任务脚本目录 ├── docs/ # 橙皮书原版文档 └── main.py # 程序入口Demo小提示此时还不能运行没有配置密钥会直接报错。很多新手克隆完直接运行main.py出现大量报错属于正常现象。2. 依赖安装建议使用虚拟环境隔离Python依赖避免和本机其他项目包冲突强烈推荐。PowerShell Windows# 创建虚拟环境python-m venv venv# 激活虚拟环境.\venv\Scripts\Activate.ps1# 安装全部依赖pip install-r requirements.txtWindows报错PowerShell禁止运行脚本# 管理员打开PowerShell执行一次解决执行策略限制Set-ExecutionPolicyRemoteSigned-Scope CurrentUserLinux(VPS Ubuntu)对应命令参考python3-mvenv venvsourcevenv/bin/activate pip3install-rrequirements.txt依赖安装完成虚拟环境激活成功后终端提示符前面会出现(venv)代表环境生效。后续所有运行操作都必须在虚拟环境内执行。3. 核心配置文件修改配置大模型接入复制环境变量模板生成.env配置文件PowerShell# 复制模板配置Copy-Item.\config\.env.template.\config\.env用记事本 / VS Code打开config/.env文件。示例配置使用DeepSeek APIOpenAI兼容格式# LLM基础配置 LLM_BASE_URLhttps://api.deepseek.com/v1 LLM_API_KEYsk-xxxxxxxxxxxxxxxxxxxxxxxx你的key LLM_MODELdeepseek-v3 # Hermes五大支柱开关全部开启 ENABLE_MEMORYtrue ENABLE_SKILLtrue ENABLE_SOULtrue ENABLE_CRONtrue ENABLE_SELF_EVOLVEtrue # 记忆文件存储路径 MEMORY_STORE_PATH./memory # 技能库路径 SKILL_LIB_PATH./skills # 定时任务存放路径 CRON_PATH./crons # 人格配置文件路径 SOUL_CONFIG_PATH./config/hermes.md # 日志级别 DEBUG/INFO/WARN调试阶段设置DEBUG方便排查问题 LOG_LEVELDEBUG✨ 如果你想用本地Ollama模型修改这两行即可不需要api keyLLM_BASE_URLhttp://127.0.0.1:11434/v1 LLM_API_KEYdummy LLM_MODELqwen2.5:7b编辑完成保存文件。重点SOUL_CONFIG_PATH指向人格文件把橙皮书示例的hermes.md放到config目录也就是Soul支柱的人格规则。极简 hermes.md Demo样例config/hermes.md# Soul人格配置示例 你是Hermes自进化Agent遵循下面规则 1. 回答尽量简洁不要多余空话 2. 如果不会做优先尝试生成Skill技能而不是直接拒绝用户 3. 所有记忆会自动保存记住用户的偏好 4. 定时任务收到指令会写入crons目录 5. 禁止编造不存在文件执行工具前确认路径。这就完成Soul支柱基础配置对应第二篇讲的Soul人格引擎。4. CLI模式启动第一次交互调试CLI模式是开发调试首选不需要部署web网关直接终端对话用来验证Memory、Skill、自进化是否正常工作。PowerShell保证虚拟环境处于激活状态(venv)python main.py--modecli正常启动成功日志输出示例[INFO] Hermes Agent 启动中 [INFO] ✅ Memory 三层记忆模块加载完成 [INFO] ✅ Skill技能库初始化扫描 ./skills [INFO] ✅ Soul人格引擎加载 config/hermes.md [INFO] ✅ Cron调度器已就绪 [INFO] ✅ 自进化闭环模块开启 [INFO] CLI交互模式就绪请输入你的指令exit退出 Demo实操样例1测试记忆模块Memory支柱在cli输入框输入我的名字叫森迪居住在西安平时喜欢研究AI Agent开发Agent正常应答之后继续输入我叫什么住在什么地方✅预期效果Agent读取持久记忆正确输出你的名字和城市。底层行为这条信息会写入memory目录下的事实记忆json文件。你可以打开memory/fact_memory.json肉眼查看写入的内容这就是第二篇提到的三层记忆中的持久事实记忆。❌异常现象记不住信息。排查检查.env中ENABLE_MEMORYtrue确认memory文件夹有读写权限。 Demo实操样例2触发自动生成SkillSkill支柱CLI输入指令让Agent生成一个简单技能帮我写一个skill实现读取当前目录所有txt文件统计文件行数✅预期行为Agent判断现有技能库没有该能力触发技能自动生成流程在skills/目录输出count_txt_lines.skill.md调用该skill执行任务输出统计结果。打开生成的skill文件样例内容参考## skill_name: count_txt_lines ## description: 统计当前目录所有txt文件总行数 ## params: {}importosdefrun():total0forfilenameinos.listdir(.):iffilename.endswith(.txt):withopen(filename,r,encodingutf-8)asf:lineslen(f.readlines())totallinesprint(f{filename}:{lines}行)print(f全部txt合计{total}行)if__name____main__:run()这就是Hermes核心能力按需自动产出Skill存入技能库后续同类请求直接复用不用重复生成对应第二篇的自进化闭环。 Demo实操样例3测试Crons定时调度cli输入每间隔30秒输出一句hello hermes✅预期Agent将定时任务写入crons/文件夹调度器循环执行终端周期性打印输出。注意CLI模式下crons仅进程存活期间生效程序关闭定时任务暂停。输入exit退出CLI终端。5. 常见部署排错清单高频问题现象排查方案启动直接报错LLM接口401API Key错误、检查LLM_BASE_URL地址是否正确部分服务商需要去掉/v1后缀模型返回正常但是无法生成Skill检查ENABLE_SKILLtrue大模型能力不足更换更强模型记忆无法保存memory文件夹为空目录读写权限不足Windows不要放在系统保护目录python包报错模块找不到确认已经激活venv虚拟环境重新执行pip install -r requirements.txtgit clone失败使用gitee镜像地址不要用github源6. VPS后台常驻运行线上部署进阶在VPS上想要后台持续运行关闭ssh连接程序不终止使用tmux。tmux new-shermes# 激活虚拟环境sourcevenv/bin/activate python3 main.py--modecli按CtrlB再按D脱离会话程序后台运行重新接入会话tmux a -t hermes。⚠️注意本篇只讲CLI调试模式Web网关、MCP服务属于第四篇《落地场景开发》内容本篇不展开。7. 本篇小结 下一篇预告本篇完整走完源码拉取、依赖安装、环境变量配置、CLI交互调试全流程。通过3个小Demo直接观测Memory、Skill、Crons五大支柱真实运行效果不再是纸上架构。你现在已经拥有一个本地可以跑的Hermes实例可以记住用户信息Memory遇到未知任务自动生成技能复用Skill加载自定义人格规则Soul支持简单定时任务Crons全部行为落地文件可以直接观察框架输出产物。下一篇第四篇《落地场景开发MCP集成、多平台网关、自定义Skill开发》我们会脱离纯CLI模式对接MCP工具协议开发自定义Skill搭建网关实现外部程序调用Hermes Agent实战子Agent协同。