[智能体-542]：Hermes Agent 完整安装与使用全教程

Hermes Agent 是 Nous Research 开源、基于 LangChainLangGraph 的本地常驻自进化智能体全部数据本地存储支持 MCP 本地工具、分层持久记忆、24 小时后台 Daemon 运行适配写书、本地代码研发、私密批量生产场景。一、系统支持与前置准备1. 支持系统Linux /macOS/ WSL2推荐兼容性最好Windows 原生 PowerShellBeta 测试版部分功能受限Android Termux、Docker/VPS 云服务器2. 必备材料大模型 API KeyDeepSeek、Kimi、Claude、通义千问、OpenAI、Ollama 本地模型均可网络能访问 Github / 官方源国内可使用国内镜像安装脚本最低硬件1 核 1G VPS / 普通笔记本无需独立 GPU仅本地 Ollama 需要显卡二、分平台一键安装官方脚本自动处理全部依赖方案 1Linux /macOS/ WSL2首选推荐打开终端执行一行安装命令官方原版bash运行curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash国内镜像加速版解决 Github 下载慢bash运行curl -fsSL https://res1.hermesagent.org.cn/install.sh | bash安装完成后重载环境变量让hermes命令生效bash运行# zsh用户macOS默认 source ~/.zshrc # bash用户Linux/WSL source ~/.bashrc验证是否安装成功bash运行hermes --version方案 2Windows 原生 PowerShellBeta右键开始菜单以管理员身份打开 PowerShell执行安装脚本powershelliex (irm https://hermes-agent.nousresearch.com/install.ps1)国内镜像版powershellirm https://res1.hermesagent.org.cn/install.ps1 | iex说明Windows 原生版缺少部分 POSIX 终端工具重度 MCP 代码开发建议改用 WSL2。方案 3Docker 容器一键部署VPS / 服务器 7×24 常驻bash运行# 拉取镜像 docker pull nousresearch/hermes-agent # 启动容器挂载本地记忆/配置目录持久化数据 docker run -d \ -v ~/hermes-data:/root/.hermes \ -p 8080:8080 \ --name hermes \ nousresearch/hermes-agent三、初始化核心配置安装后必做1. 交互式完整初始化向导bash运行hermes setup向导会依次引导配置模型服务商DeepSeek / 通义千问 / Claude/Ollama 等填入 API Key、模型接口地址开启 / 关闭本地文件读写、终端执行、浏览器工具权限启用五层持久记忆系统、技能自动沉淀配置消息网关微信 / 飞书 / Telegram 远程下发任务2. 单独修改模型配置常用bash运行# 切换大模型提供商、修改API密钥 hermes model # 查看当前生效模型 hermes model status3. 配置文件路径所有配置、记忆、技能、书稿素材统一存在本地目录不上传第三方云端Linux/macOS/WSL~/.hermes/config.yamlWindowsC:\Users\你的用户名\.hermes\config.yaml四、基础使用三种交互模式模式 1CLI 命令行对话最常用本地直接交互bash运行# 启动单次对话会话 hermes chat示例写书指令适配你畅销书流水线场景plaintext我要写一本职场成长畅销书先做市场调研输出5个爆款选题再搭建全书完整大纲分章节输出正文自动校验逻辑与案例。内置会话快捷指令对话内直接输入/new开启全新独立会话自动保存上一轮完整记忆/reset清空当前会话保留全局长期记忆库/save skill手动把本次任务流程沉淀为可复用 Skill 技能/memory search 职场写书检索历史书稿记忆模式 2TUI 终端可视化面板bash运行hermes tui带分栏界面对话区、记忆库预览、技能列表、任务执行日志适合长期写书、研发项目管理。模式 3Daemon 后台常驻核心特色7×24 小时运行bash运行# 后台启动常驻服务 hermes start # 查看后台运行状态 hermes status # 重启后台服务修改MCP/模型配置后执行 hermes restart # 停止后台进程 hermes stop常驻后可通过消息网关微信 / 飞书 / 钉钉手机远程下发写书、代码任务电脑不用一直开着终端。五、核心功能配置与实操写书 / 本地生产刚需1. 五层持久化记忆系统Hermes 核心差异化能力启用与管理bash运行# 初始化记忆库向量数据库ChromaDB hermes memory setup # 查看记忆占用、存储状态 hermes memory status # 检索历史书稿/项目记忆 hermes memory search 畅销书大纲 # 重建向量索引记忆丢失、检索失效时修复 hermes memory reindex自定义全局基础记忆编辑~/.hermes/MEMORY.md写入固定人设、写书规范、项目资料每次启动自动加载不会遗忘全书人设、写作框架。2. MCP 本地工具双向打通联动 TRAE/Cursor 代码 IDE、本地文件Hermes 原生支持 MCP 客户端 服务端双模式打通本地生产工具闭环① 连接外部 MCP 服务TRAE、Claude Code 绘图服务编辑config.yaml添加 MCP 服务配置yamlmcp_servers: trae: command: trae-mcp serve env: {}重启 Hermes 生效hermes restart② 将 Hermes 自身暴露为 MCP 服务给 Cursor 调用bash运行hermes mcp serve本地代码 IDE 可直接调用 Hermes 的记忆、写书、批量素材生成能力。3. Skill 自进化技能沉淀自动复用写书流水线完整执行一次「市场调研→大纲→写作→审稿」写书任务后Hermes 自动复盘流程生成标准化Skill.md存入技能库下次同类写书任务自动调用无需重复写完整指令。 手动管理技能命令bash运行# 查看全部已沉淀技能 hermes skill list # 手动导出当前任务为可复用技能 hermes skill save write_book # 执行已有写书技能 hermes skill run write_book4. 消息网关手机微信 / 飞书远程控制常驻 Hermes支持微信、企业微信、飞书、钉钉、Telegram 远程下发写书任务bash运行# 启动网关配置向导 hermes gateway setup # 查看网关在线状态 hermes gateway status配置完成后微信给机器人发消息即可触发后台批量写书、素材生成电脑 7×24 小时后台运行。5. 定时 Cron 批量自动化生产后台 Daemon 支持定时批量生成书稿、归档素材、生成每日写作复盘 编辑~/.hermes/cron.yaml配置定时任务示例yamljobs: - name: daily_write_review schedule: 0 20 * * * prompt: 汇总今日书稿进度整理写作素材存入记忆库重载定时任务hermes cron reload六、完整实操示例用 Hermes 批量创作畅销书后台常驻启动bash运行hermes start开启对话下发完整写书任务plaintext你是专业图书策划执行完整畅销书流水线 1. 调研近一年职场成长类图书痛点与爆款结构 2. 输出3个差异化选题精准读者画像 3. 选定最优选题搭建全书四卷式完整目录、统一写作规范存入记忆 4. 分章节逐章撰写正文每章完成后自动审稿校验逻辑、案例、情绪钩子 5. 不合格章节自动回流重写全部完成后生成配套营销书名、短视频带货脚本。任务完成后自动沉淀write_career_book技能下次直接一键执行bash运行hermes skill run write_career_book检索全部书稿记忆修改迭代新版书籍bash运行hermes memory search 职场成长书稿七、常用运维、更新、卸载命令1. 版本更新bash运行hermes update2. 环境自检排查 MCP、记忆、模型连接故障bash运行hermes doctor3. 完整卸载保留记忆 / 彻底删除二选一bash运行# 仅卸载程序保留书稿、记忆、技能文件 hermes uninstall # 彻底删除全部本地数据谨慎执行 rm -rf ~/.hermes八、优缺点与适配场景总结优势全本地私有化书稿、源码、记忆不上传第三方平台隐私安全基于 LangGraph 实现闭环自进化越用效率越高自动沉淀可复用写书 / 研发技能原生 MCP 双向协议完美联动本地 TRAE/Cursor 代码 IDE低配 VPS 即可 24 小时常驻手机微信远程下发批量生产任务MIT 开源无商用限制无平台订阅费仅承担模型 API 调用成本。短板无可视化拖拽画布上手需要基础终端操作能力无原生绘图、数字人、短视频渲染能力多模态内容需对接第三方 MCP不能对外提供网页 Bot、无抖音 / 飞书公域流量分发能力仅适合内部私密生产。最佳适配人群AI 超级个体、工作室私密批量写书、软件开发书稿 / 源码高度敏感拒绝数据上传 Coze/Dify 第三方云端重度使用本地代码工具需要 24 小时后台自动化批量生产希望长期沉淀工作流程AI 越用越智能降低重复指令成本。九、与 Coze/Dify 底层安装逻辑对比Coze纯云端 SaaS无需本地安装浏览器直接使用数据存储字节云DifyDocker 一键私有化 Web 平台自带可视化画布底层少量复用 LangChain无 LangGraph 循环调度Hermes Agent本地 / VPS 自部署 CLI/TUI 框架底层强依赖 LangChainLangGraph 实现自进化循环主打私密后台批量生产。