本指南仅依据已读取的 OpenClaw 官方文档编写,未在任何客户端实机安装或运行,actuallyTested=false。Skills-SI 的具体下载页、包内容、作者与许可未核实;须逐包检查,不应认为本站下载包自动经过 ClawHub 扫描。CLI 命令以当前官方文档为据,具体 Gateway、agent、工作区及版本配置可能不同。Skill 是 agent 指令目录,并不自动提供它调用的工具或外部依赖;MCP 不等同于 Skill。
준비
- 已有可用的 OpenClaw Gateway 和配置好的 agent;此指南不包含登录、配置密钥或安装 OpenClaw。
- 确认当前操作对应的 agent 工作区与目标范围:默认安装落在活动工作区的 skills/;--global 是共享托管目录。不同 agent/工作区可能看到不同技能。
- 如果尚未安装 OpenClaw,官方入门页列出的运行环境为 Node.js 24.16+ 或 26.1+;无需为本指南填写或分享账号、密码、API 密钥。
- 准备 Skills-SI 下载包;先检查完整目录中的 SKILL.md、引用文件、脚本及外部依赖。仅有 SKILL.md 而缺少其引用资源的包不应视作完整。
설치 및 사용 단계
- 01
1. 准备并确认范围
确认 Gateway 可用,并选定目标 agent。运行技能清单检查已有名称,避免覆盖同名目录;工作区技能仅对相应工作区可见,共享托管目录面向使用该 state 的 agents。OpenClaw 原生 Skills 是写明 agent 工作流程的目录包;不要把 MCP 服务或自定义指令称作 Skill。
openclaw skills list근거와 출처SKILL.md + resources작동 확인흐름/폴더 설명도이며 공식 화면이 아닙니다. - 02
2. 从本站安全下载并检查完整目录
在 Skills-SI 对应条目下载作者提供的完整技能包;下载链接、具体文件名和本站页面路径本指南未核实,不猜测。若是 ZIP,先用系统文件管理器解压;OpenClaw 的本地安装命令接受含 SKILL.md 的目录,不接受 ZIP 路径。找到 SKILL.md 所在的真实技能根目录,连同其 references、examples、scripts、assets 等被引用文件一并保留。阅读说明与脚本内容,核对作者、许可、联网/API/二进制依赖;有疑点就停止,不运行脚本,也不关闭防护。
本站实际下载位置由用户选择;准确路径未核实,留空。无需命令;解压后检查技能根目录及所有随附文件。근거와 출처本站实际下载位置由用户选择;准确路径未核实,留空。작동 확인흐름/폴더 설명도이며 공식 화면이 아닙니다. - 03
3. 安装本地 Skill
确认技能根目录内的 SKILL.md 位于根部后,用官方 CLI 从本地目录安装。按实际路径和 SKILL.md 的 name 替换占位符;不要把 ZIP 路径传给命令。安装默认进入活动工作区 skills/;--global 会改为共享托管目录,不能与 --agent 同用。此处只给官方支持命令,本轮未执行。
<技能目录> 为用户解压后确认的本地目录;安装目标为所选工作区的 skills/,实际工作区路径未预设。openclaw skills install ./<技能目录> --as <技能名称>근거와 출처<技能目录> 为用户解压后确认的本地目录;安装目标为所选工作区的 skills/,实际工作区路径未预设。작동 확인흐름/폴더 설명도이며 공식 화면이 아닙니다. - 04
4. 调用并完成第一项虚构练习
在目标 agent 的对话中用已核实的 frontmatter name 显式调用 /skill <技能名称>。第一练习可用合成会议记录:“虚构会议:林青负责周五前整理样稿;陈禾下周一核对清单。请提取行动项、负责人和期限;不确定处标注待确认。”只用虚构数据,不贴真实客户资料、秘密或凭据。
在 OpenClaw 对话中输入:/skill <技能名称>,随后提交上述虚构会议练习。근거와 출처SKILL.md + resources작동 확인흐름/폴더 설명도이며 공식 화면이 아닙니다. - 05
5. 验证加载与结果
在 CLI 检查清单和依赖状态,并在对话里确认 agent 实际按技能要求完成练习。若 SKILL.md 更新后旧会话尚未刷新,官方文档建议开启新会话;watcher 未启用时需新会话或重启 Gateway。清单可见不等于外部依赖已配置,也不代表输出正确,仍要人工核对。
openclaw skills list;openclaw skills check근거와 출처SKILL.md + resources작동 확인흐름/폴더 설명도이며 공식 화면이 아닙니다. - 06
6. 禁用或卸载
本地目录技能可从它所属 agent 工作区的 skills/ 中移除对应技能目录;先核对确切目录名并备份,勿删除整个 skills/。文件监视默认会在后续 agent 回合反映移除;若 watcher 关闭则开启新会话。若安装来源是 ClawHub,应使用 ClawHub CLI 在原安装范围卸载;不要用 ClawHub 卸载命令处理普通本地目录。
目标 agent 的 <workspace>/skills/<技能目录>(具体 workspace 路径因配置而异);共享安装位置须按原安装范围处理。本地目录:在确认的目标工作区中移除该技能目录。ClawHub 跟踪安装:clawhub uninstall @<作者>/<技能名>근거와 출처目标 agent 的 <workspace>/skills/<技能目录>(具体 workspace 路径因配置而异);共享安装位置须按原安装范围处理。작동 확인흐름/폴더 설명도이며 공식 화면이 아닙니다.
연습 및 검수
用两条虚构会议行动项,要求 Skill 输出事项、负责人、期限与待确认点;人工核对是否遵循技能说明。
- 运行 openclaw skills list,确认目标技能出现在选定 Gateway/agent 的技能清单。
- 运行 openclaw skills check,查看就绪状态和缺失前置条件。
- 在目标 agent 对话中显式调用技能并执行虚构练习;检查格式、依据及待确认标注,不能只凭清单显示认定成功。
- 若修改后旧会话未刷新,开启新会话;watcher 未启用时按官方说明重启 Gateway 或新建会话。
비활성화 및 삭제
- 本地目录安装:先确认目标 agent 的实际工作区,再备份并仅移除其中对应技能目录;默认本地安装目标是该工作区的 skills/,不要删除整个目录。
- ClawHub 跟踪安装:在与原安装相同的工作区或共享 state 范围使用 clawhub uninstall @<作者>/<技能名>;CLI 会在删除目录及 lock 文件前要求确认。
- 在后续 agent 回合或新会话确认技能不再加载;共享个人技能库属于不同管理机制,使用其对应的禁用/移除操作,不要混用本地目录卸载步骤。
문제 해결
openclaw skills install 报找不到 SKILL.md 或来源不合法。
确认 ZIP 已解压,并定位到 SKILL.md 位于根部的具体技能目录;本地安装不接受 ZIP/archive 路径。目录不完整时重新从原作者/本站条目取得完整包,不要猜路径。
安装后 openclaw skills list 看不到技能。
核对安装所选的 Gateway、agent 和工作区;默认目录安装针对活动工作区,--global 是共享托管目录。查看实际 SKILL.md 的 name;必要时开启新会话。
技能显示但不能使用,或 openclaw skills check 报缺依赖。
按 SKILL.md frontmatter 和内容确认 requires.bins、requires.env、requires.config、操作系统限制及外部依赖;只配置所需且可信的依赖,不把密钥贴进对话,也不关闭安全策略。
同名技能加载了别的版本,或练习结果未遵循预期。
用 openclaw skills info <名称> 检查名称对应项,核对工作区/项目/托管来源优先级与冲突;移除或改名不需要的冲突副本,重新开会话后用合成输入复测。
근거와 출처
- https://docs.openclaw.ai/tools
官方区分 tools、skills 与 plugins:Skill 是加载到 agent prompt 的 SKILL.md 指令包;Skills 与 MCP/插件不是同一机制。
- https://docs.openclaw.ai/tools/skills
官方列出技能目录的加载来源及优先级、按 agent/工作区的范围、SKILL.md 发现、watcher 与新会话刷新行为。
- https://docs.openclaw.ai/cli/skills
官方 CLI 文档说明本地目录安装语法、安装默认目标、--global/--agent 范围、ZIP 不支持,以及 ClawHub 跟踪技能卸载流程和信任警告。
- https://docs.openclaw.ai/tools/creating-skills
官方说明每个 Skill 是含 SKILL.md 的目录,包含元数据、/skill 显式调用及依赖门控字段。
- https://docs.openclaw.ai/start/getting-started
官方入门文档列出新装 OpenClaw 的 Node.js 运行时要求和 Gateway 基础状态检查方法。
- https://docs.openclaw.ai/gateway/security
官方安全指南指向信任边界、提示注入、安全审计和不受信任内容处理等安全措施。