OpenClaw Skills 完全指南：从安装到自进化，打造你的 AI 技能库

一文讲透 OpenClaw Skills 的安装层级、self-improvement 自进化机制与 skill-vetter 安全审查

2026-07-19 约 1637 字预计阅读 4 分钟

/images/Code-Art-Studio-images/openclaw-skills-system/openclaw-skills-system.webp

OpenClaw Skills 完全指南：从安装到自进化，打造你的 AI 技能库

OpenClaw 的技能系统（Skills）是其 Agent 能力的核心扩展机制。不同于传统插件，Skills 本质上是「可插拔的 Agent 行为规范」——一段 Markdown 指令，告诉 Agent 如何完成特定任务。但很多用户对 Skills 的安装范围、作用域和自进化机制一知半解，导致明明装了技能却无效，或者多 Agent 间无法共享。本文将系统梳理 OpenClaw Skills 的完整知识体系。

技能层级与安装范围

OpenClaw 的 Skills 有三种安装范围，决定了技能的可见性和共享边界。

workspace 级（默认）

安装到当前 workspace 的 ~/.openclaw/workspace/skills/，仅当前 Agent 可用。适合高度定制化的技能。

openclaw skills install skill-vetter

实例级共享

安装到 ~/.openclaw/skills/，同一 OpenClaw 实例的所有 Agent 共享。适合团队统一使用的技能。

npm install -g clawhub
mkdir -p ~/.openclaw/skills
cd ~/.openclaw/skills
clawhub install skill-vetter

系统全局

安装到 ~/.agents/skills/，跨多个 workspace 可见。适合通用基础技能。

关键区别：

openclaw skills install 默认装到当前 workspace
clawhub install 装到当前 shell 工作目录的 ./skills/ 下
要让同一实例多 Agent 共享 → 装到 ~/.openclaw/skills/

Self-Improvement：让 AI 真正变聪明

Self-improvement 是 OpenClaw 生态中最具特色的技能之一。它的核心理念是：用户纠正 AI → AI 写日志 → 下次 session 自动读取 → AI 不再犯同样错误。

配置步骤（一次性）

1. 创建日志目录

mkdir -p ~/.openclaw/workspace/.learnings

cat > ~/.openclaw/workspace/.learnings/LEARNINGS.md << 'EOF'
# Learnings
Corrections, insights, and knowledge gaps.
Categories: correction | insight | knowledge_gap | best_practice
---

cat > ~/.openclaw/workspace/.learnings/ERRORS.md << 'EOF'
# Errors
Command failures and integration errors.
---

cat > ~/.openclaw/workspace/.learnings/FEATURE_REQUESTS.md << 'EOF'
# Feature Requests
Capabilities requested by the user.
---

2. 在 AGENTS.md 写入工作流指令

## Self-Improvement Workflow
When errors or corrections occur:
1. Log to `.learnings/ERRORS.md`, `LEARNINGS.md`, or `FEATURE_REQUESTS.md`
2. Review and promote broadly applicable learnings to:
   - `AGENTS.md` - workflows and automation
   - `SOUL.md` - behavioral patterns and principles
   - `TOOLS.md` - tool gotchas and usage tips

3. 启用 Hook（可选但推荐）

mkdir -p ~/.openclaw/hooks/self-improvement
cp -r ~/.openclaw/skills/skills/self-improving-agent/hooks/openclaw/* \
  ~/.openclaw/hooks/self-improvement/
openclaw hooks enable self-improvement
openclaw gateway restart

触发记录的场景

你说什么	AI 记录到
“不对，应该是……”	LEARNINGS.md（correction）
“这个过时了”	LEARNINGS.md（knowledge_gap）
“能不能也帮我……”	FEATURE_REQUESTS.md
命令报错	ERRORS.md
“把刚才这个问题记录到 learnings”	手动触发

晋升机制（从临时到永久）

当某条学习足够通用，它应该晋升到永久文件，让 AI 真正变聪明：

LEARNINGS.md 到 AGENTS.md/SOUL.md/TOOLS.md 的晋升路径图

内容类型	晋升到	示例
行为习惯/沟通风格	SOUL.md	“除非特别说明，始终用中文交流”
工作流程/自动化规则	AGENTS.md	“长任务要先拆分子任务”
工具的坑/注意事项	TOOLS.md	“git push 前先配置 SSH”

晋升后把原条目 Status 改为 promoted。

Skill Vetter：安装前的安全审查

ClawHub 上的第三方技能质量参差不齐，skill-vetter 提供了一个安装前的安全审查流程。它会把技能下载到临时目录，查看文件和权限设置，最终给出风险报告，帮助你判断是否值得安装。

使用方式：在对话中说

“用 skill-vetter 帮我审查一下这个 ClawHub 技能再决定要不要装”

常见问题

Q：AI 说"已记录"但文件是空的？

A：AI 可能在对话上下文里"假装"记录了，但没有真正调用文件写入工具。解决：明确要求 AI 用 bash 命令实际执行写入操作。

Q：开启 hook 了但不记录？

A：Hook 只是在 session 开始时注入一条"提醒"，不保证一定记录。确保 AGENTS.md 里有工作流指令 + 模型能力足够。

Q：self-improvement 主要用于编程 Agent 还是聊天 Agent？

A：作者明确说主要给编程 Agent（Claude Code、Codex 等）用，但 OpenClaw 聊天 Agent 也可以用。

参考来源

关联阅读

[[self-improving-agent]]
[[已装可用技能]]
[[OpenClaw安装技能]]

–全文完–

若你有故事想讲、有困惑想聊、或是想找个人说说心里话，甚至只是吐槽发泄一下情绪，都欢迎来找我聊聊：　　　《内容已折叠，点击展开》

希望我写的每一个字，成为我自己和某个人活下去、拼下去的力量。　　　　　　　　　　　　　　　　　　　　　《内容已折叠，点击展开》

“技术终归是工具，而我们一次次认真把问题理顺，守住的其实不只是页面样式和代码输出，还有那一点不愿被混乱打败的心气，是每一个深夜仍愿点灯前行的人。”

转载请注明来自https://oklife.me。