读到一篇“无需密钥就能使用 Agent”的介绍，安装后却找不到文中的模型选项，首先应该检查文章对应的版本。Agent 软件与外部服务都在更新，曾经存在的入口，不能仅凭旧发布说明保证今天仍可用。
Hermes Agent v0.20.5 的发布说明标注日期为 2026 年 8 月 19 日，内容确实提到免 Key 的网页工具层，以及 opencode-free 零认证模型入口。本文保留这个历史事实，同时用 2026 年 9 月 23 日的当前文档解释怎样重新核对配置。这里没有对匿名通道进行可用性或速度实测。v0.20.5 发布说明
当时新增的是两条不同的路径
模型服务负责理解任务、生成回答和决定调用工具；网页搜索负责查找外部资料。两个环节可以分别配置，也可以分别失败。模型能回答一句问候，不说明它已经具备联网检索能力；搜索能返回几个链接，也不说明所选模型能稳定完成多步任务。
在 v2026.8.19 标签中的供应商文档里，OpenCode Free 被列为无需账号或密钥的入口，并给出了 free 等别名。这能支持对旧版本功能的说明，不能用来为后续版本列出一份永久可用的免费模型清单。对应版本的供应商文档
截至本次核查，当前供应商文档已经没有列出 opencode-free。因此，旧文章里“打开选择器选 free 即可”的步骤，不应继续作为所有新安装的统一教程。如果你使用的是当前版本，应以它的模型选择器和当前文档为准；如果复现旧版本行为，则明确记录标签与当时资料。
仅凭文档中不再出现某个名称，也不宜自行推断所有已有安装都立即失效。实际情况还可能涉及保留配置、迁移逻辑和外部端点变化。排障需要回到自己的版本、配置和请求错误。
先记录现在运行的版本与提供方
开始排查时，把已安装版本、启动方式、当前模型提供方和模型 ID 记下来。若同时有 CLI、桌面程序与后台服务，还要确认出问题的是哪一个实例。终端里切换了模型，不代表另一个长时间运行的服务立即采用同一配置。
当前官方文档仍以 hermes model 作为模型配置入口，并列出多种提供方。不同方式可能使用 API key、浏览器授权、订阅或自托管地址。看见“不用手工填 Key”，不能直接理解为不需要账号或不产生费用。当前模型提供方说明
可以先做一个不需要任何工具的小任务，例如归纳一段公开短文。若它也失败，优先检查模型连接、认证和模型名称；不要急着修改网页搜索设置。若普通回答成功，再继续测试工具调用，这样每一步都有明确作用。
对于外部错误，保存状态码、提供方名称和时间，但不要把完整密钥复制进求助记录。模型 ID 不存在、认证失败、额度不足和请求限流，需要采取不同处理。无限重试同一条错误请求，通常无法解决配置不匹配。
当前免 Key 搜索仍要看所选配置
当前网页工具文档介绍了 web_search 与 web_extract，分别用于搜索和提取页面正文。在没有网页凭据的全新安装中，文档说明可以使用多个服务组成的免费轮换层；已配置的后端或密钥通常优先，另有显式选择免费或付费路径的配置。网页搜索与提取
这意味着两台机器虽然安装了同一个版本，实际请求也可能走不同提供方。一台从未配置过搜索服务，另一台保留了旧 API key，结果、错误和计费行为就可能不同。排查时先通过 hermes tools 核对选择，再看配置中是否仍有以前留下的值。
如果任务只需要查找公开资料，可以先给出一个明确主题和一个已知官方页面。观察搜索是否返回相关链接，再要求读取那一页正文。不要让助手一次同时完成搜索、下载、修改文件和发送通知，否则失败时很难知道哪一环没有跑通。
免费层也可能限流或暂时不可用。记录实际错误与是否切换后端，比只写“联网失败”更有帮助。对长期任务，需要事先决定哪些失败可以重试，哪些应该停下来报告缺少资料。
搜索摘要不够，长页面还可能被截断
一个常见误会是工具成功返回文本，就认为助手已经读完页面。当前 Hermes 文档说明，较长的提取结果可能按字符预算截取，并将完整文本保存到文件，返回中会提示截断与继续读取的方法。
技术文档的限定条件常出现在中间：支持哪些版本、哪些参数不能组合、某功能是否仍处于实验阶段。如果助手只看开头与结尾，可能恰好遗漏这部分。要求它回答时提供直接来源，并在出现截断提示时读取相关缺失段落。
还要留意缓存。反复查询同一页可能使用已有成功结果，对于稳定文档很方便；如果正在排查刚更新的页面，就要确认缓存策略和查询时间。不能把一份缓存内容直接当成此刻重新取得的网页。
评估检索质量时，可以用一个答案已知的小问题：选定版本支持什么安装方式，或者某个参数的默认值是什么。将结果与原始文档对照。比起让它推荐一堆工具，这种任务更容易发现遗漏和错误归纳。
用临时目录测试文件工具
模型与网页都能工作以后，再测试本地工具。准备一个只有公开样本文本的独立目录，让助手读取文件，生成一份新的摘要，不修改原文件。随后自己检查新文件是否存在、内容是否对应原文、是否出现了未经要求的改动。
第一次任务可以只包含几个动作：读一份文件、找出三条要点、保存结果。等这一流程稳定，再增加命令执行或更多文件。复杂任务拆开验证以后，后续失败更容易定位到模型、权限或工具本身。
Hermes 提供命令审批、工具配置和不同执行环境相关能力，具体使用方式要按实际版本设置。不要把“工具可用”当成它应当读取整台电脑；也不用为了测试公开材料，把生产密钥和私人文档放进同一工作目录。安全与执行设置
如果后续需要消息网关或定时任务，应单独验收目标账号、接收位置和重复执行行为。一次本地摘要成功，并不能证明后台任务会在正确时间把正确内容发给正确的人。
备用模型需要重测同一项任务
备用提供方可以减少单点不可用，但切换以后，模型的工具调用、上下文容量和输出行为可能不同。配置了备用项，并不意味着所有任务都能无差别继续。备用提供方文档
可以用同一个小任务检查主路径和备用路径：读取同一份材料，生成同一种结果，并查看是否完成了必要工具调用。若主模型只读文件，备用模型却尝试执行多余命令，就需要进一步调整任务约束与工具配置。
对于有外部写入的任务，还要先确认原动作是否已完成。网络超时以后，换模型再执行一次发布，可能产生重复内容。把已经写入的资源标识保存下来，恢复时先核对结果，比依赖助手回忆上一轮发生了什么更可靠。
长期使用时，按任务记录总耗时、失败原因与人工修改量。如果大多数时间都花在恢复免费通道或重新核对结果，是否选择其他提供方就有了自己的依据；无需只看宣传中的模型数量。
旧版本消息应该怎样使用
v0.20.5 的免 Key 功能说明了当时降低初次配置门槛的一次变化。今天阅读它，最有用的是理解模型连接与网页工具可以分开试验，而不是照着旧模型名逐个尝试。
安装当前版本时，先跑通普通回答，再验证搜索与正文读取，最后加入文件或命令任务。每一步保留版本和结果。这样遇到变化时，你知道需要重新检查哪一部分，也能判断问题来自本地设置还是外部服务。