Skills到底怎么装?本地、ClawHub、命令行,三种方式全拆解
关于 OpenClaw Skills 的安装与调用,官方提供了非常灵活的机制,覆盖了从零基础用户到高级开发者的所有场景。核心思路是“命令行手动管理 + 自然语言自动处理”相结合。
以下为你整理的四种主流安装方式及核心调用命令:
🛠️ 核心工具:ClawHub(推荐)
在开始安装前,建议先安装 ClawHub CLI 工具。它是 OpenClaw 的官方技能商店客户端,可以让你方便地搜索、安装和管理来自官方仓库的技能。
npmi-gclawhub# 全局安装clawhub--version# 验证是否成功1. 🛒 从 ClawHub 商店安装
这是官方推荐的主要安装方式,安全便捷,支持版本管理和更新。
| 操作 | 命令 | 说明 |
|---|---|---|
| 搜索技能 | clawhub search <关键词> | 例如clawhub search "calendar" |
| 安装技能 | clawhub install <技能名> | 例如clawhub install tavily-search |
| 安装指定版本 | clawhub install <技能名> --version <版本号> | 用于兼容性需求 |
| 强制覆盖安装 | clawhub install <技能名> --force | 解决安装冲突 |
| 更新所有技能 | clawhub update --all | 批量更新 |
| 查看已安装列表 | clawhub list | 确认安装结果 |
2. 📂 从本地文件/源码安装
如果你从 GitHub 下载了技能源码,或者自己编写了自定义技能,可以通过手动放置或 Git 克隆的方式进行安装。
- 操作方法:将技能文件夹放入 OpenClaw 的工作目录,系统会自动识别。
- Linux / Mac:
~/.openclaw/workspace/skills/ - Windows:
C:\Users\你的用户名\.openclaw\workspace\skills\
- Linux / Mac:
- Git 安装示例:
cd~/.openclaw/workspace/skills# 进入技能目录gitclone https://github.com/用户名/技能库.git ./技能名 - 注意:手动安装完成后,通常需要执行
openclaw gateway restart重启网关才能生效。
3. 💬 自然语言对话安装(最省事)
这是 OpenClaw 最具特色的安装方式。你不需要记忆任何命令,直接告诉 Agent 你要装什么,它会自动完成下载、配置和验证的全流程。
单个安装:
请帮我安装这个 Skill,GitHub 链接是:
https://github.com/xxx/skill-vetter批量安装:
请帮我批量安装以下 3 个 Skills,链接分别是:链接1、链接2、链接3
适用场景:完全的命令行小白,或者懒得去查具体技能名时使用。
4. 🧰 管理内置/已安装技能
无论通过哪种方式安装,你都需要通过openclaw skills命令来管理和调用这些技能。
| 操作 | 命令 | 说明 |
|---|---|---|
| 列出所有技能 | openclaw skills list | 查看系统中已存在的技能 |
| 查看可用技能 | openclaw skills list --eligible | 仅显示满足依赖、可以启用的技能 |
| 启用技能 | openclaw skills enable <技能名> | 安装后通常需要启用 |
| 禁用技能 | openclaw skills disable <技能名> | 临时关闭某个技能 |
| 查看技能详情 | openclaw skills info <技能名> | 查看功能介绍和依赖项 |
| 重启网关 | openclaw gateway restart | 重要:很多变更需要重启才能生效 |
⚠️ 避坑与安全提醒
- 网络问题:国内用户若遇到下载慢或超时,建议配置国内 npm 镜像以加速安装。
npmconfigsetregistry https://registry.npmmirror.com - 安全第一:技能来源复杂,建议首先安装并运行安全审查技能,对新技能进行检查。
clawhubinstallskill-vetter skill-vetter<新技能名称> - 路径问题:确保你的项目路径(Workspace)不包含中文或特殊字符,否则可能导致技能加载失败。
