万字详解：OpenClaw龙虾“高替” Hermes Agent的Skills系统

今天是深度使用Hermes Agent的第三天，结论依然不变：

Hermes是OpenClaw🦞的“高替”，用惯了Hermes Agent，就回不去龙虾了...

承接昨天的文章，继续贴出更多官方文档汉化内容~ 今天是Hermes Agent最重要的会自我进化的Skills系统！
（更多内容请访问我建的Hermes Agent汉化站： https://hermes-doc.aigc.green/getting-started/quickstart ）

Hermes Agent首次安装完成之后的目录结构大致如下：

~/.hermes/
├── .env
├── config.yaml
├── SOUL.md
├── hermes-agent/
├── skills/
├── memories/
├── sessions/
├── logs/
└── ...其他运行目录

Hermes Agent会在安装过程中将全部源代码都拉入 /hermes-agent/ 目录中，运行环境及工作代码都在这个目录里；剩下的 /skills, /sessions/, memories/, SOUL.md等文件，熟悉OpenClaw的同学一看就笑了，这不就是OpenClaw的workspace么 没错，默认状态下，/.hermes/ 这个根目录就是Hermes Agent的workspace，等效于OpenClaw的 /.openclaw/workspace/ ；只有在多Agents情况下，Hermes才会多出一个 /.hermes/profiles/ 目录来作为其他agents的workspace。

Skills是Agent在需要时可以加载的知识和行动文档。它们遵循渐进式披露模式，以最小化令牌使用量，并且兼容 agentskills.io 开放标准（Claude Code、Codex等Coding Agent都使用的skills标准语法）。

所有技能都位于 ~/.hermes/skills/ —— 这是主目录和唯一可信源。在全新安装时，捆绑的技能会从代码仓库复制到此目录。从hub安装的以及代理创建的技能也会放在这里。代理可以修改或删除任何技能。

你也可以将 Hermes 指向外部技能目录——这些是除了本地目录外还会被扫描的额外文件夹。请参阅后面的外部技能目录。

使用技能

每个已安装的技能都会自动作为一个斜杠命令可用：

# 在 CLI 或任何消息平台中：
/gif-search funny cats
/axolotl help me fine-tune Llama 3 on my dataset
/github-pr-workflow create a PR for the auth refactor
/plan design a rollout for migrating our auth provider

# 仅输入技能名称会加载它，并让代理询问你的需求：
/excalidraw

捆绑的 plan 技能是一个很好的例子，它是一个具有自定义行为的、由技能支持的斜杠命令。运行 /plan [请求] 会指示 Hermes 在需要时检查上下文，编写一个 Markdown 实施计划而不是执行任务，并将结果保存在相对于活动工作空间/后端工作目录的 .hermes/plans/ 下。

你也可以通过自然对话与技能交互：

hermes chat --toolsets skills -q "你有什么技能？"
hermes chat --toolsets skills -q "给我看看 axolotl 技能"

渐进式披露

技能使用一种节省令牌的加载模式：

Level 0: skills_list()           → [{name, description, category}, ...]   (~3k tokens)
Level 1: skill_view(name)        → 完整内容 + 元数据       (可变)
Level 2: skill_view(name, path)  → 特定的参考文件         (可变)

代理只在真正需要时才加载完整的技能内容。

SKILL.md 格式

---
name: my-skill
description: 此技能功能的简要描述
version: 1.0.0
platforms: [macos, linux]     # 可选——限制在特定的操作系统平台
metadata:
  hermes:
    tags: [python, automation]
    category: devops
    fallback_for_toolsets: [web]    # 可选——条件激活（见下文）
    requires_toolsets: [terminal]   # 可选——条件激活（见下文）
---

# 技能标题

## 何时使用
此技能的触发条件。

## 步骤
1. 第一步
2. 第二步

## 常见问题
- 已知的失败模式及修复方法

## 验证
如何确认它已成功。

平台特定技能

技能可以使用 platforms 字段限制自己只在特定的操作系统上运行：

platforms: [macos]            # 仅 macOS (例如，iMessage, Apple Reminders, FindMy)
platforms: [macos, linux]     # macOS 和 Linux

当设置此字段时，技能会在不兼容的平台上自动从系统提示、skills_list() 和斜杠命令中隐藏。如果省略，技能将在所有平台上加载。

条件激活（备用技能）

技能可以根据当前会话中可用的工具自动显示或隐藏自己。这对于备用技能最为有用——这些是免费或本地的替代方案，应该只在高级工具不可用时才出现。

metadata:
  hermes:
    fallback_for_toolsets: [web]      # 仅当这些工具集不可用时显示
    requires_toolsets: [terminal]     # 仅当这些工具集可用时显示
    fallback_for_tools: [web_search]  # 仅当这些特定工具不可用时显示
    requires_tools: [terminal]        # 仅当这些特定工具可用时显示

示例： 内置的 duckduckgo-search 技能使用了 fallback_for_toolsets: [web]。当你设置了 FIRECRAWL_API_KEY 时，web 工具集可用，代理会使用 web_search —— DuckDuckGo 技能保持隐藏。如果 API 密钥缺失，web 工具集不可用，DuckDuckGo 技能会自动作为备用方案出现。

没有任何条件字段的技能行为与之前完全一样——它们总是显示。

加载时的安全设置

技能可以声明所需的环境变量，而不会从发现列表中消失：

required_environment_variables:
  - name: TENOR_API_KEY
    prompt: Tenor API 密钥
    help: 从 https://developers.google.com/tenor 获取密钥
    required_for: 完整功能

当遇到缺失的值时，Hermes 仅在技能实际在本地 CLI 中加载时才会安全地询问。你可以跳过设置并继续使用该技能。消息界面永远不会在聊天中询问密钥——它们会告诉你在本地使用 hermes setup 或 ~/.hermes/.env。

一旦设置，声明的环境变量会自动传递到 execute_code 和 terminal 沙箱——技能的脚本可以直接使用 $TENOR_API_KEY。对于非技能的环境变量，请使用 terminal.env_passthrough 配置选项。详情请参阅环境变量传递。

技能目录结构

~/.hermes/skills/                  # 唯一可信源
├── mlops/                         # 分类目录
│   ├── axolotl/
│   │   ├── SKILL.md               # 主要说明（必需）
│   │   ├── references/            # 附加文档
│   │   ├── templates/             # 输出格式
│   │   ├── scripts/               # 可从技能调用的辅助脚本
│   │   └── assets/                # 补充文件
│   └── vllm/
│       └── SKILL.md
├── devops/
│   └── deploy-k8s/                # 代理创建的技能
│       ├── SKILL.md
│       └── references/
├── .hub/                          # 技能中心状态
│   ├── lock.json
│   ├── quarantine/
│   └── audit.log
└── .bundled_manifest              # 跟踪已植入的捆绑技能

外部技能目录

如果你在 Hermes 之外维护技能——例如，一个被多个 AI 工具共享的 ~/.agents/skills/ 目录——你可以告诉 Hermes 也扫描这些目录。

在 ~/.hermes/config.yaml 的 skills 部分下添加 external_dirs：

skills:
  external_dirs:
    - ~/.agents/skills
    - /home/shared/team-skills
    - ${SKILLS_REPO}/skills

路径支持 ~ 扩展和 ${VAR} 环境变量替换。

工作原理

• • 只读：外部目录仅用于技能发现扫描。当代理创建或编辑技能时，它总是写入 ~/.hermes/skills/。
• • 本地优先：如果同一个技能名称同时存在于本地目录和外部目录中，则本地版本优先。
• • 完全集成：外部技能会出现在系统提示索引、skills_list、skill_view 以及 /skill-name 斜杠命令中——与本地技能没有区别。
• • 不存在的路径会被静默跳过：如果配置的目录不存在，Hermes 会忽略它而不报错。这对于可能并非每台机器上都存在的可选共享目录很有用。

示例

~/.hermes/skills/               # 本地（主目录，读写）
├── devops/deploy-k8s/
│   └── SKILL.md
└── mlops/axolotl/
    └── SKILL.md

~/.agents/skills/               # 外部（只读，共享）
├── my-custom-workflow/
│   └── SKILL.md
└── team-conventions/
    └── SKILL.md

所有四个技能都会出现在你的技能索引中。如果你在本地创建一个名为 my-custom-workflow 的新技能，它会覆盖外部版本。

Agent管理的技能 (skill_manage 工具) -- Hermes最重要能力

Agent可以通过 skill_manage 工具创建、更新和删除自己的技能。这是代理的程序性记忆（Procedural Memory）——当它弄清楚一个非平凡的工作流程时，它会将该方法保存为一个技能以供将来重用。

代理何时创建技能

• • 成功完成复杂任务（5 次以上工具调用）后
• • 当它遇到错误或死胡同并找到可行路径时
• • 当用户纠正其方法时
• • 当它发现一个非平凡的工作流程时

操作

Tip

patch 操作是推荐的更新方式——它比 edit 更节省令牌，因为只有更改的文本会出现在工具调用中。

技能中心

从官方official、skills.sh、直接已知技能端点以及官方可选技能中浏览、搜索、安装和管理技能。

常用命令

hermes skills browse                              # 浏览所有中心技能（官方优先）
hermes skills browse --source official            # 仅浏览官方可选技能
hermes skills search kubernetes                   # 搜索所有来源
hermes skills search react --source skills-sh     # 搜索 skills.sh 目录
hermes skills search https://mintlify.com/docs --source well-known
hermes skills inspect openai/skills/k8s           # 安装前预览
hermes skills install openai/skills/k8s           # 安装并进行安全扫描
hermes skills install official/security/1password
hermes skills install skills-sh/vercel-labs/json-render/json-render-react --force
hermes skills install well-known:https://mintlify.com/docs/.well-known/skills/mintlify
hermes skills list --source hub                   # 列出从中心安装的技能
hermes skills check                               # 检查已安装的中心技能是否有上游更新
hermes skills update                              # 在需要时重新安装有上游更改的中心技能
hermes skills audit                               # 重新扫描所有中心技能的安全性
hermes skills uninstall k8s                       # 移除一个中心技能
hermes skills publish skills/my-skill --to github --repo owner/repo
hermes skills snapshot export setup.json          # 导出技能配置
hermes skills tap add myorg/skills-repo           # 添加自定义 GitHub 源

支持的技能中心来源

集成的中心和注册中心

Hermes 目前集成了以下技能生态系统和发现来源：

1. 官方可选技能 (official)

这些技能在 Hermes 仓库内部维护，安装时自带信任度。

• • 目录：官方可选技能目录
• • 仓库内源位置：optional-skills/
• • 示例：

hermes skills browse --source official
hermes skills install official/security/1password

2. skills.sh (skills-sh)

这是 Vercel 的公共技能目录。Hermes 可以直接搜索它，查看技能详情页面，解析别名形式的短名称，并从底层的源码仓库安装。

• • 目录：skills.sh
• • CLI/工具仓库：vercel-labs/skills
• • 官方 Vercel 技能仓库：vercel-labs/agent-skills
• • 示例：

hermes skills search react --source skills-sh
hermes skills inspect skills-sh/vercel-labs/json-render/json-render-react
hermes skills install skills-sh/vercel-labs/json-render/json-render-react --force

3. 知名技能端点 (well-known)

这是基于 URL 的发现方式，从发布 /.well-known/skills/index.json 的网站获取。它不是单一的中心化枢纽，而是网络发现约定。

• • 实时端点示例：Mintlify 文档技能索引
• • 参考服务器实现：vercel-labs/skills-handler
• • 示例：

hermes skills search https://mintlify.com/docs --source well-known
hermes skills inspect well-known:https://mintlify.com/docs/.well-known/skills/mintlify
hermes skills install well-known:https://mintlify.com/docs/.well-known/skills/mintlify

4. 直接 GitHub 技能 (github)

Hermes 可以直接从 GitHub 仓库和基于 GitHub 的 taps 安装。当你已经知道仓库/路径或者想添加自己的自定义源仓库时，这很有用。

默认 taps（无需设置即可浏览）：

• • openai/skills
• • anthropics/skills
• • VoltAgent/awesome-agent-skills
• • garrytan/gstack
• • 示例：

hermes skills install openai/skills/k8s
hermes skills tap add myorg/skills-repo

5. ClawHub (clawhub)

一个作为社区源集成的第三方技能市场。

• • 站点：clawhub.ai
• • Hermes 源标识：clawhub

6. Claude 市场风格仓库 (claude-marketplace)

Hermes 支持发布 Claude 兼容的插件/市场清单的市场仓库。

已知的集成源包括：

• • anthropics/skills
• • aiskillstore/marketplace

Hermes 源标识：claude-marketplace

7. LobeHub (lobehub)

Hermes 可以从 LobeHub 的公共目录中搜索并转换智能体条目为可安装的 Hermes 技能。

• • 站点：LobeHub
• • 公共智能体索引：chat-agents.lobehub.com
• • 支撑仓库：lobehub/lobe-chat-agents
• • Hermes 源标识：lobehub

安全扫描与 --force

所有通过 hub 安装的技能都会经过一个安全扫描器的检查，它会检测数据窃取、提示注入、破坏性命令、供应链信号和其他威胁。

hermes skills inspect ... 现在也会在有可用信息时展示上游元数据：

• • 仓库 URL
• • skills.sh 详情页面 URL
• • 安装命令
• • 每周安装次数
• • 上游安全审计状态
• • 知名索引/端点 URL

当你已经审查了一个第三方技能并想覆盖一个非危险的政策阻止时，请使用 --force：

hermes skills install skills-sh/anthropics/skills/pdf --force

重要行为：

• • --force 可以覆盖针对谨慎/警告类发现的政策阻止。
• • --force不会覆盖 dangerous 扫描裁决。
• • 官方可选技能 (official/...) 被视为自带信任，不会显示第三方警告面板。

信任级别

更新生命周期

hub 现在会追踪足够的来源信息，以重新检查已安装技能的在线副本：

hermes skills check          # 报告哪些已安装的 hub 技能在上游发生了变化
hermes skills update         # 仅重新安装有可用更新的技能
hermes skills update react   # 更新一个特定的已安装 hub 技能

这使用了存储的源标识加上当前上游 bundle 内容哈希来检测变更。

斜杠命令（在聊天中）

所有相同的命令都可以通过 /skills 使用：

/skills browse
/skills search react --source skills-sh
/skills search https://mintlify.com/docs --source well-known
/skills inspect skills-sh/vercel-labs/json-render/json-render-react
/skills install openai/skills/skill-creator --force
/skills check
/skills update
/skills list

官方可选技能仍然使用像 official/security/1password 和 official/migration/openclaw-migration 这样的标识符。

Hermes 附带一个庞大的内置技能库，安装时会复制到 ~/.hermes/skills/ 目录下。本页面记录了位于仓库 skills/ 目录下的内置技能。

apple

Apple/macOS 专属技能 —— iMessage、提醒事项、备忘录、查找以及 macOS 自动化。这些技能仅在 macOS 系统上加载。

autonomous-ai-agents

用于启动和编排自主 AI 编程智能体及多智能体工作流的技能 —— 运行独立的智能体进程、委派任务、协调并行工作流。

data-science

用于数据科学工作流的技能 —— 交互式探索、Jupyter 笔记本、数据分析和可视化。

creative

创意内容生成 —— ASCII 艺术、手绘风格图表和视觉设计工具。

devops

DevOps 和基础设施自动化技能。

dogfood

email

用于从终端发送、接收、搜索和管理电子邮件的技能。

gaming

用于设置、配置和管理游戏服务器、模组包及游戏相关基础设施的技能。

github

使用 gh CLI 和 git 通过终端管理仓库、拉取请求、代码审查、问题和 CI/CD 管道的 GitHub 工作流技能。

inference-sh

通过 inference.sh 云平台执行 AI 应用的技能。

leisure

MCP

用于处理 MCP（模型上下文协议）服务器、工具和集成的技能。包括内置的原生 MCP 客户端（在 config.yaml 中配置服务器以自动发现工具）以及用于临时服务器交互的 mcporter CLI 桥接。

media

用于处理媒体内容的技能 —— YouTube 字幕、GIF 搜索、音乐生成和音频可视化。

mlops

通用 ML 运维工具 —— 模型中心管理、数据集操作和工作流编排。

mlops/cloud

用于 ML 工作负载的 GPU 云提供商和无服务器计算平台。

mlops/evaluation

模型评估基准、实验跟踪、数据整理、分词器和可解释性工具。

mlops/inference

模型服务、量化（GGUF/GPTQ）、结构化输出、推理优化和模型手术工具，用于部署和运行 LLM。

mlops/models

特定模型架构和工具——计算机视觉（CLIP、SAM、Stable Diffusion）、语音（Whisper）、音频生成（AudioCraft）和多模态模型（LLaVA）。

mlops/research

用于通过声明式编程构建和优化 AI 系统的 ML 研究框架。

mlops/training

用于训练 LLM 和其他模型的微调、RLHF/DPO/GRPO 训练、分布式训练框架和优化工具。

mlops/vector-databases

用于 RAG、语义搜索和 AI 应用后端的向量相似性搜索和嵌入数据库。

note-taking

笔记技能，用于保存信息、协助研究，以及在多会话规划和信息共享上进行协作。

productivity

用于文档创建、演示文稿、电子表格和其他生产力工作流的技能。

research

用于学术研究、论文发现、文献综述、领域侦察、市场数据、内容监控和科学知识检索的技能。

red-teaming

用于 LLM 红队测试、越狱和安全过滤器绕过研究的技能。

smart-home

用于控制智能家居设备（灯光、开关、传感器和家庭自动化系统）的技能。

social-media

用于与社交平台交互的技能——发布、阅读、监控和账户操作。

software-development

可选技能随仓库提供，位于 optional-skills/ 目录下，但默认不激活。它们涵盖较重或小众的用例。使用以下命令安装：

hermes skills install official/<category>/<skill>

autonomous-ai-agents

blockchain

creative

devops

email

health

mcp

migration

productivity

research

security

官方可选技能位于仓库的 optional-skills/ 目录下。使用 hermes skills install official/<category>/<skill> 命令安装，或使用 hermes skills browse --source official 命令浏览。

autonomous-ai-agents

blockchain

creative

email

health

mcp

migration

productivity

research

security