GetSkill

何时使用此 Skill

当你需要以下功能时使用此 skill：

• - 从 getskill.work 仓库搜索 OpenClaw 技能
• 向 OpenClaw 环境安装新技能
• 更新现有技能到最新版本
• 管理 ~/.openclaw/skills 目录中的技能文件
• 为技能仓库配置自定义 API 端点

指令

OpenClaw 首次启动：先安装 getskill CLI

当 OpenClaw 首次启动且尚未安装 getskill CLI 时，按以下流程执行：

1. 1. 先测试 getskill 是否可用：

1. 2. 如果不可用，安装 CLI（任选其一）：

或
bash
npm i -g @workskills/getskill

1. 3. 安装完成后即可运行 getskill 命令：

搜索技能

1. 1. 使用搜索命令并传入关键词：

1. 2. 工具查询 API 并返回匹配的技能，包含：

安装技能

1. 1. 首先确保系统已安装 Git（如未安装，工具会引导安装）

1. 2. 运行安装命令：

1. 3. 工具执行以下操作：

更新技能

1. 1. 运行更新命令：

1. 2. 工具会：

列出本地技能

bash
getskill list

返回 skills 目录中当前所有技能目录名称。

查看目录路径

bash
getskill path

显示：

• - 技能目录：~/.openclaw/skills
• 缓存目录：~/.openclaw/skills-cache

配置 API 端点

查看当前端点：
bash
getskill config get

设置自定义端点：
bash
getskill config set https://your-custom-api.com

清理缓存

bash
getskill clean

移除所有 Git 仓库缓存，不影响已安装的技能。

示例

搜索示例

输入： 用户想查找与 commit 相关的技能

命令：
bash
getskill search commit

输出：

找到 3 个技能：

1. 1. commit-helper

安装示例

输入： 用户想安装 commit-helper 技能

命令：
bash
getskill install commit-helper

操作：

1. 1. git clone 到 ~/.openclaw/skills-cache/commit-helper
2. 复制整个目录到 ~/.openclaw/skills/commit-helper

输出：

技能已安装到 skills 目录:
- ~/.openclaw/skills/commit-helper

更新示例

输入： 用户想更新已有技能

命令：
bash
getskill update commit-helper

操作：

1. 1. cd ~/.openclaw/skills-cache/commit-helper
2. git pull
3. 重新复制技能目录到 skills 目录

边缘情况

Git 未安装

场景： 用户在没有 Git 的系统上运行 install/update 命令

处理：

• - Windows：自动下载 Git 安装程序并启动安装向导
• macOS：提示通过 Homebrew 安装（brew install git）
• Linux：提供包管理器命令（apt-get、yum、dnf、pacman）

技能未找到

场景： API 返回 404 表示请求的技能不存在

处理： 显示清晰的错误信息：技能不存在: {skill-name}

仓库无技能文件

场景： 克隆的仓库中不包含技能 .md 文件（除 README 外）

处理： 抛出错误：在仓库中未找到技能 .md 文件

网络错误

场景： 由于网络问题导致 API 请求失败

处理：

• - 主机未找到：无法连接到服务器，请检查网络或 API 地址配置
• 超时：请求超时，请稍后重试
• 连接被拒绝：服务器拒绝连接，请检查 API 地址是否正确

技能名称重复

场景： 仓库中有多个名称相似的 .md 文件

处理： 将技能目录整体复制到 skills 目录（排除 .git）

关键规则

• - 在执行 clone/pull 操作前始终验证 Git 安装
• 复制整个技能目录到 skills/<技能名>，并排除 .git 目录
• 清理时绝不删除 skills 目录内容 - 只移除缓存
• 支持通过环境变量 GETSKILLBASEURL 使用自定义端点
• 自动处理 API 重定向（最多 5 次）
• API 请求 60 秒后超时
• 如果目录不存在则递归创建
• 搜索失败时返回空数组（而不是抛出异常）以防止程序崩溃
• 在调用 API 前验证所有用户输入