ClawHub 技能管理完全指南

ClawHub 技能管理完全指南

一文读懂 OpenClaw 技能生态，让你的 AI 助手能力翻倍 🚀

什么是 ClawHub？

ClawHub (https://clawhub.ai) 是 OpenClaw 官方技能注册平台，用于发布、版本管理和搜索基于文本的 Agent 技能（SKILL.md + 配套文件）。

它专为快速浏览和 CLI 友好 API 设计，支持以下功能：

  • 🔍 技能浏览：浏览并渲染 SKILL.md
  • 📤 发布技能：支持更新日志和标签（含 latest）
  • ✏️ 重命名：支持技能重命名而不破坏旧链接
  • 🔀 合并技能：将重复技能合并为规范 slug
  • ⭐ 收藏评论：管理员/版主可以策划和审核技能
  • 🔎 向量搜索：通过嵌入向量搜索而非脆弱的关键词

ClawHub 与 onlycrabs.ai

平台 用途
ClawHub (clawhub.ai) 技能市场 (Skills)
OnlyCrabs (onlycrabs.ai) 灵魂/Soul 市场 (Souls)

Soul 类似于技能的”人格”版本，用于定义 AI 的角色和性格。

技能能做什么？

类别 示例技能 功能
🔍 搜索采集 newsnow 多平台新闻聚合（31个平台）
📧 邮件 imap-smtp-email IMAP/SMTP 邮件收发
☁️ 云存储 cloud-upload-backup 文件上传到云盘
🌤️ 天气 weather 天气预报查询（无需 API Key）
🔎 搜索 multi-search-engine 17 个搜索引擎聚合
📅 日程 qclaw-calendar-guide 日历日程管理
🧠 记忆 memory-lancedb-pro 长期记忆系统
🐙 GitHub github GitHub CLI 集成

ClawHub CLI 命令详解

安装 ClawHub CLI：

1
npm install -g clawhub

认证命令

1
2
3
4
5
# 登录
clawhub login

# 查看当前用户
clawhub whoami

发现技能

1
2
3
4
5
# 向量搜索（推荐）
clawhub search <关键词>

# 浏览探索
clawhub explore

本地安装管理

1
2
3
4
5
6
7
8
9
10
11
# 安装技能
clawhub install <skill-name>

# 卸载技能（只删除本地安装）
clawhub uninstall <skill-name>

# 列出已安装技能
clawhub list

# 更新所有技能
clawhub update --all

查看技能信息

1
2
# 不安装直接查看技能详情
clawhub inspect <skill-name>

发布技能

1
2
3
4
5
# 发布技能到 ClawHub
clawhub publish

# 同步本地更改
clawhub sync

技能管理

1
2
3
4
5
# 重命名技能（保留旧 slug 作为重定向）
clawhub skill rename <old-name> <new-name>

# 合并重复技能
clawhub skill merge <source-skill> <target-skill>

如何使用 ClawHub

方法一：通过 AI 对话触发（推荐）

当你需要某种能力时，直接对 AI 说：

1
帮我找一个能采集小红书内容的技能

AI 会自动帮你：

  1. 在 ClawHub 搜索相关技能
  2. 展示技能功能和安装命令
  3. 询问是否需要安装

方法二：手动浏览 ClawHub

  1. 访问 https://clawhub.ai/skills
  2. 按分类或关键词搜索
  3. 查看技能详情和安装说明

方法三：使用 CLI

1
2
3
4
5
# 搜索技能
clawhub search weather

# 安装技能
clawhub install openclaw/weather

常用技能推荐

1. newsnow - 多平台新闻采集 ⭐⭐⭐⭐⭐

一键采集 31 个平台热榜！

1
2
3
4
5
# 安装
clawhub install iomelons/newsnow

# 使用
"采集微博和知乎的热榜"

支持平台：

  • 综合资讯：微博、知乎、百度、头条、澎湃、联合早报
  • 科技：B站、GitHub、HackerNews、虎嗅、V2EX、掘金、少数派
  • 财经：华尔街见闻、雪球、同花顺、财联社
  • 娱乐：抖音、贴吧、什么值得买、豆瓣、Steam

2. weather - 天气查询 ⭐⭐⭐⭐⭐

无需 API Key 的天气查询：

1
2
3
4
5
# 安装
clawhub install openclaw/weather

# 使用
"今天天气怎么样？"

3. imap-smtp-email - 邮件收发 ⭐⭐⭐⭐

支持 IMAP/SMTP 收发邮件：

1
2
3
4
5
6
# 安装
clawhub install openclaw/imap-smtp-email

# 使用
"帮我查一下有没有新邮件"
"给 xxx@qq.com 发一封邮件"

4. multi-search-engine - 搜索聚合 ⭐⭐⭐⭐

17 个搜索引擎一键切换：

1
2
3
4
5
6
# 安装
clawhub install openclaw/multi-search-engine

# 使用
"用 Google 搜索 OpenClaw"
"用百度查一下最新的 AI 新闻"

5. memory-lancedb-pro - 长期记忆 ⭐⭐⭐⭐⭐

让 AI 记住你们的对话：

1
2
3
4
5
6
7
8
# 安装
clawhub install memory-lancedb-pro@beta

# 功能
- 自动记住你的偏好
- 跨会话记忆
- 向量检索相似记忆
- Weibull 衰减生命周期

6. cloud-upload-backup - 云存储备份 ⭐⭐⭐

文件上传到云盘：

1
2
3
4
5
# 安装
clawhub install openclaw/cloud-upload-backup

# 使用
"把这个文件上传到云盘"

安装技能的方式

方式一：通过 ClawHub CLI

1
2
3
4
5
6
7
8
# 搜索技能
clawhub search <关键词>

# 安装技能
clawhub install <owner/skill-repo>

# 全局安装
clawhub install <owner/skill-repo> -g

方式二：通过 npx skills

1
2
3
4
5
6
7
8
# 搜索技能
npx skills find <关键词>

# 安装技能
npx skills add <owner/repo@skill>

# 全局安装
npx skills add <owner/repo@skill> -g

方式三：通过 OpenClaw 命令

1
2
3
4
5
6
7
8
# 列出可用技能
openclaw skills list

# 安装技能
openclaw plugins install <skill-name>

# 查看技能详情
openclaw skills info <skill-name>

方式四：手动安装

  1. 从 GitHub 克隆技能仓库
  2. 放入 ~/.qclaw/skills/ 目录
  3. 重启 OpenClaw

发布自己的技能到 ClawHub

如果你开发了一个有用的技能，可以发布到 ClawHub：

1. 准备技能文件

一个标准的技能包含：

1
2
3
4
5
my-skill/
├── SKILL.md           # 技能定义（必需）
├── _meta.json         # 元数据
├── scripts/           # 可执行脚本
└── references/        # 参考文档

2. SKILL.md 模板

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
---
name: my-skill
description: |
  技能描述，支持多行。
  说明这个技能能做什么。
  触发词：使用这个技能的关键字
metadata:
  openclaw:
    emoji: "🤖"
---

# 技能名称

这里是技能的详细使用说明...

## 工具

- `tool_name`: 工具描述

## 使用示例

用户说 "xxx" 时执行...

3. Front-matter 元数据

技能可以声明运行时要求：

1
2
3
4
5
6
7
8
9
10
11
12
---
name: my-skill
description: Does a thing with an API.
metadata:
  openclaw:
    requires:
      env:
        - MY_API_KEY
      bins:
        - curl
      primaryEnv: MY_API_KEY
---

4. 发布到 GitHub

1
2
3
4
5
6
# 创建 GitHub 仓库
git init
git add .
git commit -m "Initial commit"
gh repo create my-skill --public
git push origin main

5. 提交到 ClawHub

访问 https://clawhub.com/upload，填写：

  • 技能名称
  • GitHub 仓库地址
  • 简短描述

或者使用 CLI：

1
2
clawhub login
clawhub publish

常见问题

❌ 技能安装失败

检查：

  1. Node.js 版本是否 >= 16
  2. 是否有网络问题
  3. 技能仓库是否存在
  4. GitHub OAuth 是否授权

❌ 技能不生效

解决：

  1. 重启 OpenClaw Gateway
  2. 检查技能是否在 skills 目录
  3. 查看日志：openclaw logs

❌ 不知道技能名称

解决：
直接对 AI 说：「帮我找一个做 xxx 的技能」

❌ 搜索不到想要的技能

解决：
使用向量搜索而非关键词：

1
clawhub search "发送邮件"

进阶技巧

技能别名

支持版本安装：

1
clawhub install owner/skill@v1.0.0

安装 latest 版本：

1
clawhub install owner/skill@latest

禁用遥测

ClawHub 会收集安装统计（计算安装量），可禁用：

1
export CLAWHUB_DISABLE_TELEMETRY=1

Nix 插件支持

ClawHub 支持在 SKILL.md 中声明 Nix 包：

1
2
3
4
5
6
7
8
9
---
name: peekaboo
description: Capture and automate macOS UI with the Peekaboo CLI.
metadata:
  clawdbot:
    nix:
      plugin: "github:clawdbot/nix-steipete-tools?dir=tools/peekaboo"
      systems: ["aarch64-darwin"]
---

总结

操作 命令
登录 clawhub login
搜索技能 clawhub search <关键词>
安装技能 clawhub install <owner/repo>
卸载技能 clawhub uninstall <skill>
查看已安装 clawhub list
更新所有 clawhub update --all
发布技能 clawhub publish

掌握 ClawHub，让你的 OpenClaw 拥有无限可能！🎉

相关链接：

作者：iomelons
博客：https://iomelons.github.io
GitHub：https://github.com/iomelons

技术教程
#OpenClaw #ClawHub #技能管理 #教程
ClawHub 技能管理完全指南
https://iomelons.github.io/2026/03/20/clawhub-skills-guide/
作者
iomelons
发布于
2026年3月20日
许可协议