Hermes Web Tools

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install hermes-web-tools
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 hermes-web-tools。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

Hermes Web Tools 是 Openclaw Skills 的实用工具，用于诊断 Hermes web_search 和 web_extract 中的故障，而不会进行未经批准的配置更改。它说明后端优先级、严格的提供商选择、凭据发现、捆绑插件行为以及无密钥回退选项。
该技能可帮助区分真正的工具或配置问题与特定网站限制，例如由 JavaScript SPA 导致的空提取结果。它会提供基于证据的修复选项和准确命令，然后等待操作员授权更改。

应用场景

调查失败的 Hermes web_search 或 web_extract 调用。
确定错误影响整个工具，还是仅影响某个目标网站。
检查 Hermes 配置中存储的搜索和提取后端选择。
识别可用的 API 凭据，但不暴露机密值。
检测过时、拼写错误、不受支持或能力不兼容的后端名称。
解释为何搜索正常而提取失败，或为何 SPA 返回空内容。
在更改前比较托管、有密钥、无密钥和免费层后端选项。
排查在
hermes plugins list
中显示为未启用的捆绑 web 插件。

工作原理

在更改配置前，针对已知正常的 URL（例如 https://example.com 或 Wikipedia 网页抓取页面）运行差异测试。
在原始 URL 上重现故障，并捕获确切的错误消息或空结果行为。
检查 ~/ .hermes/config.yaml 中的 web.search_backend、web.extract_backend 和共享的 web.backend 回退设置。
仅检查凭据名称，包括 TAVILY_API_KEY、EXA_API_KEY、FIRECRAWL_API_KEY、PARALLEL_API_KEY、KEENABLE_API_KEY 和 BRAVE_SEARCH_API_KEY 等提供商变量。
根据受支持的提供商列表验证每个已存储后端，并确认其支持所请求的能力。
检查 hermes plugins list，确认相关捆绑的 web-* 插件；插件状态本身不决定选择结果。
说明根因是错误的存储选择、缺少凭据、能力不匹配、提供商行为，还是特定网站的 JavaScript 渲染限制。
提供准确的修复命令，但不自动执行。
操作员选择修复方案后，在授权工作流中应用，并使用 /reset 启动新的 Hermes 会话，因为 web 配置不会在会话中途重新读取。

配置指南

不需要单独安装软件包；该技能可在 Linux Hermes 安装及其现有配置文件上运行。首先进行只读检查：
hermes plugins list
grep -n -A5 '^web:' ~/ .hermes/config.yaml
grep -oE '^(TAVILY|EXA|FIRECRAWL|PARALLEL|KEENABLE|BRAVE_SEARCH)_API_KEY' ~/ .hermes/.env
根据受支持的名称检查后端选择：tavily、exa、firecrawl、parallel、keenable、ddgs、searxng、brave-free 和 xai。不要暴露或打印机密值。
只有在操作员明确批准后，才能清除选择以恢复自动检测：
hermes config set web. ""
将 替换为已批准的配置键，例如 backend、search_backend 或 extract_backend。任何配置或工具集更改后都需要新的 Hermes 会话。只有在明确请求时，才能禁用无密钥回退和救援行为：
hermes config set web.keyless_fallback false
hermes config set web.keyless_rescue false

数据架构

该技能处理 Hermes 配置、环境元数据、提供商能力和诊断结果。
数据区域 位置或字段 用途
技能元数据 SKILL.md front matter 定义 hermes-web-tools 名称、Linux 支持、MIT-0 许可证、Openclaw 主页、标签和相关技能。
共享后端 web.backend 两种 web 能力的回退选择；nous 表示托管的 Tool Gateway。
搜索覆盖 web.search_backend web_search 的最高优先级提供商选择。
提取覆盖 web.extract_backend web_extract 的最高优先级提供商选择。
回退控制 web.keyless_fallback、web.keyless_rescue 控制无密钥免费层轮换和一次性救援行为。
凭据 ~/ .hermes/.env 存储提供商 API 密钥；诊断只检查变量名，不检查机密值。
配置文件 ~/ .hermes/config.yaml 存储持久化的 web 后端选择及相关设置。
插件注册表 hermes plugins list 显示捆绑的 web-* 插件；显示未启用属于正常情况，因为插件按需加载。
诊断证据 工具响应与已知正常 URL 的比较 区分提供商/配置故障与目标网站或 JavaScript 渲染限制。
后端解析遵循以下分类：先使用各能力覆盖项，其次使用共享的 web.backend，只有在从未存储过选择时才使用环境变量自动检测。已存储的名称会严格按原样使用；无效名称会产生明确的提供商错误，而不是静默回退。

高级特性

支持独立选择搜索和提取后端，例如搜索使用
ddgs
，提取使用其他提供商。
记录 Exa、Parallel、Tavily、Firecrawl 和 Keenable 之间的无密钥免费层轮换，并支持自动故障转移。
支持针对有密钥后端故障的一次性无密钥救援，且不会固定使用救援提供商。
覆盖通过
nous
后端进行的托管 Tool Gateway 路由。
ddgs
、
searxng
、
brave-free
xai
等仅支持搜索的提供商。
强制执行严格选择语义，使过时或未知的后端名称被明确显示，而不是静默替换。
使用差异测试，在进行不必要的配置更改前检测 JavaScript SPA 限制。
提供安全的操作员批准边界：先调查、展示准确命令，绝不自主编辑配置。
考虑会话生命周期行为，包括批准配置更改后需要使用
/reset
。

name: hermes-web-tools description: "Use when Hermes web tools fail or need configuring." version: 1.0.0
author: Hermes Agent
license: MIT-0