OpenClaw：构建可复用Agent技能的实现指南

OpenClaw Skills 是什么？

OpenClaw Skills 是可复用、打包好的流程，为 AI Agent 赋予专业能力。可以把它们理解为插件——只不过不是盲目运行的代码，而是指导 Agent 按特定工作流执行的指令文档。

一个 Skill 可以是任何东西：

• 安全审计检查清单
• 某技术栈的部署流程
• 研究方法论
• 内容发布工作流

Agent 读取 Skill、理解步骤，然后利用已有工具（shell、浏览器、API 调用等）执行。

没有 Skill，每个 Agent 每次都要从零开始。有了 Skill：

• 一致性 — 跨 Agent 执行同一流程，步骤完全相同
• 可分享 — 发布到 ClawHub，其他 Agent 即可安装
• 版本控制 — Skill 有版本号，可更新迭代
• 可组合 — Agent 可以串联多个 Skill

最简 Skill 结构

一个最小可用的 Skill 需要以下结构：

my-skill/
├── SKILL.md          # 主要流程文档
├── examples/         # 可选：示例文件
├── scripts/          # 可选：辅助脚本
└── references/       # 可选：参考文档

SKILL.md 模板内容：

# My Skill Name

## When to Use
Describe when this skill should be triggered.

## Prerequisites
List any required tools, access, or setup.

## Procedure
1. Step one
2. Step two
3. Step three

## Verification
How to verify the task was completed correctly.

## Troubleshooting
Common issues and fixes.

实战示例：pfSense 安全审计 Skill

我为家庭 lab 构建了一个 pfSense 诊断 Skill，结构如下：

pfsense-diagnosis/
├── SKILL.md
├── references/
│   ├── hardening-checklist.md
│   └── common-issues.md
└── scripts/
    └── firewall-audit.sh

SKILL.md 里写的工作流包括：

• 检查固件版本
• 审查防火墙规则
• 审查 VPN 配置

现在，任何有 SSH 访问权限的 Agent 都可以运行 pfSense 安全审计，无需我每次重新解释步骤。

发布到 ClawHub

ClawHub 是 Skill 的市场。发布后，你的 Skill 即可供其他 OpenClaw 用户使用。

# 发布
openclaw skills publish my-skill/

# 安装
openclaw skills install @username/my-skill

# 列出已安装
openclaw skills list

家庭 Lab 运维者的 Skill 思路

构建高质量 Skill

应该做：

• 写清楚、分步骤的流程
• 包含验证步骤
• 为常见失败情况添加故障排除指南
• 用没有参与编写该 Skill 的 Agent 来测试
• 更新时给 Skill 打版本号

不应该做：

• 写模糊的指令（"检查一下防火墙"）
• 假设工具已安装（先检查）
• 硬编码凭证或 IP
• 跳过验证步骤
• 让 Skill 依赖特定 Agent 的个性

Skill Workshop

OpenClaw 内置了 Skill Workshop，用于创建和审查 Skill：

• Draft — 编写 Skill 流程
• Review — Workshop 校验结构
• Apply — Skill 上线供 Agent 使用
• Publish — 可选：分享到 ClawHub

这确保 Skill 在部署前符合质量标准。

可组合性：Skill 串联

Skill 可以引用其他 Skill：

## Procedure
1. Run the `pfsense-diagnosis` skill to check firewall health
2. Run the `docker-compose-validator` skill on all compose files
3. Cross-reference findings and generate combined report

这样就可以用简单、可复用的组件构建复杂工作流。

OpenClaw 文档：https://docs.openclaw.ai

ClawHub：在终端运行 openclaw skills search 搜索

GitHub：https://github.com/openclaw/openclaw

Skill 是 Agent 学习的方式。分享你的 Skill。