手把手带你跑通 Hermes CLI零基础也能丝滑配置本文记录在Windows 原生 PowerShell中安装 Hermes Agent 命令行工具CLI术语解释CLICommand-Line Interface命令行界面。就是你在终端里输入命令和 Hermes 交互的方式例如hermes、hermes model、hermes update。并配置DeepSeek 小米 MiMo 双模型的完整流程。适用环境Windows 10/11直接在 PowerShell 中完成不需要 WSL2。如果你的电脑上跑的是 Linux 或 macOS请使用对应的install.sh。先回答三个问题1. 什么是 PowerShellPowerShell 是 Windows 自带的命令行程序可以理解成Windows 里的终端。下面说的所有命令都要粘贴到PowerShell 窗口里执行。❗不要粘贴到浏览器地址栏、文件资源管理器地址栏或运行对话框里。2. 怎么打开 PowerShell按键盘左下角Windows 键输入PowerShell点击Windows PowerShell或PowerShell3. 什么时候需要管理员 PowerShell安装 Hermes普通 PowerShell 就可以不需要管理员权限安装 WSL2才需要以管理员身份运行 PowerShell右键 → 以管理员身份运行前置条件安装器会自动检查并处理以下工具你也可以提前确认工具最低要求验证命令Python≥ 3.11python --versionNode.js≥ 18node --versionGit任意版本git --versionripgrep推荐rg --versionffmpeg推荐ffmpeg -version 安装器会优先复用系统已有的 Python 和 Node.js不会重复安装。安装 Hermes CLI一键安装在 PowerShell 中执行以下命令irmhttps://res1.hermesagent.org.cn/install.ps1|iex粘贴小提示现在多数 Windows 终端都支持CtrlV如果不行也可以直接在窗口里右键粘贴irmInvoke-RestMethod下载网页iexInvoke-Expression执行脚本。这条命令从Hermes Agent 中文社区维护的国内镜像服务器下载安装器并直接执行国内可直连比访问 GitHub 快很多。安装器会自动完成以下工作步骤操作预期耗时说明1检查 uv 包管理器即时用于加速 Python 包安装2检查 Python 环境即时优先复用系统已有的 ≥ 3.113检查基础工具即时Node.js、ripgrep、ffmpeg4克隆代码仓库约 1-2 分钟从 CNB.cool 镜像下载~130MB国内直连5创建 Python 虚拟环境约 30 秒隔离 Hermes 的 Python 依赖6安装核心依赖约 1-3 分钟通过清华 PyPI 镜像安装7配置命令与目录即时加入 PATH创建.env、config.yaml8同步内置技能即时自动同步 72 个内置技能⚠️ 为提高 Windows 直装速度安装器默认跳过了浏览器自动化等体积较大的可选组件受外网下载影响。Hermes 核心功能不受影响后续可按需补装。安装后操作安装完成后关闭当前 PowerShell 窗口重新打开一个让 PATH 生效然后运行hermes--version看到类似以下输出即表示安装成功Hermes Agent v0.17.0 (2026.6.19) · upstream 44ddc552 如果hermes命令找不到最常见的解决方法就是——关掉当前 PowerShell 窗口再开一个新的。安装后文件在哪里%LOCALAPPDATA%\hermes\ # 即 C:\Users\用户名\AppData\Local\hermes\ ├── hermes-agent\ # Hermes 源码仓库 │ └── venv\Scripts\hermes.exe # Hermes CLI 入口 ├── config.yaml # 主要配置文件模型、终端后端等 ├── .env # API 密钥等敏感信息不要分享 ├── SOUL.md # Agent 人格设定可自行编辑 ├── skills\ # 技能目录 ├── sessions\ # 会话历史 ├── memories\ # 持久记忆 ├── cron\ # 定时任务 └── logs\ # 运行日志关于各文件的详细说明可参考 官方文档 → 配置。配置模型提供商Hermes术语解释Hermes Agent开源 AI 智能体框架与产品的正式名称。Hermes Agent 是项目和产品的正式名称。文档、GitHub 仓库、安装命令、社区讨论和搜索结果都统一使用这一写法。 需要至少一个大模型提供商术语解释Provider模型或服务的提供方。LLM Provider 指提供模型 API 的服务商如 DeepSeek、OpenAI、OpenRouter 等。才能工作。这里我们配置DeepSeek作为默认模型同时配置小米 MiMo作为第二个可手动切换的模型。配置 DeepSeek默认模型DeepSeek是国内的大模型提供商注册简单、价格便宜、国内直连不需要翻墙。Hermes 完全兼容 DeepSeek 的 API。在 PowerShell 中依次执行hermes configsetmodel.provider custom hermes configsetmodel.base_url https://api.deepseek.com/v1 hermes configsetmodel.default deepseek-chat hermes configsetmodel.api_key sk-你的DeepSeek密钥各字段说明配置项值说明model.providercustom使用自定义 OpenAI 兼容端点术语解释OpenAI-compatible指 API 格式与 OpenAI 的 Chat Completions API 兼容的服务。model.base_urlhttps://api.deepseek.com/v1DeepSeek 的 API 地址model.defaultdeepseek-chat默认模型名指向 DeepSeek 最新版model.api_keysk-...从 platform.deepseek.com → API Keys 获取❗敏感信息提醒model.api_key的值会自动保存到.env文件不会出现在config.yaml中.env文件默认不会被分享或提交到版本控制。配置小米 MiMo第二个可切换模型小米 MiMoXiaomi MiMo是小米推出的模型服务平台提供mimo-v2.5-pro等模型支持文本生成、深度思考、函数调用和联网搜索。Hermes 已内置对 MiMo 的支持provider 名称为xiaomi。hermes configsetXIAOMI_API_KEY sk-你的MiMo密钥 hermes configsetXIAOMI_BASE_URL https://api.xiaomimimo.com/v1然后编辑%LOCALAPPDATA%\hermes\config.yaml在末尾添加模型别名方便在/model菜单中快速切换# 模型别名 —— 通过 /model 命令或别名名快速切换model_aliases:deepseek:model:deepseek-chatprovider:custombase_url:https://api.deepseek.com/v1mimo:model:mimo-v2.5-proprovider:xiaomibase_url:https://api.xiaomimimo.com/v1 前往 platform.xiaomimimo.com → API Keys 创建密钥。MiMo 支持按量付费sk-开头和 Token Plan 订阅tp-开头两种方式。验证配置运行诊断命令检查两个 provider 是否正常hermes doctor在输出的 API Connectivity 部分关注以下信息◆ API Connectivity ✓ DeepSeek # DeepSeek 连通成功 ✓ xiaomi (key configured) # MiMo 密钥已配置绿色 ✓ 正常黄色 ⚠ 可选组件缺失不影响核心功能。如果两个都显示正常说明模型配置已全部完成。双模型切换方法配置完成后你可以随时在 DeepSeek 和 MiMo 之间切换方式一交互式菜单推荐hermes model在列表中选择需要的提供商和模型即可。方式二切换默认配置hermes configsetmodel.provider xiaomi# 切换到 MiMomimo-v2.5-prohermes configsetmodel.provider custom# 切换回 DeepSeekdeepseek-chat方式三单次临时指定不改变默认配置hermes chat--provider xiaomi--model mimo-v2.5-pro hermes chat--provider custom--model deepseek-chat使用交互式配置向导备选如果你更习惯问答式配置也可以运行hermes setup选择Full setup→ 提供商列表中选择16. DeepSeek→ 按提示输入 API Key 和选择模型。配置文件的优先级设置按以下顺序解析高优先级覆盖低优先级CLI 参数— 如hermes chat --model xxxx每次调用的覆盖config.yaml— 主要配置文件模型、终端后端等非敏感设置.env— 环境变量文件API 密钥等敏感信息内置默认值— 硬编码的安全默认值原则API 密钥放.env其他配置放config.yaml。hermes config set命令会自动将值路由到正确的文件。快速参考完整安装命令# 1. 安装 Hermes CLIirmhttps://res1.hermesagent.org.cn/install.ps1|iex# 2. 关闭并重新打开 PowerShell# 3. 验证安装hermes--version# 4. 配置 DeepSeekhermes configsetmodel.provider custom hermes configsetmodel.base_url https://api.deepseek.com/v1 hermes configsetmodel.default deepseek-chat hermes configsetmodel.api_key sk-你的DeepSeek密钥# 5. 配置小米 MiMohermes configsetXIAOMI_API_KEY sk-你的MiMo密钥 hermes configsetXIAOMI_BASE_URL https://api.xiaomimimo.com/v1# 6. 验证配置hermes doctor# 7. 开始使用hermes# CLI 聊天hermes--tui# 现代 TUI 模式常见问题排查问题解决方案PowerShell 提示禁止运行脚本使用irm ... | iex模式无需修改执行策略hermes不是内部或外部命令关闭并重新打开 PowerShell安装卡住或超时重试安装器支持断点续传配置文件解析错误用 UTF-8 无 BOM 格式保存config.yamlConfig version outdated运行hermes doctor --fixOpenRouter API (not configured)正常现象因为用的是 DeepSeek 而非 OpenRouterQ1: PowerShell 提示无法加载文件因为在此系统上禁止运行脚本原因Windows 默认执行策略为Restricted。解决使用irm ... | iex模式下载后通过管道传给Invoke-Expression可以正常运行无需修改执行策略。如果运行的是.ps1文件可以临时绕过powershell-ExecutionPolicy Bypass-File 安装脚本.ps1Q2:hermes不是内部或外部命令原因安装器修改了用户 PATH但需要重新打开终端才能生效。解决关掉当前 PowerShell 窗口再开一个新的。如果重启后仍然找不到# 永久添加到用户 PATH$userPath[Environment]::GetEnvironmentVariable(Path,User)$hermesPath$env:LOCALAPPDATA\hermes\hermes-agent\venv\Scriptsif($userPath-notlike*$hermesPath*){[Environment]::SetEnvironmentVariable(Path,$userPath;$hermesPath,User)}Q3: 配置文件解析错误utf-8 codec cant decode byte原因config.yaml文件编码不是 UTF-8可能是 GBK 或混合编码导致解析失败。Hermes 会自动创建备份文件.yaml.corrupt.xxx.bak。解决用正确的编码重新保存$configPath$env:LOCALAPPDATA\hermes\config.yaml$contentGet-Content$configPath-Raw[System.IO.File]::WriteAllText($configPath,$content,[System.Text.UTF8Encoding]::new($false))Q4: Config version outdated原因安装后首次运行时配置模板版本v0低于当前 Hermes 版本所需的版本如 v32。解决hermes doctor--fixQ5:hermes doctor显示OpenRouter API (not configured)原因DeepSeek 使用custom provider直接调用不走 OpenRouter 中转。解决无需处理。只要输出中有✓ DeepSeek即表示模型配置正常。让你的 Agent 自动完成配置如果你电脑上已经有其他 Agent术语解释Agent具备自主性、能调用工具以完成目标的 AI 程序。Agent 是一种基于大语言模型的智能程序能够感知环境、做出决策、调用工具执行操作并自主推进任务。 了如 Claude Code、Trae、Cursor、Qoder 等可以让它按照本文档的步骤自动帮你完成安装和配置。方式一最简单把本文档的文件路径或链接发给你的 Agent让它自己阅读并执行。方式二更精准推荐直接把下面这段话复制给你的 Agent请根据这篇 Hermes CLI 安装指南帮我完成安装和配置 文档路径D:\Hermes CLI Windows 安装与模型配置指南.md 需要完成的内容 1. 安装 Hermes CLI使用 irm ... | iex 社区镜像 2. 配置 DeepSeek 为默认模型providercustombase_urlhttps://api.deepseek.com/v1 3. 配置小米 MiMo 作为第二个可切换模型providerxiaomibase_urlhttps://api.xiaomimimo.com/v1 4. 用 hermes doctor 验证配置 5. 启动 hermes 测试聊天 API Key 我会在需要时提供或你按文档中的占位符提示我填入。 如果你的 Agent 支持 MCP术语解释MCPModel Context ProtocolAnthropic 提出的开放标准用于将 AI 应用连接到外部数据源与工具。也可以先接入 Hermes 中文文档 MCP Serverhttps://mcp.hermesagent.org.cn/v1让 Agent 直接检索最新文档来指导安装。参考与延伸阅读如果你对 AI Agent 的搭建和配置感兴趣欢迎关注我的 CSDN 专栏更多实战经验持续更新中文章简介从小白到大神MiMo Code 配置与使用零基础通关秘籍小米 MiMo Code 终端 AI 编程助手的完整安装、配置、使用教程含 Web 图形界面VS Code 安装 Claude Code 并接入 DeepSeek V4 Model在 VS Code 中配置 Claude Code 并接入 DeepSeek V4 模型的完整流程使用 Reasonix 接入 DeepSeek从零搭建你的 AI 编程助手基于 Reasonix 框架从零搭建 AI 编程助手的实战教程