1. Hermes 安装那几级台阶先确认走完了1.1 管理员 PowerShell 跑安装脚本原文的第一步是复制安装命令打开 PowerShell 粘贴运行。命令本身不难难在「管理员权限」经常被忽略。普通窗口执行irm https://res1.hermesagent.org.cn/install.ps1 | iex时如果中途需要写入系统目录或修改环境变量会因为权限不足而静默失败屏幕上不出现任何红色报错。所以打开 PowerShell 时先在开始菜单搜 PowerShell右键选择「以管理员身份运行」再执行irm https://res1.hermesagent.org.cn/install.ps1 | iex如果 PowerShell 提示「禁止运行脚本」多半是当前执行策略限制了可以顺手执行一句Set-ExecutionPolicy RemoteSigned -Scope CurrentUser按 Y 确认后再跑安装命令。装完之后别急着关窗口重新打开一个新终端输入hermes --version。能显示版本号说明 Hermes 程序本体已经就位显示找不到命令说明刚才安装过程有环节没走完先补齐这一步再往后面配置。1.2 Hermes One 与 D 盘迁移后面两步是安装可视化界面 Hermes One再把 Hermes 迁移到 D 盘。Hermes One 相当于图形操作台装好之后不需要每次都用命令行。迁移 D 盘这件事文件复制只是表面动作真正的关键是环境变量。如果你只是把整个 Hermes 目录从 C 盘拖到 D 盘没有修改环境变量系统下次打开 Hermes 时还是在找 C 盘的旧路径找不到就闪退或者报错。修改完环境变量后必须重新打开终端或重启一次相关进程让新的 PATH 值被真正加载。可以用where.exe hermes看一眼输出路径确认是否已经是 D 盘的位置确认没问题再进入模型 API 配置环节避免后面把「路径不对」误判成「模型地址不对」。1.3 安装完成不等于能对话这里要说的是最容易被误会的一点安装完成只是把 Hermes 这个外壳装好了它里面并没有自带模型。打个比方Hermes 像是一个已经安装好的浏览器模型 API 地址就是地址栏里的网址不输入网址浏览器不可能凭空打开页面。Hermes One 打开后如果一直提示未配置模型或连接失败不是安装出问题了而是模型 API 还缺三项参数Base URL、API Key、模型 ID。TaoToken 可以把这三项统一管理起来你在官网拿一把 KeyBase URL 固定填https://taotoken.net/api模型 ID 按需换。下载好的 Agent 能不能跑起来真正起决定性作用的就是这一节。2. 先拿 Key再把 Hermes 模型 API 地址指到 TaoToken2.1 注册、登录、创建 Key配置前准备工作不多打开 TaoToken注册并登录进入控制台的 API Keys 页面新建一把 Key。创建后马上复制出来存到本地一个临时文本里。注意很多平台为了安全Key 只在创建那一刻完整显示一次关掉页面再回来只能重新创建。复制时不要选中多余空格也不要手动补字符粘贴到 Hermes 前先在记事本里看一遍末尾字符有没有丢。2.2 在 Hermes One 里打开模型 API 设置回到 Hermes One 的设置面板找到模型 API 或语言模型设置。不同版本入口叫法不太一样有的在「设置 模型」有的在「AI 服务」下面但字段基本一致Base URL、API Key、模型 ID。如果界面上默认填了官方地址先清空再按下一节表格替换。有些版本还带「自定义」开关手动填写时需要先打开这个开关否则输入框是灰的。保存前再扫一眼三个字段不要填反。2.3 参数对照与 /v1 提醒配置项填写内容Base URLhttps://taotoken.net/apiAPI KeyYOUR_API_KEYModel ID以 模型广场 当前列表为准这里最容易出错的是 Base URL 末尾的/v1。许多模型服务商的地址长这样于是到了 TaoToken 这里也习惯性补上/v1结果 Hermes 请求时拼出一个不存在的路径返回 404。TaoToken 的 Base URL 就是https://taotoken.net/api后面什么都不加。API Key 必须是刚才在官网创建的YOUR_API_KEY模型 ID 去模型广场复制不要凭记忆手打。如果模型广场上同一个模型有好几个版本显示挑名字跟你任务匹配的那一个复制拿不准就选列表里标记为 Stable 或推荐的那个。2.4 先到网页端验证 Key 是否有效在 2.1 创建完 Key 之后如果你担心后面排障把问题搞混可以先在 TaoToken 模型对话 里手动选择同一个模型用这把 Key 发一条消息。这一步能确认 Key 本身能用、模型 ID 没有写错。网页端通过后再回 Hermes 填写后面再遇到问题排障范围就只有 Hermes 这一侧了。3. 验证让下载好的 Agent 正常跑起来3.1 先发一句最简单的对话配置保存后回到 Hermes One先不要着急丢长文档或复杂任务。第一步发一句「你好请用一句话介绍你自己」。这句话返回速度快也足够检验链路。返回正常文本说明 Base URL、Key、模型 ID 三样全部对上下载好的 Hermes Agent 已经能正常跑。返回报错也不要慌按第四章顺序逐项查即可。先跑通最简对话再去切模型、加技能或让它写代码排查成本会低很多。3.2 让它做一个真实的小任务简单对话通过后可以再试一个真实一点的任务比如让 Hermes 写一段 Python 脚本读取当前目录所有文件并按修改时间排序打印。注意这里 Hermes 只是生成代码具体执行由你在本机跑跑完把结果贴回对话。这样既能验证模型 API 的稳定性也能确认 Agent 的回复没有被截断或超时。真正用起来时Agent 负责生成和解释执行操作仍由人工确认这个边界在配置阶段养成习惯最好。3.3 回控制台对一下调用记录对话成功后打开 TaoToken 控制台的用量页面刷新一下你应该能看到刚才那两轮对话的记录。这一步是确认 Hermes 的请求确实进了 TaoToken 通道而不是走了旧配置或者本地缓存。能查到记录说明「模型 API 地址改到 TaoToken」这件事真正闭环后面写代码、总结资料、处理长文都会稳定走同一条通道查不到记录多半是填写项里有非打印字符回头重新粘贴一次 Key。4. 配置后最常碰到的三个报错4.1 401 或 Unauthorized401 说明请求已经到达服务端但认证没通过。最常见的场景是 Key 在复制时漏了末尾几个字符或者把旧 Key 当成新 Key 填了进去。处理方式是回到官网控制台的 API Keys 页面重新创建一把 Key完整复制后覆盖粘贴到 Hermes粘贴后不要在 Key 前后加任何内容。如果用了多个平台的 Key注意别把其他服务商的密钥填进 Hermes格式虽然相似但 Hermes 请求时认证对象不对同样会 401。4.2 404 或 model not found404 和 model not found 基本指向两个原因路径多了后缀或者模型 ID 不存在。路径方面检查 Base URL 是不是写成了https://taotoken.net/api/v1把/v1删掉就能恢复模型 ID 方面不要自己猜测名称以官网模型广场列出的为准。有些模型在更新后会换 ID原来复制过的一次性文本要重新去广场复制旧 ID 可能已经下线。4.3 网络超时或连接失败如果换成 TaoToken 之前一切正常换成之后超时先不要急着怀疑 Key。在 PowerShell 里执行Test-NetConnection taotoken.net -Port 443看 TCP 443 是否连通。通则再把 Hermes One 完整退出重启很多时候连接失败是进程缓存了最早填的官方地址重启后才重新读取配置。还有一种情况是系统代理或防火墙拦掉了非默认端口的请求可以在 TaoToken 网页端先测试同模型的对话网页端正常就说明网络链路没问题问题仍在本机进程。提示排障时先固定变量。网页端模型对话用同一把 Key 发一条消息网页端正常就回 Hermes 排查网页端也报错就去检查 Key 是否有效。5. 迁移 D 盘与环境变量的收尾5.1 确认 PATH 指向新位置如果你按原文把 Hermes 迁移到了 D 盘修改环境变量后配置模型 API 前最好先确认 PATH 的新值已经生效。重新打开 PowerShell执行where.exe hermes。如果返回的路径还在 C 盘说明环境变量只是保存了没有在当前会话里重新加载关闭终端重开或者注销一次用户会话再看结果。这一步不做你可能在保存模型配置后准备对话时遇到闪退那个时刻很难判断是 API 问题还是路径问题。5.2 检查 Hermes One 版本与配置入口环境变量正常后顺手确认 Hermes One 的版本号。部分旧版本的可视化界面里模型 API 设置的入口名称不一样有的还藏在「高级设置」下面。如果按 2.2 找不到入口去官网查一下当前版本的接入文档或者看设置里有没有「API 兼容模式」这类开关。版本太旧的话先升级 Hermes One 再回来填参数否则界面字段对不上容易出现填了下拉框但没保存上的假象。5.3 把配置参数留个底模型 API 调通后把 Base URL、Key、模型 ID 记到本地文件里。以后升级 Hermes One、重置配置或换电脑照着填回去就能恢复。Key 从 TaoToken 创建不要发给别人用量记录在官网控制台随时可查。如果使用频率高也可以提前打开 Coding Plan 看看更适合的套餐Key 的管理和暂停统一在 控制台 API Keys 页面。到这里Hermes 的模型 API 地址已经完整指到 TaoToken下载好的 Agent 可以直接开始干活。
1. Hermes 安装那几级台阶先确认走完了1.1 管理员 PowerShell 跑安装脚本原文的第一步是复制安装命令打开 PowerShell 粘贴运行。命令本身不难难在「管理员权限」经常被忽略。普通窗口执行irm https://res1.hermesagent.org.cn/install.ps1 | iex时如果中途需要写入系统目录或修改环境变量会因为权限不足而静默失败屏幕上不出现任何红色报错。所以打开 PowerShell 时先在开始菜单搜 PowerShell右键选择「以管理员身份运行」再执行irm https://res1.hermesagent.org.cn/install.ps1 | iex如果 PowerShell 提示「禁止运行脚本」多半是当前执行策略限制了可以顺手执行一句Set-ExecutionPolicy RemoteSigned -Scope CurrentUser按 Y 确认后再跑安装命令。装完之后别急着关窗口重新打开一个新终端输入hermes --version。能显示版本号说明 Hermes 程序本体已经就位显示找不到命令说明刚才安装过程有环节没走完先补齐这一步再往后面配置。1.2 Hermes One 与 D 盘迁移后面两步是安装可视化界面 Hermes One再把 Hermes 迁移到 D 盘。Hermes One 相当于图形操作台装好之后不需要每次都用命令行。迁移 D 盘这件事文件复制只是表面动作真正的关键是环境变量。如果你只是把整个 Hermes 目录从 C 盘拖到 D 盘没有修改环境变量系统下次打开 Hermes 时还是在找 C 盘的旧路径找不到就闪退或者报错。修改完环境变量后必须重新打开终端或重启一次相关进程让新的 PATH 值被真正加载。可以用where.exe hermes看一眼输出路径确认是否已经是 D 盘的位置确认没问题再进入模型 API 配置环节避免后面把「路径不对」误判成「模型地址不对」。1.3 安装完成不等于能对话这里要说的是最容易被误会的一点安装完成只是把 Hermes 这个外壳装好了它里面并没有自带模型。打个比方Hermes 像是一个已经安装好的浏览器模型 API 地址就是地址栏里的网址不输入网址浏览器不可能凭空打开页面。Hermes One 打开后如果一直提示未配置模型或连接失败不是安装出问题了而是模型 API 还缺三项参数Base URL、API Key、模型 ID。TaoToken 可以把这三项统一管理起来你在官网拿一把 KeyBase URL 固定填https://taotoken.net/api模型 ID 按需换。下载好的 Agent 能不能跑起来真正起决定性作用的就是这一节。2. 先拿 Key再把 Hermes 模型 API 地址指到 TaoToken2.1 注册、登录、创建 Key配置前准备工作不多打开 TaoToken注册并登录进入控制台的 API Keys 页面新建一把 Key。创建后马上复制出来存到本地一个临时文本里。注意很多平台为了安全Key 只在创建那一刻完整显示一次关掉页面再回来只能重新创建。复制时不要选中多余空格也不要手动补字符粘贴到 Hermes 前先在记事本里看一遍末尾字符有没有丢。2.2 在 Hermes One 里打开模型 API 设置回到 Hermes One 的设置面板找到模型 API 或语言模型设置。不同版本入口叫法不太一样有的在「设置 模型」有的在「AI 服务」下面但字段基本一致Base URL、API Key、模型 ID。如果界面上默认填了官方地址先清空再按下一节表格替换。有些版本还带「自定义」开关手动填写时需要先打开这个开关否则输入框是灰的。保存前再扫一眼三个字段不要填反。2.3 参数对照与 /v1 提醒配置项填写内容Base URLhttps://taotoken.net/apiAPI KeyYOUR_API_KEYModel ID以 模型广场 当前列表为准这里最容易出错的是 Base URL 末尾的/v1。许多模型服务商的地址长这样于是到了 TaoToken 这里也习惯性补上/v1结果 Hermes 请求时拼出一个不存在的路径返回 404。TaoToken 的 Base URL 就是https://taotoken.net/api后面什么都不加。API Key 必须是刚才在官网创建的YOUR_API_KEY模型 ID 去模型广场复制不要凭记忆手打。如果模型广场上同一个模型有好几个版本显示挑名字跟你任务匹配的那一个复制拿不准就选列表里标记为 Stable 或推荐的那个。2.4 先到网页端验证 Key 是否有效在 2.1 创建完 Key 之后如果你担心后面排障把问题搞混可以先在 TaoToken 模型对话 里手动选择同一个模型用这把 Key 发一条消息。这一步能确认 Key 本身能用、模型 ID 没有写错。网页端通过后再回 Hermes 填写后面再遇到问题排障范围就只有 Hermes 这一侧了。3. 验证让下载好的 Agent 正常跑起来3.1 先发一句最简单的对话配置保存后回到 Hermes One先不要着急丢长文档或复杂任务。第一步发一句「你好请用一句话介绍你自己」。这句话返回速度快也足够检验链路。返回正常文本说明 Base URL、Key、模型 ID 三样全部对上下载好的 Hermes Agent 已经能正常跑。返回报错也不要慌按第四章顺序逐项查即可。先跑通最简对话再去切模型、加技能或让它写代码排查成本会低很多。3.2 让它做一个真实的小任务简单对话通过后可以再试一个真实一点的任务比如让 Hermes 写一段 Python 脚本读取当前目录所有文件并按修改时间排序打印。注意这里 Hermes 只是生成代码具体执行由你在本机跑跑完把结果贴回对话。这样既能验证模型 API 的稳定性也能确认 Agent 的回复没有被截断或超时。真正用起来时Agent 负责生成和解释执行操作仍由人工确认这个边界在配置阶段养成习惯最好。3.3 回控制台对一下调用记录对话成功后打开 TaoToken 控制台的用量页面刷新一下你应该能看到刚才那两轮对话的记录。这一步是确认 Hermes 的请求确实进了 TaoToken 通道而不是走了旧配置或者本地缓存。能查到记录说明「模型 API 地址改到 TaoToken」这件事真正闭环后面写代码、总结资料、处理长文都会稳定走同一条通道查不到记录多半是填写项里有非打印字符回头重新粘贴一次 Key。4. 配置后最常碰到的三个报错4.1 401 或 Unauthorized401 说明请求已经到达服务端但认证没通过。最常见的场景是 Key 在复制时漏了末尾几个字符或者把旧 Key 当成新 Key 填了进去。处理方式是回到官网控制台的 API Keys 页面重新创建一把 Key完整复制后覆盖粘贴到 Hermes粘贴后不要在 Key 前后加任何内容。如果用了多个平台的 Key注意别把其他服务商的密钥填进 Hermes格式虽然相似但 Hermes 请求时认证对象不对同样会 401。4.2 404 或 model not found404 和 model not found 基本指向两个原因路径多了后缀或者模型 ID 不存在。路径方面检查 Base URL 是不是写成了https://taotoken.net/api/v1把/v1删掉就能恢复模型 ID 方面不要自己猜测名称以官网模型广场列出的为准。有些模型在更新后会换 ID原来复制过的一次性文本要重新去广场复制旧 ID 可能已经下线。4.3 网络超时或连接失败如果换成 TaoToken 之前一切正常换成之后超时先不要急着怀疑 Key。在 PowerShell 里执行Test-NetConnection taotoken.net -Port 443看 TCP 443 是否连通。通则再把 Hermes One 完整退出重启很多时候连接失败是进程缓存了最早填的官方地址重启后才重新读取配置。还有一种情况是系统代理或防火墙拦掉了非默认端口的请求可以在 TaoToken 网页端先测试同模型的对话网页端正常就说明网络链路没问题问题仍在本机进程。提示排障时先固定变量。网页端模型对话用同一把 Key 发一条消息网页端正常就回 Hermes 排查网页端也报错就去检查 Key 是否有效。5. 迁移 D 盘与环境变量的收尾5.1 确认 PATH 指向新位置如果你按原文把 Hermes 迁移到了 D 盘修改环境变量后配置模型 API 前最好先确认 PATH 的新值已经生效。重新打开 PowerShell执行where.exe hermes。如果返回的路径还在 C 盘说明环境变量只是保存了没有在当前会话里重新加载关闭终端重开或者注销一次用户会话再看结果。这一步不做你可能在保存模型配置后准备对话时遇到闪退那个时刻很难判断是 API 问题还是路径问题。5.2 检查 Hermes One 版本与配置入口环境变量正常后顺手确认 Hermes One 的版本号。部分旧版本的可视化界面里模型 API 设置的入口名称不一样有的还藏在「高级设置」下面。如果按 2.2 找不到入口去官网查一下当前版本的接入文档或者看设置里有没有「API 兼容模式」这类开关。版本太旧的话先升级 Hermes One 再回来填参数否则界面字段对不上容易出现填了下拉框但没保存上的假象。5.3 把配置参数留个底模型 API 调通后把 Base URL、Key、模型 ID 记到本地文件里。以后升级 Hermes One、重置配置或换电脑照着填回去就能恢复。Key 从 TaoToken 创建不要发给别人用量记录在官网控制台随时可查。如果使用频率高也可以提前打开 Coding Plan 看看更适合的套餐Key 的管理和暂停统一在 控制台 API Keys 页面。到这里Hermes 的模型 API 地址已经完整指到 TaoToken下载好的 Agent 可以直接开始干活。
