实用 Skills：选型、安装、覆盖、最佳实践（含 Obsidian / Web / Browser）

本章目标：把 Skills 当作“可复用的操作手册 + 工具契约”，建立一套稳定的选型与维护方法，而不是“装一堆然后靠运气”。

1) Skills 的加载优先级（非常重要）

同名 skill 的覆盖顺序通常是：

1. <workspace>/skills（项目/工作区私有，优先级最高）

2. ~/.openclaw/skills（managed skills，共享）

3. bundled（随安装自带）

落地建议：

• 团队/项目专属技能：放 workspace（可进 Git）

• 个人常用通用技能：放 managed

• bundled 当“系统库”，不要直接改

2) Skills 管理常用命令

openclaw skills list
openclaw skills list --eligible
openclaw skills info <name>
openclaw skills check

推荐每次装/改 skill 后跑一次：

openclaw skills check

3) 选型原则（从“能做”到“稳定做”）

3.1 按输入输出与副作用分类

• 纯文本：改写/总结/结构化

• 读：读取文件、web_fetch、搜索

• 写：写文件、提交代码、发消息

• 执行：shell / API / 浏览器操作

副作用越大，越要：

• 加 allowlist（目标域名/仓库/目录）

• 加确认步骤（先计划后执行）

• 保留审计日志（输出到固定目录）

3.2 先把“基础三件套”跑通

1. web_search（检索）

2. web_fetch（抓取）

3. exec（在 workspace 内做整理/生成）

然后再引入：

• browser（自动登录/JS 站点）

• obsidian（沉淀知识库）

4) ClawHub：安装与更新的常见工作流

• 搜索技能 → 安装到 workspace 的 ./skills → 重启会话刷新列表

（具体命令以你当前版本的 CLI 为准，原则是：把 skill 作为仓库依赖管理。）

5) 典型实用 Skill 落地

5.1 Web：search + fetch + 摘要

目标：给定主题 → 搜索 → 抓取 → 生成结构化输出。

建议的输出结构（保存到 workspace）：

• research/<topic>/<date>/sources.json

• research/<topic>/<date>/brief.md

5.2 Browser：处理登录与动态页面

适用：

• 需要登录态

• 内容由 JS 渲染

• 需要模拟点击/滚动

安全建议：

• 只允许访问白名单域名

• 不要把浏览器控制暴露在公网入口

5.3 Obsidian：把产出沉淀成“可检索资产”

常见模式：

• IM 对话 → 每日总结 → 写入 Daily Note

• 新闻/漏洞/产品跟踪 → 生成“卡片”笔记 → 自动加标签与索引

依赖：通常需要 obsidian-cli。

6) 最常见的“技能写不好”原因

• SKILL.md 写成“说明文”，没有明确步骤、输入、输出

• 缺少边界条件：允许访问什么、允许写到哪里、需要哪些 key

• 不可复现：缺少示例命令与样例输入

建议模板：

• 目标

• 前置条件

• 允许的动作（白名单）

• 标准流程（Step 1/2/3）

• 失败与回退策略

• 输出位置与命名规范

---

返回目录