首页/@admin

OpenClaw Skills 安装与开发教程

龙虾管家
龙虾管家2026年3月22日

完整 Skills 安装指南：第三方 Skills 安装、自定义 Skill 开发、调试技巧、常见问题排查。

title: "安装 Skills" slug: "install-skills" summary: "掌握 ClawHub 在线安装与本地手动安装两种 Skill 安装方式" tags: ["skill", "clawhub", "安装"] category: "Skills 系列" date: "2026-03-11"

安装 Skills

本文聚焦：ClawHub 在线安装 + 本地手动安装

前置知识：创建第一个 Skill

OpenClaw 的强大之处在于 Skills 的可扩展性。掌握 Skill 的安装方式，是高效使用 OpenClaw 的基础。本文将详细介绍两种核心安装方式：通过 ClawHub 在线安装，以及本地手动安装。

知识点 1：ClawHub 在线安装

ClawHub 是 OpenClaw 的官方技能仓库，类似于 npm 对于 Node.js 或 pip 对于 Python 的作用。通过 ClawHub，你可以搜索、安装、更新和发布 Skills。

1.1 安装 ClawHub CLI

首先，你需要安装 ClawHub 的命令行工具：

npm i -g clawhub

安装完成后，验证是否成功：

clawhub --version

1.2 搜索 Skills

在 ClawHub 上有丰富的社区 Skills。使用 search 命令查找你需要的技能：

# 搜索与数据库相关的技能
clawhub search "postgres"

# 搜索与 GitHub 相关的技能
clawhub search "github"

# 模糊搜索
clawhub search "backup"

搜索结果会显示技能名称、版本、描述等信息，帮助你选择合适的 Skill。

1.3 安装 Skills

找到需要的 Skill 后，使用 install 命令安装：

# 安装最新版本
clawhub install my-skill

# 安装指定版本
clawhub install my-skill --version 1.2.3

# 指定安装目录（默认在当前目录的 ./skills 文件夹）
clawhub install my-skill --dir ./my-skills

安装完成后，Skill 会出现在指定的目录中，包含 SKILL.md 文件和相关脚本。

1.4 更新 Skills

ClawHub 提供了强大的更新机制，基于文件哈希匹配来检测变更：

# 更新指定 Skill 到最新版本
clawhub update my-skill

# 更新到指定版本
clawhub update my-skill --version 1.2.3

# 强制更新（忽略本地修改）
clawhub update my-skill --force

# 更新所有已安装的 Skills
clawhub update --all

# 无人值守模式（CI/CD 场景）
clawhub update --all --no-input --force

1.5 列出已安装的 Skills

查看当前目录下已安装的所有 Skills：

clawhub list

1.6 高级配置

ClawHub 支持通过环境变量进行配置：

# 使用私有 Registry
export CLAWHUB_REGISTRY=https://my-registry.com

# 设置默认工作目录
export CLAWHUB_WORKDIR=/path/to/skills

# 命令行参数覆盖
clawhub install my-skill --registry https://my-registry.com --workdir /custom/path

1.7 发布自己的 Skills

如果你开发了新的 Skill，可以通过 ClawHub 分享给社区：

# 登录（只需一次）
clawhub login

# 验证登录状态
clawhub whoami

# 发布 Skill
clawhub publish ./my-skill \
  --slug my-skill \
  --name "My Awesome Skill" \
  --version 1.0.0 \
  --changelog "Initial release"

知识点 2：本地手动安装

有时候你需要安装尚未发布到 ClawHub 的 Skill，或者需要对 Skill 进行定制修改。这时可以使用本地手动安装。

2.1 从 Git 仓库安装

直接从 Git 仓库克隆 Skill 是最常见的手动安装方式：

# 进入你的 OpenClaw 工作目录
cd /path/to/clawd

# 创建 skills 目录（如果不存在）
mkdir -p skills

# 克隆 Skill 仓库
git clone https://github.com/username/my-skill.git skills/my-skill

2.2 从本地文件安装

如果你已经下载了 Skill 的压缩包或文件夹：

# 解压到 skills 目录
unzip my-skill.zip -d skills/

# 或者复制本地文件夹
cp -r /path/to/my-skill skills/

2.3 Skill 目录结构验证

手动安装后，验证 Skill 目录结构是否正确：

# 检查 SKILL.md 是否存在
ls skills/my-skill/SKILL.md

# 标准的 Skill 结构应该包含：
# my-skill/
# ├── SKILL.md          # 技能定义和使用说明
# ├── references/       # 参考资料（可选）
# └── scripts/          # 辅助脚本（可选）

2.4 手动安装的注意事项

手动安装的 Skills 不会被 clawhub list 识别，也不会被 clawhub update 管理。你需要自行维护：

# 手动更新：进入 Skill 目录拉取最新代码
cd skills/my-skill
git pull origin main

# 或者重新克隆
cd ../..
rm -rf skills/my-skill
git clone https://github.com/username/my-skill.git skills/my-skill

2.5 本地开发中的 Skill

如果你在开发新的 Skill，可以创建符号链接方便测试：

# 假设你的 Skill 源码在另一个目录
ln -s /path/to/my-skill-dev skills/my-skill

# 这样修改源码会实时反映到 OpenClaw 中

实践建议

选择合适的安装方式

场景推荐方式原因
使用社区 SkillsClawHub 安装版本管理、自动更新
使用私有/内部 Skills本地手动安装无需发布到公开仓库
Skill 开发测试本地手动 + 符号链接实时修改、快速迭代
需要定制修改本地手动安装可以修改源码
CI/CD 自动化ClawHub + --no-input可脚本化、确定性

版本锁定策略

生产环境建议锁定 Skill 版本，避免意外更新导致行为变化：

# 在项目中记录依赖版本
echo "my-skill@1.2.3" > .clawhub-dependencies

# 安装时指定版本
clawhub install my-skill --version 1.2.3

混合使用两种模式

你可以同时使用两种方式：

skills/
├── github-ops/          # ClawHub 安装（自动管理）
├── postgres-backup/     # ClawHub 安装（自动管理）
└── my-custom-skill/     # 手动安装（自行维护）

备份与迁移

迁移 OpenClaw 环境时，Skills 的处理方式：

# 导出已安装的 Skills 列表
clawhub list > skills-backup.txt

# 在新环境重新安装
while read skill; do
  clawhub install "$skill"
done < skills-backup.txt

# 手动安装的 Skills 需要单独备份
tar -czf custom-skills.tar.gz skills/my-custom-skill/

安全注意事项

  1. 审查手动安装的 Skills：从第三方仓库克隆的 Skill，务必先阅读 SKILL.md 和源码，确认没有恶意操作
  2. 最小权限原则：检查 Skill 是否需要不必要的权限（如访问敏感文件、执行系统命令）
  3. 定期更新：ClawHub 安装的 Skills 会收到安全更新，建议定期运行 clawhub update --all

相关阅读

掌握这两种安装方式后，你就可以灵活地扩展 OpenClaw 的能力了。无论是使用社区贡献的 Skills，还是开发维护私有 Skills，都能得心应手。

💡 需要帮助？

如果你在安装或使用 OpenClaw 时遇到问题，或者需要企业级部署方案，我可以帮你：

🎯 服务选项

服务价格说明
1 对 1 咨询¥500/小时远程指导安装、配置、Skills 开发
企业部署¥5000 起私有化部署、定制集成、员工培训
定制 Skills面议根据你的业务需求开发专属技能
付费社群¥199/年持续更新教程 + 专属问答群 + 案例分享

📬 联系方式

  • 邮箱：admin@useclaw.net
  • Telegram：@fengguo1990
  • 微信：fengguo1990（备注 OpenClaw）

🐾 免费资源：所有基础教程在 useclaw.net 免费查看，遇到问题再来找我！

#OpenClaw#Skills#开发教程#自动化