关于HermesAgent是什么可以看《关于爱马仕Hermes Agent是什么》关于WSL2和Ubuntu的安装可以看《WSL2和Ubuntu安装记录》关于Ubuntu的迁移可以看《Ubuntu迁移记录》接下来接着Ubuntu迁移记录接着往下记录安装HermesAgent的过程。01 第一次安装首先进入WSL2的Ubuntu的终端在Ubuntu终端中粘贴并运行下面的指令代码curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash1.1 指令功能作用是从 GitHub 拉取官方安装脚本并直接在本地 bash 中执行完成 Hermes Agent 及其运行依赖的全自动安装。执行截图如下1.2、安装日志解析系统与基础工具安装✅ 系统识别检测到当前系统为 linux (ubuntu)x86_64 架构。✅ uv 安装将 Python 包管理工具 uv 安装到 ~/.hermes/bin 目录成功安装 uv 0.11.26。uv 是高性能 Python 包 / 环境管理工具用来替代传统 pip大幅提升 Python 依赖安装速度。Python 环境安装检测系统 Python 3.11发现不存在自动通过 uv 下载安装。✅ 成功安装 Python 3.11.15耗时 12.62 秒。⚠️ PATH 警告重要warning: /home/leigong/.local/bin is not on your PATH.含义刚安装的 Python 可执行文件所在目录没有加入系统环境变量 PATH。后果直接输入 python3.11 会提示 “命令不存在”。配套依赖检测✅ Git已找到 Git 2.34.1满足要求。✅ Node.js系统原本没有自动安装 Node.js 22 LTSv22.23.1到 ~/.hermes/node/ 目录用于支持浏览器相关工具能力。网络连通性检查关键警告⚠️ 核心问题Could not reach https:/IP省略/.com/Network checks failed.含义脚本无法访问 DuckDuckGo 搜索引擎网络连通性校验未通过。影响安装流程本身可能还能继续走完但后续 pip 依赖下载、网页搜索功能 大概率会失败。这是国内环境最常见的问题GitHub、DuckDuckGo 等境外站点访问受限。脚本给出的官方提示如果后续 pip 安装失败请检查网络 / DNS 后重试。可选系统依赖正在检查两个可选工具ripgrep快速全文文件搜索提升 Agent 文件检索速度ffmpeg用于 TTS 语音消息功能。提示这两个包需要 sudo 权限通过系统包管理器安装Hermes Agent 本体不需要 root 权限。1.3、操作建议根据上面指令的执行情况根据AI建议先 CtrlC 中断安装配置好终端代理能访问 GitHub、境外源后再重新执行安装命令否则后续 Python 依赖拉取大概率会报错失败。于是先按CtrlC 中断安装02 前置环境优化前面的一键安装失败的情况下又搜索了几个安装教程结合AI问答进行了下面的操作下面是操作过程记录。2.1、替换系统apt源# 备份原源文件sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak# 替换为清华镜像源sudo sed -i ”shttp://.*archive.ubuntu.comhttps://mirrors.tuna.tsinghua.edu.cng” /etc/apt/sources.listsudo sed -i ”shttp://.*security.ubuntu.comhttps://mirrors.tuna.tsinghua.edu.cng” /etc/apt/sources.list# 更新源缓存sudo apt update执行截图如下截图1截图22.2、配置uv国内PyPI源Hermes 使用 uv 作为 Python 包管理器提前配置清华镜像源避免依赖下载超时# 创建 uv 配置目录mkdir -p ~/.config/uv# 写入镜像源配置cat ~/.config/uv/uv.toml EOF[pypi]index-url ”https://pypi.tuna.tsinghua.edu.cn/simple”EOF执行截图如下03 再次尝试安装执行完上面的前置环境优化步骤再次尝试一键安装指令执行截图如下截图1截图23.1、成功部分解析截图前半段是 Ubuntu 系统通过 apt 安装可选依赖的输出整体全部成功系统自动安装了ripgrep、ffmpeg以及它们依赖的大量系统库音视频编解码、图形渲染、文本处理等底层组件最终明确标记✅ ripgrep installed快速文件搜索工具安装完成✅ ffmpeg installed音视频处理 / 语音播报依赖安装完成安装流程随后进入下一步将 Hermes Agent 源码仓库克隆到本地 ~/.hermes/hermes-agent/ 目录。脚本优先尝试 SSH 协议克隆失败属于正常现象你本地没有配置 GitHub SSH 密钥自动回退到 HTTPS 协议克隆此时出现致命错误。3.2、仓库克隆失败Git 发起 HTTPS 连接时SSL/TLS 加密握手失败底层使用 gnutls 加密库最终无法拉取 GitHub 上的代码仓库整个安装流程在此中断。国内环境的核心原因和上一步出现的 DuckDuckGo 连通性失败是同一类问题GitHub 境外服务器访问受限网络连接被干扰 / 中断导致加密握手无法完成如果你本地有代理但没有给 Git 配置Git 仍然走直连就会触发这个报错极少数情况是系统 CA 证书过期、Git 版本过低导致的兼容问题。3.3、使用 GitHub 镜像手动克隆通过国内镜像站提前把仓库克隆到指定路径脚本检测到仓库已存在会自动跳过克隆步骤。测试也不成功04 再再次安装前面折腾了半天都不行又找了个视频教程跟着操作这次使用的是一个中国大陆镜像curl -fsSL https://res1.hermesagent.org.cn/install.sh | bash指令执行截图截图1截图24.1、核心问题解析Hermes Agent 安装流程的第 2 步Python 运行环境准备安装中断的根本原因是 uv 配置文件格式错误导致 uv 工具无法正常启动进而 Python 3.11 安装失败。1. 已完成的进度✅ 系统检测未找到系统自带的 Python 3.11✅ uv 包管理器安装成功版本 0.11.14安装路径 ~/.local/bin✅ 安装脚本已适配国内镜像下载 uv域名 res1.hermesagent.org.cn2. 报错详情与原因错误核心信息error: Failed to parse: .config/uv/uv.tomlCaused by: TOML parse error at line 1, column 2unknown field pypi含义uv 读取全局配置文件 ~/.config/uv/uv.toml 时解析失败。后果uv 工具启动异常无法继续安装 Python 3.11整个安装流程终止。4.2、修复方案执行以下命令删除错误配置写入符合 uv 规范的清华镜像配置# 删除错误的旧配置文件rm -f ~/.config/uv/uv.toml# 创建配置目录并写入正确的镜像配置index-url 是顶层参数不需要 [pypi] 包裹mkdir -p ~/.config/uvcat ~/.config/uv/uv.toml EOFindex-url ”https://pypi.tuna.tsinghua.edu.cn/simple”EOF# 验证uv是否恢复正常输出版本号即修复成功uv --version结果没有输出版本号报错 uv: command not found接着找原因。。。4.3、问题原因报错 uv: command not found 和刚才修改的配置文件无关核心原因是环境变量 PATH 未生效。从之前的安装日志可以看到uv 被成功安装到了 ~/.local/bin 目录但这个目录没有被加入当前终端的系统路径 PATH 中所以系统找不到 uv 命令。修改配置文件的操作本身是正确的只是 uv 命令本身还没被系统识别到。1. 先确认 uv 文件已安装执行以下命令确认 uv 可执行文件本身存在ls ~/.local/bin/uv如果能正常输出文件路径说明安装包完好只是路径问题。2. 临时生效当前终端立即可用执行安装脚本提示的环境加载命令source ~/.local/bin/env执行后再验证uv --version能正常输出版本号即生效。3. 永久生效重启终端也能用把路径写入 bash 配置文件以后打开终端自动加载echo export PATH”$HOME/.local/bin:$PATH” ~/.bashrcsource ~/.bashrc再次测试可以看到版本号。05 再再再次安装问题解决完再次执行curl -fsSL https://res1.hermesagent.org.cn/install.sh | bash执行截图06 向导配置6.1、模式选择经过多次尝试终于安装成功进入初始化向导配置界面。上下方向键切换选项回车 / 空格确认选择ESC 取消。6.1.1、三个选项详细解析Quick Setup (Nous Portal) — 快速配置官方推荐模式说明通过 Nous 官方门户进行 OAuth 授权登录无需手动填写任何 API Key官方直接提供模型服务和工具能力。适用场景能正常访问境外网络、有 Nous 账号、想快速上手不想折腾配置的用户。国内注意该模式依赖境外的 Nous Portal 服务国内网络大概率无法正常完成登录和调用不推荐国内用户选择。Full setup — 完整自定义配置模式说明全手动配置所有内容包括模型服务商、API 密钥、工具权限、运行参数等所有资源都由你自己提供。适用场景有自己的 API Key如 OpenAI、Anthropic、DeepSeek、通义千问等想自定义使用的模型、控制工具权限的用户。国内建议国内用户优先选择此项可以接入国内可稳定访问的模型服务不受官方门户的网络限制可控性更强。Blank Slate — 空白极简模式模式说明只保留最基础的核心运行能力所有扩展功能、工具默认全部关闭后续按需手动逐个开启。适用场景追求极简、想完全掌控功能开关或者只需要基础对话能力的高级用户。6.1.2、国内环境选择建议这里优先选择Full setup自行接入国内可稳定访问的大模型 API是最稳妥、可控性最高的方案。6.2、终端执行后端选择这是 Hermes Agent 配置向导中的终端执行后端选择步骤用来决定 Agent 执行 Shell 命令、运行代码、操作文件时在什么环境里运行。当前默认选中的是「保持本地模式」上下键切换、回车确认。6.2.1、选项说明选项说明适用场景Local默认直接在当前机器你的 WSL Ubuntu 系统上执行所有命令可直接读写本地文件、调用本地环境入门使用、本地开发调试无需额外配置开箱即用Docker在隔离的 Docker 容器中执行命令环境完全隔离不会污染本地系统可限制资源权限担心 Agent 误操作本地文件、需要安全沙箱的场景需提前安装 DockerModal无服务器云端沙箱在 Modal 的云环境中运行代码本地资源不足、需要强隔离的场景国内网络访问受限SSH通过 SSH 连接到远程服务器执行命令管理远程服务器、在远端机器上执行任务的场景Daytona持久化云端开发环境团队协作、云端开发场景国内使用率极低Singularity/Apptainer高性能计算HPC场景的容器方案集群、超算环境普通用户几乎用不到Keep current (local)保持当前的本地模式配置和第一项效果一致直接沿用默认设置快速完成配置6.2.2、操作建议结合你的 WSL 本地环境和入门阶段直接回车选择Keep current (local)即可本地模式无需额外安装依赖配置完成后立刻就能使用 Agent 的全部能力该设置不是永久固定的后续可随时通过hermes config edit修改为 Docker 等其他模式Modal、Daytona 等云端方案在国内网络环境下连通性差不推荐选择。6.3、消息平台接入这是 Hermes Agent 初始化配置向导中的消息平台接入选择页用于配置 Agent 可对接的外部聊天、协作与通知平台。配置完成后Agent 可以脱离终端在对应平台接收用户指令、执行任务并返回结果。操作方式方向键上下移动光标空格键勾选 / 取消对应平台回车键确认进入下一步ESC 取消配置。当前状态列表中所有平台均为未配置not configured状态可按需选择。6.3.1、平台分类解析国内主流平台平台名称说明Weixin / WeChat个人微信接入原生支持扫码连接可收发文本、图片、文件、语音消息QQ BotQQ 官方机器人接入DingTalk钉钉群机器人适配企业内部协作场景Feishu / Lark飞书机器人支持团队办公自动化流程WeCom (Enterprise WeChat)企业微信官方机器人WeCom Callback (self-built apps)企业微信自建应用回调模式支持深度定制开发Yuanbao腾讯元宝平台接入海外与小众平台包含 Mattermost、Signal、Discord、Slack、Telegram、WhatsApp、Email、Microsoft Teams、Google Chat 等海外协作工具以及 Home Assistant智能家居控制、IRC、Matrix、ntfy 等技术向小众平台。这类平台国内日常使用场景少且多数存在网络访问限制。6.3.2、操作建议入门阶段直接空选回车跳过本地终端交互已经可以完整使用 Hermes Agent 的全部核心能力代码执行、文件操作、工具调用等。此处无需勾选任何平台直接按回车进入下一步即可避免增加不必要的配置复杂度。后续可随时增配所有平台都支持后续按需配置无需在初始化时一次性完成hermes setup gateway执行上述命令可重新进入平台配置向导也可以直接编辑~/.hermes/config.yaml手动添加参数。平台选型参考团队协作场景优先选择飞书、钉钉、企业微信官方开放 API 接入稳定、合规性高个人微信接入依赖第三方协议适配存在账号风控风险稳定性相对一般仅建议尝鲜使用海外平台多数需要配合代理使用国内环境下使用成本较高。6.4、CLI 终端模式工具能力这是 Hermes Agent 初始化配置中的CLI 终端模式工具能力开关页用于选择 Agent 在终端交互时可以调用的能力集合。操作方式方向键移动光标空格键切换勾选状态回车键确认保存ESC 取消配置。当前大部分核心本地能力已默认勾选部分依赖额外 API、专属模型或第三方服务的工具处于未开启状态。6.4.1、已勾选工具核心能力推荐保留这些是 Hermes Agent 的核心功能多数可在本地直接运行无需额外密钥覆盖绝大多数日常 Agent 使用场景工具名称功能说明备注Web Search Scraping网页搜索与页面内容抓取默认使用 DuckDuckGo国内直连不可用后续需配置代理或替换搜索源Browser Automation浏览器自动化支持网页导航、点击、输入、滚动依赖此前安装的 Node.js 环境Terminal Processes终端命令执行与系统进程管理Agent 操作本地系统的核心能力File Operations文件读写、补丁修改、全文搜索支持本地文件全生命周期操作Code Execution多语言代码片段执行配合 Python 环境实现代码运行与调试Text-to-Speech文本转语音播报依赖此前安装的 ffmpegSkills技能包管理支持安装、管理第三方扩展技能插件Task Planning任务规划TODO自动拆解复杂任务分步执行推进Memory持久化记忆跨会话保留上下文实现长期记忆Session Search历史会话检索可搜索过往对话内容Clarifying Questions澄清式提问信息不足时主动向用户追问细节Task Delegation任务委派拆分任务给子 Agent 并行处理Cron Jobs定时任务创建、管理周期性自动化任务Computer Use桌面系统控制后台模拟键鼠操控本地桌面系统6.4.2、未勾选工具扩展能力按需开启这类工具需要额外 API 密钥、专属模型或第三方账号且部分在国内网络环境下可用性有限工具名称功能说明备注Web Search Scraping网页搜索与页面内容抓取默认使用 DuckDuckGo国内直连不可用后续需配置代理或替换搜索源Browser Automation浏览器自动化支持网页导航、点击、输入、滚动依赖此前安装的 Node.js 环境Terminal Processes终端命令执行与系统进程管理Agent 操作本地系统的核心能力File Operations文件读写、补丁修改、全文搜索支持本地文件全生命周期操作Code Execution多语言代码片段执行配合 Python 环境实现代码运行与调试Text-to-Speech文本转语音播报依赖此前安装的 ffmpegSkills技能包管理支持安装、管理第三方扩展技能插件Task Planning任务规划TODO自动拆解复杂任务分步执行推进Memory持久化记忆跨会话保留上下文实现长期记忆Session Search历史会话检索可搜索过往对话内容Clarifying Questions澄清式提问信息不足时主动向用户追问细节Task Delegation任务委派拆分任务给子 Agent 并行处理Cron Jobs定时任务创建、管理周期性自动化任务Computer Use桌面系统控制后台模拟键鼠操控本地桌面系统6.4.3、操作建议入门阶段直接回车确认即可默认勾选的工具已经覆盖了代码执行、文件操作、终端控制、任务规划等 90% 以上的核心场景足够满足本地 Agent 的日常使用需求。扩展工具后续可随时通过配置文件开启。国内环境适配提醒网页搜索功能默认依赖 DuckDuckGo国内直连无法使用完成配置后需给 Hermes 配置代理或替换为国内可用的搜索源。视觉、生图类工具需要对应模型支持你当前使用的商汤日日新需确认是否开放对应能力的 API暂不建议开启。X、Spotify 等海外服务无需开启国内网络环境下无法正常使用。后续调整方式配置完成后可随时执行hermes config edit编辑配置文件开关对应工具无需重新走完整向导。6.5、浏览器自动化后端选型页这是 Hermes Agent 配置向导中的浏览器自动化后端选型页对应你之前勾选的「Browser Automation」工具决定网页浏览、点击、表单填写、页面抓取等自动化操作由哪套浏览器引擎执行。操作方式方向键上下切换回车 / 空格确认ESC 取消。当前默认选中官方推荐的免费本地方案。6.5.1、各选项详细解析选项类型核心说明适用场景Local Browser★推荐・免费本地免费基于无头 Chromium 内核完全在本地运行无需额外 API Key 或付费。数据全部本地处理无额外网络依赖。绝大多数日常场景网页信息抓取、简单自动化操作、表单填写等也是最适配你 WSL 环境的方案Nous Subscription云端付费Nous 官方托管的云端浏览器服务绑定 Portal 订阅计费。国内网络访问受限不推荐选择Camofox免费・本地本地免费基于 Firefox 的反检测浏览器内置反爬、反自动化识别伪装能力。需要绕过网站反爬机制、执行高匿自动化操作的场景Browser Use / Browserbase / Firecrawl云端付费第三方云端浏览器服务支持代理池、指纹伪装、分布式执行均为按量付费模式。规模化爬虫、企业级高匿需求国内网络连通性差普通用户无需考虑Skip跳过保持默认配置暂不详细设置后续再手动调整。暂时用不到浏览器自动化想快速完成配置向导的场景6.5.2、操作建议常规使用直接回车确认 Local Browser这是最稳妥、零成本的选择能满足网页信息提取、简单页面交互等绝大多数需求且完全在本地 WSL 环境运行不存在境外服务的网络问题。安装向导会自动配套下载 Chromium 运行依赖无需手动额外安装。特殊场景可后续切换如果后续需要应对反爬严格的网站再执行hermes config edit手动切换为 Camofox 方案即可配置可随时修改无需重走向导。不推荐云端方案所有带「subscription」「paid」标识的云端浏览器服务在国内网络环境下普遍访问不稳定且需要额外付费普通用户无需考虑。6.6、Chromium 安装失败这是配置向导的非致命错误场景Chromium 浏览器本体下载失败但向导没有中断自动跳过并继续推进后续功能安装。6.7、文本转语音TTS引擎选型这是 Hermes Agent 配置向导的文本转语音TTS引擎选型步骤对应语音播报功能决定 Agent 输出文本时的语音合成服务。当前光标默认停在官方推荐的免费方案 Microsoft Edge TTS 上。6.7.1、选项分类与国内适配性1. 可用的免费方案选项说明适配性Microsoft Edge TTS微软免费在线语音引擎无需 API 密钥支持中文多音色语音质量较好✅ 国内网络基本可正常访问零配置成本是免费方案里的最优选择KittenTTS轻量本地离线 TTS基于 ONNX体积约 25MB完全不用联网✅ 纯离线可用隐私性强但中文音色质量一般Piper本地神经网络 TTS支持 44 种语言音色包 20-90MB✅ 离线可用音质优于 KittenTTS适合无网络场景不推荐的海外付费方案Nous Subscription、OpenAI TTS、xAI TTS、ElevenLabs、Mistral、Google Gemini TTS 均为海外云端付费服务需要对应平台的 API 密钥国内网络访问受限且需要额外付费普通用户无需考虑。跳过选项Skip - keep defaults / configure later暂不配置保持默认后续可手动调整。适合暂时用不到语音功能、想快速走完向导的用户。6.7.2、操作指导想保留语音功能直接按回车确认当前选中的Microsoft Edge TTS即可无需额外配置开箱即用。想快速收尾向导按向下方向键移动到最后一项Skip回车确认跳过。语音播报属于非核心扩展功能完全不影响 Agent 对话、代码执行、文件操作等核心能力。6.8、视觉分析后端选型这是 Hermes Agent 配置向导的视觉分析后端选型步骤对应图像识别、图片内容分析能力决定 Agent 处理图片输入时调用哪套多模态模型服务。当前默认选中官方推荐的「自动适配」模式。6.8.1、各选项解析选项说明适用场景Auto官方推荐自动复用你配置的主对话模型如果主模型支持多模态视觉能力就直接调用不支持则自动走兜底聚合逻辑主模型本身自带视觉能力的场景无需额外配置Pick a provider and model手动指定单独的视觉服务商与模型想单独使用某款特定多模态模型的场景Custom OpenAI-compatible endpoint自定义 OpenAI 兼容格式的视觉接口需手动填写接口地址、密钥、模型名接入国内厂商多模态模型如商汤多模态版、通义千问 VL 等Skip跳过配置暂不启用视觉分析功能暂时用不到图片分析想快速收尾向导6.8.2、操作建议结合当前的配置进度建议直接选择 Skip 跳过原因如下视觉分析属于非核心扩展功能完全不影响 Agent 对话、代码执行、文件操作、任务规划等核心能力。你当前的主模型商汤日日新接口地址尚未修正即便选择 Auto 模式也无法正常调用视觉能力。后续等核心对话功能调通后如果需要图片分析能力可以再通过自定义 OpenAI 兼容接口的方式单独接入商汤的多模态模型配置逻辑和主模型一致。操作按向下方向键移动到 Skip 选项按回车确认即可。6.9、网页搜索服务商选型这是 Hermes Agent 配置向导的网页搜索服务商选型步骤对应联网搜索、网页抓取功能决定 Agent 执行联网信息检索时调用的搜索引擎后端。当前默认选中的 Nous 订阅方案需要境外门户登录国内网络无法正常使用。6.9.1、选项分类与国内适配性海外付费 / 订阅类不推荐国内用户选择包括Nous Subscription、Firecrawl 付费版、Exa、Parallel、Tavily、xAI Web Search等均为海外云端搜索服务需要对应平台 API 密钥或订阅付费国内网络访问受限普通用户无需考虑。免费 / 自托管类国内可用性有限选项说明国内适配情况Brave Search (Free)免费版每月 2000 次查询额度需申请 API Key仅支持搜索海外搜索引擎国内直连稳定性差DuckDuckGo (ddgs)完全免费、无需密钥通过 Python 包调用仅支持搜索国内直连访问不稳定常出现超时Firecrawl Self-Hosted / SearXNG自托管开源方案需自行部署服务有较高技术门槛普通用户不建议尝试跳过选项Skip - keep defaults / configure later暂不配置保持默认状态后续可手动调整。6.9.2、操作指导建议直接选择 Skip 跳过原因如下网页搜索属于扩展功能完全不影响 Agent 核心的对话、代码执行、文件操作、任务规划等能力。列表内所有搜索源均为海外服务国内直连普遍存在网络不稳定、超时的问题即使配置完成也很难正常使用。后续如果需要联网搜索能力可以在配置代理后再手动切换为 DuckDuckGo 等免费方案或自行部署 SearXNG 等自托管搜索服务。07 安装完成Hermes Agent主体程序已全部安装完成配置向导也已执行完毕终端已回到命令行提示符状态。使用的是中国大陆镜像适配版本默认跳过了境外源下载的 Chromium 等组件和之前安装过程中遇到的超时现象一致属于预期内的适配处理。08 API配置前面配置的不太对这里重新配置这里链接日日新当前免费的API命令行配置hermes config set model.provider customhermes config set model.base_url https://token.sensenova.cn/v1hermes config set model.api_key ”$SENSENOVA_API_KEY”# 替换为您的 API Keyhermes config set model.name sensenova-6.7-flash-litehermes config set model.default custom/sensenova-6.7-flash-lite09 你好Hermes最后打开界面发个你好试试。