From 37a4d4637b97e31382aa9a63c46461b93777e40d Mon Sep 17 00:00:00 2001 From: weishen Date: Tue, 24 Mar 2026 10:36:44 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E6=B7=BB=E5=8A=A0=20OpenClaw=20Skills?= =?UTF-8?q?=20=E6=9E=B6=E6=9E=84=E4=B8=8E=E5=88=86=E5=B8=83=E7=AC=94?= =?UTF-8?q?=E8=AE=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 梳理三层 Skills 优先级机制 - 整理三个目录的 Skills 表格 - 记录权限规则和规划建议 --- .../xinghui/openclaw-skills-architecture.md | 193 ++++++++++++++++++ 1 file changed, 193 insertions(+) create mode 100644 openclaw/xinghui/openclaw-skills-architecture.md diff --git a/openclaw/xinghui/openclaw-skills-architecture.md b/openclaw/xinghui/openclaw-skills-architecture.md new file mode 100644 index 00000000..39580ca2 --- /dev/null +++ b/openclaw/xinghui/openclaw-skills-architecture.md @@ -0,0 +1,193 @@ +# OpenClaw Skills 架构与分布笔记 + +> 创建时间：2026-03-24 +> 用途：梳理 Skills 分布，规划权限分配 + +--- + +## 一、Skills 目录分布总览 + +OpenClaw 的 Skills 读取遵循**三层优先级**： + +| 层级 | 目录位置 | 作用域 | 优先级 | +|------|----------|--------|--------| +| 1 | `/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 会扫描以下位置： + - `/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 | +| 专属技能 | `/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 特有 | `/skills` | 专属技能 | + +### 5.2 待确认事项 + +1. **是否需要给 xinghui 创建专属 skills 目录？** 目前为 0 +2. **哪些 skills 需要禁用？** 可在配置中统一管理 +3. **Claude Code / Open Code 是否有需要整合的技能？** + +--- + +> 请比利哥审核后告诉我具体分配方案，我来执行调整。