从零开始，在Windows上部署属于自己的智能助理 你是否也曾想过拥有一个随时待命、完全听从指挥的AI助手？它不仅能聊天，还能帮你上网搜索、读写文件、执行代码，甚至控制你的电脑？ 最近，我在Windows系统上成功部署了Hermes Agent——一个功能强大的开源AI助手框架。整个过程虽然遇到了一些小波折，但最终顺利搞定。 今天就把这份完整的安装配置过程记录下来，分享给同样感兴趣的伙伴们。 为什么选择Hermes？ Hermes Agent是一个开源的AI代理框架，它最大的亮点是可以接入多种大模型（如DeepSeek、OpenAI等），并配备了丰富的工具集：浏览器自动化、文件操作、代码执行、网页搜索、图像分析……几乎涵盖了日常工作和生活中能用到的各种功能。 安装前的准备 一个大模型API密钥（本文以DeepSeek为例） 第一步：一键安装Hermes 在Windows上安装Hermes非常简单。打开PowerShell（以管理员身份运行更好），输入以下命令： irm https://res1.hermesagent.org.cn/install.ps1 | iex 安装脚本运行后，会询问你是选择“快速安装”还是“全部安装”。 这里我选择了 2-Full Setup（完全安装），这样可以获得最完整的功能体验。 第二步：配置模型提供商 Hermes支持多种大模型。我选择了DeepSeek，当然你也可以根据自己的偏好选择其他模型。 接下来需要选择具体的模型版本。DeepSeek提供了多个版本： deepseek-v4-flash：性价比高，速度更快，适合日常使用 deepseek-v4-pro：性能更强，适合处理复杂任务 对于个人用户来说，deepseek-v4-flash已经足够。 第三步：关于API密钥的设置 Hermes会检测到你当前只有一个API密钥，并询问是否需要添加备用密钥。 回退（Fallback）：当主密钥遇到速率限制或配额耗尽时，自动切换备用密钥 轮换（Rotation）：在多个密钥间轮流使用，分散请求压力 如果你只是个人用户，日常调用量不大，直接选 N（不需要） 即可。 第四步：配置各项功能 TTS语音合成 Hermes默认使用微软的Edge TTS，这是一个完全免费的云端语音服务，音质不错且无需任何配置。直接回车确认即可。 推荐保留。微软的云服务，免费、音质不错、无需任何设置，开箱即用。 2~7 (ElevenLabs, OpenAI, xAI, MiniMax, Mistral, Google) 音质通常更好（尤其是 ElevenLabs），支持多语言、音色克隆等，但需要去对应官网注册并获取 API Key，且通常需要付费。 完全免费，数据不出电脑，保护隐私。但需要下载模型文件（几百 MB 到几十 MB 不等），音质和响应速度可能不如云端。
执行环境 选择 Local（本地） 模式——直接在你自己电脑上运行，简单直接。其他选项如Docker、SSH等需要额外配置，对于刚入门的用户来说不太友好。 个人使用最推荐。简单直接，无需额外配置，适合日常任务。 在一个隔离的 Docker 容器里执行，可限制资源。 需要云端算力，或本地资源不足。需要 Modal 账号。 在 Daytona 云开发环境中执行，有持久化存储。 在 Vercel 的云微虚拟机中执行，有快照持久化。
直接选择默认的 7. Keep current (local) 即可。 你是个人用户，直接在本地电脑上运行是最方便、最直接的方式，不需要注册任何云服务账号。 安全风险可控：Hermes 在执行命令前通常会请求确认，只要你不随意批准危险操作，Local 模式完全够用。 省去折腾：其他选项（Docker、SSH等）都需要额外配置，对于刚开始使用来说过于复杂。 最大工具迭代次数 这个参数决定了AI为了解决你的问题，最多可以进行多少轮“思考-行动”循环。 简单来说，这个数字决定了 AI 为了解决你的问题，最多可以“思考-行动-再思考”多少轮。 🤔 用个例子帮你理解 假设你让 AI 帮你“查一下北京今天的天气，然后根据天气推荐一件外套”。 第 1 次迭代：AI 思考后，调用“天气查询工具”获取天气数据（比如“晴天，25度”）。 第 2 次迭代：AI 拿到数据后，再次思考，调用“商品推荐工具”搜索“薄外套”。 第 3 次迭代：AI 拿到商品列表，最后整理成一段文字回复你。 在这个例子里，就用了 3 次迭代。如果任务更复杂（比如“帮我分析这份财报，画个趋势图，再写份总结”），迭代次数就会更多。 ⚙️ 不同数值的作用 AI 能“思考-行动”的轮数很少，复杂任务会中途停止。 AI 有更多轮次去探索、试错和完成长链路任务，但会消耗更多 Token（费用更高）。
💎 我的建议 对于绝大多数日常对话和工具调用任务，60 次迭代完全够用。 如果未来你真的遇到了 AI 因迭代次数不够而中途停止的情况（它会提示你），到时候再来这里调高也不迟。 工具进度显示 我选择了 all 模式——显示每个工具调用的名称和简短预览。这样既能清楚看到AI的工作流程，又不会信息过载。 它提供了四个级别，从“完全安静”到“细节拉满”。我把它们整理成了表格，方便你对比： 完全静默，只显示 AI 的最终回复，不显示任何工具调用过程。 追求界面极度简洁，或者不想被中间过程干扰，只关心最终答案。 简洁模式，只显示工具名称，且只有切换新工具时才提示。信息量少，比较清爽。 想大概知道 AI 在做什么，但又不想看到太多细节。 推荐选项，显示每个工具调用的名称和简短预览（比如搜索关键词的前几个字）。 个人日常使用的最佳平衡：既能清楚看到 AI 的工作流程，又不会信息过载。 调试模式，显示工具调用的完整参数、返回结果和调试日志。信息最全，但也最杂乱。 开发者调试、排查问题，或对 AI 的执行过程有极强的好奇心。普通用户一般用不上。
上下文压缩与会话重置 上下文压缩：当对话太长时，自动将早期对话总结成摘要，节省Token消耗。推荐保持默认值 0.5。 你输入的值（0.5 ~ 0.95）代表 “压缩触发点”，它决定了对话进行到什么程度时开始压缩。 数值越高（如 0.9）：Hermes 会延迟压缩，尽量保留更长的原始对话历史。这会消耗更多 Token（费用高），但 AI 能回忆起的细节更丰富。 数值越低（如 0.5）：Hermes 会较早压缩，更早地将早期对话总结成摘要。这会节省 Token（更省钱），但 AI 可能会丢失一些早期细节。 简单打个比方：阈值就像你整理笔记的“耐心” —— 低阈值 = 你很快就懒得看旧笔记，直接概括；高阈值 = 你愿意多看几页再概括。 会话重置策略：我选择了 “不活跃+每日重置” 组合模式 这套组合拳能有效控制Token成本，避免因过长对话导致的费用飙升。 ⚙️ 五个选项的含义 1. Inactivity + daily reset（推荐，默认高亮） 双重触发：当用户超过设定时间（如 30 分钟）没说话时重置；或者每天固定时间（如凌晨 3 点）重置。哪个先到就执行哪个。 强烈推荐个人用户选择。 平衡了便利性和成本控制，既不会让闲置会话浪费钱，也不会在活跃对话中途突然打断。 永不自动重置，只能手动输入 /reset 命令来清空。 如果你希望尽量保留完整对话历史（需注意费用和上下文超限风险）。 如果你之前配置过，这次不想改动。初次配置通常不选这个。
询问 “不活动超时时间”（Inactivity timeout） 当用户连续多少分钟没有发送新消息后，Hermes 会自动重置当前的对话会话。 如果对话闲置超过了设定的时间，Hermes 就会清空当前对话历史（但会先保存重要信息到长期记忆），下次你再发消息时，AI 不再记得之前的聊天内容，相当于开启了一个全新的对话。 这个机制是为了节省 Token 消耗，因为保留闲置对话的历史没有任何意义，只会白白浪费 API 费用。 ⏱️ 默认值 1440 分钟是什么概念？ 也就是说，如果你和 Hermes 聊完天后超过 1 整天 没有发新消息，会话就会自动重置。这是官方推荐的一个平衡值 —— 既不会在你离开几小时后就打断对话，也不会让几周前的旧话一直占用上下文，增加成本。 💎 我应该怎么填？ 直接按回车（Enter），接受默认值 1440 即可。 如果你希望会话保留更久（比如经常隔几天才用一次），可以填入更大的数值，比如 4320（3天）或 10080（7天）。 如果你希望会话更早自动清理（更省 Token），可以填入较小的值，比如 60（1小时）或 144（2.4小时）。 但对于初次配置，保持默认是最省心也最稳妥的选择，先这样用起来，之后根据实际体验再调整也不迟。 设置 每日重置的具体时间点（Daily reset hour） ⏰ 具体含义 作用：如果你和 Hermes 的对话一直持续到凌晨 4 点还没有因“不活跃超时”被重置，那么到了 4 点整，系统就会主动清空对话历史（先保存重要记忆到长期存储），开始新的一天。 在这个时段重置会话，对用户的影响最小，不会打断白天的工作或聊天。 同时也确保每天至少重置一次，避免对话无限累积 Token 成本。 💎 我应该怎么填？ 除非你有特殊的习惯（比如你是个夜猫子，经常凌晨 5 点还在用 AI，不希望被打断），否则完全没必要修改这个时间。凌晨 4 点重置是一个安全且合理的默认值。 消息平台接入 Hermes支持接入微信、Telegram、Discord等21种聊天软件。不过这些配置需要分别去对应平台注册Bot、获取Token，步骤较为繁琐。 目前你在终端里和 Hermes 对话，但如果配置了这些平台，你就可以： 在手机或电脑的聊天软件里，像和朋友聊天一样和 AI 互动。 列表中列出了 21 个平台，包括 Telegram、Discord、Slack、WhatsApp、微信、钉钉、飞书、QQ 机器人、LINE 等。 工具集配置 Hermes默认开启了最核心的工具：网页搜索、文件操作、代码执行、浏览器自动化等，覆盖了90%的日常需求。直接保持默认即可。 🧰 这些工具是什么？ 你可以把 Hermes 想象成一个“万能工具箱”，列表里的每一项就是一个工具。对话时，AI 会根据你的指令，自主决定是否调用某个工具。比如你问“今天北京天气怎么样”，它就会自动调用“Web Search”工具去搜索。 列表前面带 [32m@]（绿色高亮）表示默认开启，带 [ ] 表示默认关闭。 🛠️ 工具分类速览 10. X(Twitter)搜索 22. Spotify 音乐控制 21. Home Assistant 智能家居 3. 终端与进程 4. 文件操作（读写、搜索） 5. 代码执行 6. 图像分析（视觉） 8. 图像生成 12. 文本转语音(TTS) 13. 技能管理 14. 任务规划(todo) 15. 跨会话记忆 16. 历史会话搜索 17. 追问澄清 18. 任务委派 20. 跨平台消息发送 19. 定时任务(Cron) 24. 电脑控制(macOS)
各工具的提供商选择 对于浏览器自动化：选择 Local Browser（本地浏览器），完全免费，无需API Key。 1. Local Browser（默认，绿色高亮） 使用本机安装的 Chromium（开源 Chrome），完全免费，无需任何 API Key。官方标注为“推荐”。 基于 Firefox 的防检测浏览器，适合需要绕过网站反爬虫的场景。
对于图像生成：目前选项都是付费服务，选择 Skip（跳过），以后有需要再配。 列表中的 1-4 都是付费的云端图像生成服务，只有第 5 项是“跳过”： 支持多种主流模型（如 Flux 系列），选项丰富。 使用 OpenAI 的 gpt-image-2 模型。 需要登录 ChatGPT/Codex 账号授权，利用的是 ChatGPT 会员免费额度。 使用 xAI 的 grok-imagine 模型，需要 xAI 的 API Key。
对于文本转语音：保持默认的 Microsoft Edge TTS，免费又好用。 列表中列出了 8 个选项，核心区别在于 “免费 vs 付费” 和 “云端 vs 本地”： 1. Microsoft Edge TTS（默认，绿色高亮） 音质不错，无需任何 API Key，开箱即用，官方标注“推荐”。 音质最自然、最逼真，业内标杆，需 API Key。 30 种预设声音，可通过提示词控制，需 API Key。 轻量级 ONNX 模型（约 25MB），无需网络。 本地神经网络 TTS，支持 44 种语言（模型文件 20-90MB）。
对于网页搜索：Hermes已内置 DuckDuckGo免费搜索，直接 Skip 跳过高级配置。 需要自己在 Docker 中搭建 Firecrawl 实例，技术门槛高。 每月 2000 次免费查询，需要去 Brave 官网申请 API Key。 通过 Python 包直接搜索，不限次数。最适合个人用户。 跳过配置，使用默认（即内置的 DuckDuckGo）。
第五步：安装完成！ 看到“Setup Complete！”的提示，就意味着Hermes已经成功安装。 Hermes 已经成功安装了以下核心功能（虽然部分需要额外配置）： ❌ 缺少 API Key（已内置 DuckDuckGo 作为替代）
📁 关键文件位置 C:\Users\Administrator\AppData\Local\hermes\config.yaml C:\Users\Administrator\AppData\Local\hermes\.env C:\Users\Administrator\AppData\Local\hermes\cron\, sessions\, logs\
⚠️ 重要提示 需要重启终端：让 PATH 环境变量生效，否则 hermes 命令可能无法识别。 建议安装 ripgrep：如果希望文件搜索更快，可以用命令安装：winget install BurntSushi.ripgrep.MSVC（非必须）。 启用Hermes 你在配置过程中已经设置好了 DeepSeek API（deepseek-v4-flash 模型）,记得重启终端后，直接输入 hermes 就可以开始对话了！ 常见问题：API密钥失效怎么办？ 如果你在DeepSeek平台重新生成或删除了API Key，Hermes会报错（HTTP 400或402错误）。 因为你在控制台看不到旧 Key，最稳妥的做法是 重新生成一个 Key，然后更新到 Hermes 的配置文件中。 生成新 Key：登录，进入 API Keys 页面，点击“创建 API Key”，命名后 立即复制 保存。 修改 .env 后，需要让 Hermes 重新读取环境变量。你可以： 或者在 Hermes 的 TUI 界面输入 /reset（重置会话）后，再发送新消息。 Hermes 的会话重置确认提示 /reset 会彻底清空当前对话的所有历史记录（上下文），让 AI 忘记之前聊过的所有内容，相当于开启一个全新对话。这样做有助于： 消除因之前 API 调用失败可能残留的异常状态（比如你刚才遇到的 400 错误）。 释放累积的上下文 Token，避免后续消息继续计费。 ⚙️ 三个选项的含义 这次批准，仅此一次。以后你再用 /reset 时，这个提示还会再次出现。 永久批准。以后你用 /reset 时，不会再出现确认提示，直接执行。慎用！
我的使用感受 整个安装过程虽然步骤不少，但每一步都有清晰的指引，对新手比较友好。从下载安装到配置完成，大约需要15-20分钟。 实际使用下来，Hermes的响应速度很快，工具调用也很流畅。最惊喜的是它的文件读写和代码执行能力——真的可以实现“让AI帮我处理本地文件”的愿景。 需要注意的是，通过DeepSeek API调用会产生费用（虽然有新用户免费额度），建议在DeepSeek控制台设置好预算提醒。 你有用过类似的AI助手工具吗？欢迎在评论区分享你的经验和心得！
💡 小贴士：使用过程中如果遇到问题，可以在终端输入 hermes doctor 进行诊断排查。
夜雨聆风
