选择模板（推荐入门路径）

1. 将完整 Skill 目录上传到服务器 userFile/skill/template/{技能名}/（需含 SKILL.md）。
2. 在模板卡片中点击任意 Skill 应用到画布。
3. 若画布已有内容，确认覆盖后即可加载完整节点、连线与文件包。
4. 更多模板：点 全部模板… → 搜索 → 点「应用到画布」。

模板只是起点；编辑后点「打包下载 SKILL」导出 ZIP 到本机。

编辑工作流

1. 必须有一个 Skill 元信息 节点：填写 name（小写+连字符）与 description。
2. 用连线串联：元信息 → 触发条件 → 指令步骤 → 工具 → 约束/示例。
3. 需要脚本或文档时，添加「脚本文件 / 参考文档 / 资源文件」节点。
4. 工具节点请从下拉列表选择 OpenClaw 内置工具，并查看右侧工具说明。

快捷键：Delete 删除选中节点/连线；Esc 取消连线。

打包下载 SKILL

1. 确认画布上有「Skill 元信息」节点（name + description）。
2. 如需持久化编辑结果，先点 保存工作流。
3. 点击 打包下载 SKILL。系统会：
   • 合并工作流节点与技能包文件；
   • 若来自案例模板，会先并入模板文件再覆盖同名修改；
   • 自动打成 {skill-name}.zip 并下载到本机。

不会写入服务器 userFile；模板目录也不会被修改。

部署到自己的 OpenClaw

下载 ZIP 后解压，把技能整个文件夹放到 OpenClaw 可发现的 skills 根目录（文件夹内需有 SKILL.md）：

范围	路径	说明
工作区（推荐）	<workspace>/skills/<skill-name>/	仅当前工作区可见，优先级高
全局	~/.openclaw/skills/<skill-name>/	本机所有 agent 可见
个人 agents	~/.agents/skills/<skill-name>/	跨项目个人技能

方式 A：手动拷贝

# 1) 从服务器下载生成目录（示例）
scp -r user@server:/www/wwwroot/wp.aiprocode.com/userFile/0/<时间戳>/<skill-name> ./

# 2) 安装到工作区
mkdir -p ~/.openclaw/workspace/skills
cp -R ./<skill-name> ~/.openclaw/workspace/skills/

# 或安装到全局
mkdir -p ~/.openclaw/skills
cp -R ./<skill-name> ~/.openclaw/skills/

方式 B：OpenClaw / ClawHub CLI

# 安装本地目录为 skill
openclaw skills install ./<skill-name> --as <skill-name>

# 或全局
openclaw skills install ./<skill-name> --global

# 查看是否加载
openclaw skills list

方式 C：配置额外目录（可选）

// ~/.openclaw/openclaw.json
{
  "skills": {
    "load": {
      "extraDirs": ["~/Projects/my-skills"]
    }
  }
}

确保 extraDirs 下每个子目录都包含 SKILL.md。

验证与排错

1. 执行 openclaw skills list，确认 name 与 description 出现。
2. 新开会话（如聊天里 /new）或重启 gateway，让技能快照刷新。
3. 用自然语言触发，或 /skill <name> 显式调用。
4. 若依赖 bins/env：在「依赖门控」节点声明，并保证本机 PATH / 环境变量齐全。
5. 社区 skill 安装前建议先用 Skill Vetter 类能力做安全审查。

常见问题

• 看不到 skill：路径不对、未新开会话、name 不合法（需小写字母/数字/连字符）。
• 工具不可用：被 tools.allow/deny、沙箱或插件未启用过滤。
• 脚本不能跑：检查 scripts/ 可执行权限与 {baseDir} 引用。

官方文档：Skills · Creating skills