169 lines
7.7 KiB
Markdown
169 lines
7.7 KiB
Markdown
# OpenClaw Skills 架构与分布笔记
|
||
|
||
#openclaw #skills
|
||
## 一、Skills 目录分布总览
|
||
|
||
OpenClaw 的 Skills 读取遵循**三层优先级**：
|
||
|
||
| 层级 | 目录位置 | 作用域 | 优先级 |
|
||
| --- | -------------------- | ----------- | ------ |
|
||
| 1 | `<workspace>/skills` | 单个 Agent 专属 | **最高** |
|
||
| 2 | `~/.openclaw/skills` | 所有 Agent 共享 | 中 |
|
||
| 3 | Bundled (安装包自带) | 所有 Agent | 最低 |
|
||
|
||
**覆盖规则**：高优先级目录中的同名 Skill 会覆盖低优先级的版本。
|
||
|
||
---
|
||
|
||
## 二、当前 Skills 分布表格
|
||
|
||
### 1. ~/.agents/skills（Agent 通用技能库）
|
||
|
||
> 作用：所有 Agent 可访问的共享技能库
|
||
> 数量：56 个
|
||
|
||
| 序号 | Skill 名称 | 用途分类 |
|
||
| --- | -------------------------------- | ---------------- |
|
||
| 1 | 1password-1.0.1 | 密码管理 |
|
||
| 2 | a-stock-analysis-1.0.0 | 股票分析 |
|
||
| 3 | agent-self-reflection-1.0.0 | 自我反思 |
|
||
| 4 | aminer-open-academic-1.0.5 | 学术研究 |
|
||
| 5 | architecture-designer-0.1.0 | 架构设计 |
|
||
| 6 | autoglm-browser-agent | 浏览器自动化 |
|
||
| 7 | autoglm-deepresearch | 深度研究 |
|
||
| 8 | autoglm-generate-image | AI 生图 |
|
||
| 9 | autoglm-open-link | 链接处理 |
|
||
| 10 | autoglm-search-image | 图片搜索 |
|
||
| 11 | autoglm-websearch | Web 搜索 |
|
||
| 12 | automation-workflows-0.1.0 | 自动化工作流 |
|
||
| 13 | backtest-expert-0.1.0 | 回测专家 |
|
||
| 14 | blog-writer-0.1.0 | 博客写作 |
|
||
| 15 | brainstorming-0.1.0 | 头脑风暴 |
|
||
| 16 | clawdefender-1 | 安全审计 |
|
||
| 17 | code-1.0.4 | 编程开发 |
|
||
| 18 | content-strategy-0.1.0 | 内容策略 |
|
||
| 19 | copywriting-0.1.0 | 文案撰写 |
|
||
| 20 | debug-pro-1.0.0 | 调试专家 |
|
||
| 21 | executing-plans-0.1.0 | 执行计划 |
|
||
| 22 | feishu-chat-history | 飞书群聊历史 |
|
||
| 23 | feishu-cron-reminder | 飞书定时提醒 |
|
||
| 24 | feishu-doc-1.2.7 | 飞书文档 |
|
||
| 25 | feishu-drive-1.0.0 | 飞书网盘 |
|
||
| 26 | feishu-perm | 飞书权限管理 |
|
||
| 27 | feishu-screenshot | 飞书截图 |
|
||
| 28 | feishu-send-file | 飞书发文件 |
|
||
| 29 | ffmpeg-video-editor-1.0.0 | 视频编辑 |
|
||
| 30 | find-skills | 技能发现 |
|
||
| 31 | frontend-design-3-0.1.0 | 前端设计 |
|
||
| 32 | git-essentials-1.0.0 | Git 版本控制 |
|
||
| 33 | gog | Google Workspace |
|
||
| 34 | interview-designer-1.0.0 | 面试设计 |
|
||
| 35 | market-research-1.0.0 | 市场调研 |
|
||
| 36 | memory-1.0.2 | 记忆系统 |
|
||
| 37 | obsidian-ontology-sync-1.0.1 | Obsidian 同步 |
|
||
| 38 | ontology | 知识图谱 |
|
||
| 39 | opencode-controller-1.0.0 | OpenCode 控制 |
|
||
| 40 | research-paper-writer-0.1.0 | 论文写作 |
|
||
| 41 | security-auditor-1.0.0 | 安全审计 |
|
||
| 42 | self-improving-1.1.3 | 自我改进 |
|
||
| 43 | seo-1.0.3 | SEO 优化 |
|
||
| 44 | seo-content-writer-2.0.0 | SEO 内容写作 |
|
||
| 45 | session-logs-1.0.0 | 会话日志 |
|
||
| 46 | skill-creator-0.1.0 | 技能创建 |
|
||
| 47 | skill-vetter-1.0.0 | 技能安全审查 |
|
||
| 48 | social-content-generator-0.1.0 | 社交内容生成 |
|
||
| 49 | social-media-scheduler-1.0.0 | 社交媒体排期 |
|
||
| 50 | supabase-postgres-best-practices | Postgres 最佳实践 |
|
||
| 51 | test-runner-1.0.0 | 测试运行 |
|
||
| 52 | tmux-1.0.0 | Tmux 会话管理 |
|
||
| 53 | ui-ux-pro-max-0.1.0 | UI/UX 设计 |
|
||
| 54 | video-frames-1.0.0 | 视频帧提取 |
|
||
| 55 | writing-plans-0.1.0 | 写作规划 |
|
||
| 56 | autoglm-* (5个) | Chrome 扩展相关 |
|
||
|
||
---
|
||
|
||
### 2. ~/.openclaw/skills（OpenClaw 内置技能）
|
||
|
||
> 作用：OpenClaw 官方维护的技能，所有 Agent 可用
|
||
> 数量：17 个
|
||
|
||
| 序号 | Skill 名称 | 用途分类 |
|
||
| --- | ---------------------- | ---------------- |
|
||
| 1 | 1password | 密码管理 |
|
||
| 2 | accli | Apple Calendar |
|
||
| 3 | agent-browser-clawdbot | 浏览器自动化 |
|
||
| 4 | apple-notes | Apple Notes |
|
||
| 5 | apple-reminders | Apple Reminders |
|
||
| 6 | docker | Docker 容器管理 |
|
||
| 7 | gog | Google Workspace |
|
||
| 8 | ontology | 知识图谱 |
|
||
| 9 | openclaw-tavily-search | Tavily 搜索 |
|
||
| 10 | opencode-controller | OpenCode 控制 |
|
||
| 11 | opencode-omo | OpenCode OMO 模式 |
|
||
| 12 | powerpoint-pptx | PPT 制作 |
|
||
| 13 | proactive-agent-lite | 主动式 Agent |
|
||
| 14 | self-improving-agent | 自我改进 |
|
||
| 15 | skill-creator-2 | 技能创建 v2 |
|
||
| 16 | summarize | 内容摘要 |
|
||
| 17 | task-summary | 任务总结 |
|
||
|
||
---
|
||
|
||
### 3. Workspace Skills（各 Agent 专属）
|
||
|
||
> 作用：单个 Agent 独有的技能，仅该 Agent 可访问
|
||
|
||
| Agent | 目录 | Skills 数量 | 具体技能 |
|
||
| --------- | ---------------------------------------------- | --------- | ---- |
|
||
| xinghui | `~/.openclaw/workspace-agent-xinghui/skills` | 0 | (暂无) |
|
||
| xingjiang | `~/.openclaw/workspace-agent-xingjiang/skills` | 0 | (暂无) |
|
||
| xingyao | `~/.openclaw/workspace-agent-xingyao/skills` | 0 | (暂无) |
|
||
|
||
---
|
||
|
||
## 三、Skills 权限机制详解
|
||
|
||
### 3.1 读取规则
|
||
|
||
1. **Agent 启动时**，OpenClaw 会扫描以下位置：
|
||
- `<workspace>/skills`（如有）
|
||
- `~/.openclaw/skills`
|
||
- Bundled skills（安装包自带）
|
||
|
||
2. **同名冲突时**：workspace 覆盖 managed，managed 覆盖 bundled
|
||
|
||
3. **配置文件控制**：可在 `~/.openclaw/openclaw.json` 中精细控制：
|
||
```json5
|
||
{
|
||
skills: {
|
||
entries: {
|
||
"某个skill": { enabled: false },
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
### 3.2 共享 vs 专属
|
||
|
||
| 类型 | 存放位置 | 可见范围 |
|
||
|------|----------|----------|
|
||
| 共享技能 | `~/.openclaw/skills` | 所有 Agent |
|
||
| 专属技能 | `<workspace>/skills` | 仅该 Agent |
|
||
| 额外目录 | `skills.load.extraDirs` 配置 | 取决于配置 |
|
||
|
||
|
||
---
|
||
|
||
## 五、规划建议（待审核）
|
||
|
||
### 5.1 初步建议
|
||
|
||
| 分类 | 建议存放位置 | 说明 |
|
||
| -------- | ------------------------- | ------------- |
|
||
| 飞书系列 | `~/.openclaw/skills` (共享) | 所有 Agent 可能用到 |
|
||
| Apple 生态 | `~/.openclaw/skills` (共享) | macOS 通用的 |
|
||
| 密码/安全 | `~/.openclaw/skills` (共享) | 通用工具 |
|
||
| Agent 特有 | `<workspace>/skills` | 专属技能 |
|
||
|