保姆级教程｜OpenClaw & Hermes Agent Skills 安装全攻略，轻松扩展 AI 智能体能力

在 AI 智能体普及的当下，OpenClaw（龙虾）和 Hermes（NousResearch 出品）凭借灵活的扩展性，成为很多开发者和 AI 爱好者的首选工具。而 Skills（技能）作为二者的核心能力载体，无需修改源码，就能让智能体新增联网搜索、代码审查、文件处理、自动化部署等实用功能，大幅提升工作效率。

本文将从基础概念入手，分平台、分场景讲解两款智能体安装 Skills 的详细方法，同时附上常见报错解决方案和必装技能清单，无论你是新手还是进阶用户，都能快速上手，让 AI 智能体成为你的高效助手。

一、先搞懂：什么是 Skills？为什么要安装？

Skills 本质是符合标准化规范的 Markdown 文件（核心为 SKILL.md），包含技能的触发条件、执行步骤、参数配置和异常规避方案，智能体在匹配到对应场景时，会自动加载并执行该技能，实现 “一句话完成复杂任务” 的效果。

OpenClaw 和 Hermes 采用统一的 Skills 规范，二者技能可互通使用，这也是它们扩展性强的关键原因。安装 Skills 后，原本只能进行简单对话的智能体，就能实现批量处理文件、自动爬取数据、一键部署项目等自动化操作，真正摆脱 “只会聊天” 的局限。

补充说明：OpenClaw 支持 “全局技能” 和 “项目局部技能”，可按需区分使用；Hermes 则统一采用全局技能目录，加载更简洁，还支持智能体自主生成、保存新技能，适配不同使用场景。

二、前置准备：环境校验与目录梳理

在安装 Skills 前，需先确认 OpenClaw 和 Hermes 已正常安装，同时记住二者的技能默认目录，避免后续安装后无法生效。以下步骤适配 Windows、WSL、Linux、macOS 全平台。

2.1 OpenClaw 环境校验与目录

打开终端（Windows 用 CMD/PowerShell，Linux/macOS/WSL 用终端），执行以下命令校验安装：

openclaw --version

若能正常显示版本号，说明安装成功。默认技能目录如下：

全局技能（所有项目生效）：Windows 为 C:\Users\用户名\.openclaw\workspace\skills；Linux/macOS/WSL 为 ~/.openclaw/workspace/skills
项目局部技能（仅当前项目生效）：在项目根目录新建 .openclaw/skills 文件夹即可

2.2 Hermes 环境校验与目录

同样在终端执行以下命令校验 Hermes 安装：

hermes --version

若未安装 Hermes，可执行官方一键安装脚本（适配 WSL、Linux、macOS）：

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
source ~/.bashrc  # 刷新环境变量，使命令生效

Hermes 默认技能目录（全局生效）：~/.hermes/skills（Windows 系统可在用户目录下找到对应文件夹）。

三、OpenClaw：四种 Skills 安装方法，新手也能秒会

OpenClaw 提供多种安装方式，可根据网络环境、技能来源灵活选择，其中手动离线安装适配国内网络，避免出现限流报错，新手优先推荐官方商店和手动安装。

3.1 方法一：官方 ClawHub 网页商店安装（新手首选）

ClawHub 是 OpenClaw 官方技能商店，收录了大量优质技能（如全网搜索、PDF 解析、Git 操作等），安装步骤简单，无需复杂命令。

打开浏览器，访问 ClawHub 官方网站：https://clawhub.ai
在搜索框输入需要的技能关键词（如 “web-search”“pdf-parse”），找到目标技能后，查看详情；
选择安装方式：
- 对话窗口安装：复制网页上的安装命令，在 OpenClaw 对话窗口粘贴输入，格式为 /skills install @作者/技能名，回车即可自动安装；
- CLI 命令安装：在终端执行 clawhub install @author/skill-name，完成后自动写入配置。
安装完成后，无需重启程序，新建对话会话即可调用该技能。

3.2 方法二：CLI 命令行一键安装（GitHub 仓库来源）

适用于未上架 ClawHub、自定义 Fork 改版的技能，可直接从 GitHub 仓库拉取安装，支持指定分支、版本和私有仓库授权。

# 直接拉取 GitHub 仓库安装
openclaw skill install --github https://github.com/xxx/xxx-skill

# 指定分支/版本安装（如 v1.0.0 版本）
openclaw skill install --github 仓库地址 --ref v1.0.0

# 私有仓库安装（携带 Token 授权）
openclaw skill install --github 私有仓库地址 --token ghp_xxxx（你的 GitHub Token）

补充：追加 --global 参数，可将技能安装为全局技能；不追加则仅当前项目可用。

3.3 方法三：手动离线安装（国内网络必用，防限流）

国内网络访问 ClawHub 或 GitHub 时，容易出现频率限制、下载失败等问题，手动离线安装是最稳定的方式，零命令操作，适合所有用户。

在 ClawHub 技能详情页，点击 Download zip 下载技能压缩包；若技能来自 GitHub，直接下载仓库压缩包即可；
解压压缩包，重点检查：技能文件夹内层必须直接存在 SKILL.md 文件，不能嵌套多层子文件夹（这是技能不生效的核心原因之一）；
将解压后的整个文件夹，复制粘贴到 OpenClaw 对应的技能目录（全局或局部均可）；
无需执行任何命令，也无需重启 OpenClaw，新建对话后，智能体会自动识别并加载该技能。

3.4 方法四：本地自定义技能挂载（个性化需求）

若现有技能无法满足需求，可手动创建自定义技能，实现个性化自动化任务，比如批量重命名文件、自动备份数据等。

在 OpenClaw 技能目录新建文件夹，命名简洁易懂，如 my-file-batch-rename；
在该文件夹内新建 SKILL.md 文件，写入以下标准模板，根据需求修改内容：

---
name: file-batch-rename
description: 批量重命名当前目录指定后缀的文件，支持自定义命名规则
---
## 使用场景
当用户需要批量修改当前目录下指定后缀（如 .txt、.jpg）的文件名时，自动调用该技能。
## 执行流程
1. 列出当前目录下所有文件，筛选出符合用户指定后缀的文件；
2. 询问用户自定义命名规则（如前缀+序号）；
3. 按照规则拼接新文件名，执行重命名操作；
4. 反馈重命名结果，提示是否完成。
## 注意事项
1. 禁止修改系统隐藏文件和重要配置文件；
2. 重命名前会自动备份原文件名，避免误操作；
3. 仅支持当前目录下的文件，不包含子目录。

保存文件后，技能立即生效，在 OpenClaw 对话中输入相关指令（如 “帮我批量重命名当前目录的 txt 文件”），即可触发执行。

OpenClaw 技能常用管理命令

安装完成后，可通过以下命令管理技能，方便后续更新、卸载和校验：

# 查看已安装技能列表
clawhub list

# 更新单个技能
/skills update @作者/技能名

# 批量更新全部技能
/skills update --all

# 卸载移除技能
/skills remove @作者/技能名

# 校验技能安全性与格式（避免技能报错）
openclaw skills verify @author/skill

四、Hermes Agent：三种 Skills 安装方法，简洁高效

Hermes 原生兼容 agentskills.io 标准，技能安装方式更简洁，支持命令行、手动拖拽和跨工具安装（借助 OpenClaw），适配不同使用习惯。

4.1 方法一：官方 CLI 命令行安装（推荐）

Hermes 内置技能仓库，可通过简单的 CLI 命令实现技能的搜索、安装、更新和卸载，操作便捷，适合熟悉终端的用户。

# 浏览官方技能仓库，查看所有可用技能
hermes skills browse

# 关键词搜索技能（如搜索“web”相关技能）
hermes skills search web

# 安装官方内置技能（以网页搜索技能为例）
hermes skills install official/web-search

# 从 GitHub 仓库直接拉取技能
hermes skills install github:用户名/仓库名

# 查看单条技能详情，了解使用方法
hermes skills show web-search

# 列出本机所有已安装技能
hermes skills list

# 更新指定技能
hermes skills update 技能名

# 卸载指定技能
hermes skills remove 技能名

4.2 方法二：手动拖拽安装（零命令，新手友好）

无需使用终端，通过简单的复制粘贴即可完成安装，适合不熟悉命令行的新手用户，步骤与 OpenClaw 手动安装类似。

下载 Hermes 社区技能压缩包，或 Git 克隆技能仓库；
解压后，确保技能文件夹根目录包含 SKILL.md 文件（避免嵌套）；
将该文件夹复制粘贴到 Hermes 默认技能目录 ~/.hermes/skills；
重启 Hermes 会话（关闭当前对话，重新打开），智能体即可自动加载技能。

4.3 方法三：OpenClaw 一键封装安装（联动玩法）

可借助 OpenClaw 的技能体系，封装一个 “Hermes 技能安装器”，后续只需一句话，就能让 OpenClaw 全自动为 Hermes 安装技能，实现 “智能体装智能体” 的联动效果。

在 OpenClaw 全局技能目录新建文件夹 hermes-skill-installer；
在该文件夹内新建 SKILL.md，写入以下内容（可根据需求修改技能列表）：

---
name: hermes-skill-installer
description: 一键全自动为 Hermes Agent 安装常用技能，包括网页搜索、PDF 解析、Git 操作
---
## Workflow
1. 校验 Hermes 是否正常安装，执行命令：hermes --version；
2. 安装官方网页搜索技能：hermes skills install official/web-search；
3. 安装 PDF 解析技能：hermes skills install github:xxx/pdf-parse-skill（替换为实际仓库地址）；
4. 安装 Git 操作技能：hermes skills install official/git-operation；
5. 执行 hermes skills list，反馈安装结果，提示技能已全部安装完成。
## 备注
适配 WSL、Linux、macOS 环境，自动补全依赖，无需手动干预。

保存后，在 OpenClaw 对话中输入 “帮我运行 Hermes 技能安装器”，即可全自动完成 Hermes 技能的安装，省去手动操作的麻烦。

五、进阶玩法：OpenClaw 技能批量迁移至 Hermes

若你在 OpenClaw 中积攒了大量自定义技能或已安装的优质技能，无需重新下载安装，可直接批量迁移至 Hermes，二者技能格式完全通用，迁移步骤简单。

先备份 OpenClaw 配置，防止丢失： cp -r ~/.openclaw ~/.openclaw_backup_$(date +%Y%m%d)
自动迁移：执行 Hermes 初始化命令，系统会自动扫描 OpenClaw 默认技能目录，交互式导入所有技能： hermes init 按照提示选择 “yes”，即可完成自动迁移，过程中会自动处理兼容性问题。
手动迁移（自动迁移失败时使用）：直接复制 OpenClaw 技能目录（~/.openclaw/workspace/skills）内的所有文件夹，粘贴到 Hermes 技能目录（~/.hermes/skills），无需修改任何文件内容，重启 Hermes 即可生效。

六、常见报错与排坑指南，避免踩雷

安装 Skills 过程中，容易出现技能不生效、命令报错等问题，以下是最常见的报错及解决方案，建议收藏备用。

6.1 OpenClaw 安装提示 “Rate limit exceeded”（限流）

原因：国内网络访问 GitHub/ClawHub 频率过高，触发平台限流机制。解决方案：放弃 CLI 命令安装，改用 “手动离线安装”，下载技能压缩包后解压放入对应目录，可彻底避免限流问题。

6.2 放入技能文件夹后，智能体无法识别（技能不生效）

这是最常见的问题，核心原因是文件路径或格式错误，解决方案如下：

检查路径：SKILL.md 必须在技能文件夹的一级目录，不能嵌套在子文件夹内（如 skill-folder/sub-folder/SKILL.md 是错误格式）；
检查格式：SKILL.md 头部的元信息（--- name: xxx ---）不能缺行、不能写错符号，必须严格遵循 Markdown 格式；
重启会话：关闭当前对话窗口，新建会话重新发起指令，智能体会重新加载技能。

6.3 Hermes 终端提示 “找不到 hermes 命令”

原因：安装后未刷新环境变量，终端无法识别命令。解决方案：执行 source ~/.bashrc（bash 终端）或 source ~/.zshrc（zsh 终端）刷新环境变量；Windows WSL 用户建议直接重启终端，即可正常使用 hermes 命令。

6.4 需要 API Key 的技能无法使用（如搜索、AI 绘图技能）

原因：部分技能（如全网搜索、AI 绘图）需要第三方平台的 API Key 才能使用，未配置则无法触发。解决方案：打开对应技能文件夹内的配置说明（一般为 README.md 或 config.yaml），按照提示获取对应 API Key（如 Tavily 搜索 API、OpenAI API），然后在 OpenClaw（openclaw.json）或 Hermes 的配置文件中填入密钥，保存后重启会话即可使用。

七、必装实用 Skills 清单，新手直接抄作业

为了帮大家快速上手，整理了几款高频实用的 Skills，涵盖日常办公、开发、数据处理等场景，安装后可大幅提升智能体实用性，新手直接抄作业即可。

web-search（网页搜索）：让智能体实现全网联网搜索，获取最新信息，告别 “信息滞后”；
pdf-parse（PDF 解析）：批量解析 PDF 文档内容，提取关键信息、生成摘要，适合办公场景；
git-operation（Git 操作）：一键实现代码提交、拉取、分支管理，适配开发场景；
file-batch-handle（文件批量处理）：批量重命名、压缩、解压文件，节省手动操作时间；
docker-manager（Docker 管理）：一键启动、停止、部署 Docker 容器，适配运维场景；
document-summary（文档总结）：快速总结 Word、Markdown、TXT 等格式文档，提炼核心内容。

八、总结：按需选择，轻松扩展智能体能力

OpenClaw 和 Hermes 作为两款优秀的 AI 智能体工具，其 Skills 体系的灵活性和互通性，让用户无需具备复杂的开发能力，就能轻松扩展智能体功能。OpenClaw 更适合轻量化多项目管理，支持局部技能，适配多场景切换；Hermes 则偏向单机常驻，支持智能体自主进化技能，操作更简洁。

无论你是新手还是进阶用户，按照本文的方法安装 Skills，再结合必装清单，就能快速打造属于自己的 “自动化 AI 助手”，实现办公、开发、运维等场景的高效自动化。后续若有新的技能需求，可随时通过官方商店、GitHub 或自定义创建的方式补充，让智能体的能力持续升级。

最后，如果你在安装过程中遇到其他问题，欢迎在评论区留言交流，一起解锁 AI 智能体的更多玩法～

另外补充：ClawHub 官方商店还有 Trello、Slack、Caldav Calendar、Answer Overflow 等高亮技能，以及 Gog、Wacli、Tavily Web Search、Summarize、Github、Sonoscli、Weather 等热门技能，可根据自身需求选择安装；若遇到 GitHub 网页解析失败的情况，优先选择手动离线安装方式，避免解析问题影响技能安装。