# OpenClaw Skills 架构与分布笔记

> 创建时间：2026-03-24
> 用途：梳理 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` | 1 | proactive-agent-lite |
| 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` 配置 | 取决于配置 |

---

## 四、Claude Code / Open Code 的 Skills

> 注意：这两个是外部编程工具，不属于 OpenClaw 体系

| 工具 | 默认 Skills 位置 | 备注 |
|------|------------------|------|
| Claude Code | `~/.codex/skills` | 需要单独安装 |
| Open Code | 取决于安装方式 | 需要单独安装 |

当前系统未检测到这两款工具的安装。

---

## 五、规划建议（待审核）

### 5.1 初步建议

| 分类 | 建议存放位置 | 说明 |
|------|--------------|------|
| 飞书系列 | `~/.openclaw/skills` (共享) | 所有 Agent 可能用到 |
| Apple 生态 | `~/.openclaw/skills` (共享) | macOS 通用的 |
| 密码/安全 | `~/.openclaw/skills` (共享) | 通用工具 |
| Agent 特有 | `<workspace>/skills` | 专属技能 |

### 5.2 待确认事项

1. **是否需要给 xinghui 创建专属 skills 目录？** 目前为 0
2. **哪些 skills 需要禁用？** 可在配置中统一管理
3. **Claude Code / Open Code 是否有需要整合的技能？**

---

> 请比利哥审核后告诉我具体分配方案，我来执行调整。
