# 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`      | 专属技能          |