[智能体-634]：OpenClaw 通过 ClawHub 新增扩展技能完整教程

一、基础概念区分

1. Built-in 内置技能：内核自带（web_search/web_fetch/browser/calculator等），无需安装，开箱即用；
2. ClawHub（官方技能商店）：社区第三方扩展技能仓库，所有额外功能（天气、PDF 解析、Git、企业微信、BrowserRelay 插件等）都要从这里安装；
3. 安装后属于外部扩展 Skill，和内置技能分开管理，重启网关即可生效。

二、前置环境校验（必须先做）

1. 确认 OpenClaw CLI 可用

bash

运行

openclaw --version

输出版本号代表正常；无命令需重装 OpenClaw。

2. 两种 CLI 工具（任选其一）

• 方案 A（原生集成，推荐）：openclaw skills内置 ClawHub 能力，无需额外安装；
• 方案 B（独立工具）：全局安装clawhub命令（适合批量脚本）

bash

运行

npm i -g clawhub # 国内可配置镜像加速 clawhub config set clawhub.mirror https://mirror.aliyun.com/clawhub/

3. 初始化工作区（首次使用）

bash

运行

openclaw init

生成.openclaw配置目录，技能默认安装到当前项目./skills/；加--global可全局安装所有项目共享。

三、完整流程：查找 → 预览安全 → 安装 → 配置密钥 → 使用

步骤 1：在 ClawHub 搜索需要的技能（3 种方式）

方式 1：原生 openclaw 命令（最常用）

bash

运行

# 模糊搜索，支持中文描述 openclaw skills search "PDF文档解析" openclaw skills search "browser relay 浏览器插件" openclaw skills search "git代码管理" # 限制返回条数、JSON格式化 openclaw skills search "weather" --limit 10 --json

输出：技能唯一标识（slug）、作者、评分、功能简介。

方式 2：独立 clawhub 命令

bash

运行

clawhub search "excel数据处理"

方式 3：网页商店可视化查找

打开官网clawhub.ai，分类浏览全部社区技能，复制技能 slug 用于安装。

步骤 2：安全预览（安装前必看，避免恶意代码）

查看技能权限、依赖、源码说明：

bash

运行

# 原生cli openclaw skills inspect pdf-chat # 独立clawhub clawhub inspect pdf-chat

会展示：需要文件读写 / 网络权限、所需 API 密钥、运行环境依赖。

步骤 3：从 ClawHub 在线安装新技能（核心命令）

3.1 基础安装（最新稳定版，当前项目生效）

bash

运行

# openclaw原生 openclaw skills install browser-relay # clawhub独立工具 clawhub install browser-relay

执行逻辑：

1. 连接 ClawHub 仓库下载技能包；
2. 自动解析并安装依赖子技能；
3. 写入./skills/目录注册到 Agent；
4. 输出install successfully代表完成。

3.2 进阶安装参数

bash

运行

# 指定固定版本安装 openclaw skills install tavily-search --version 2.1.0 # 全局安装（所有OpenClaw项目共用） openclaw skills install weather-now --global # 强制覆盖已存在旧版本 openclaw skills install agent-browser --force # 从Git仓库安装未上架ClawHub的技能 openclaw skills install git:github.com/xxx/custom-skill

3.3 本地离线安装（下载压缩包解压后）

bash

运行

openclaw skills install ./local-skill-folder --name my-custom-skill

步骤 4：重启网关加载新技能（关键，不重启无法调用）

bash

运行

openclaw gateway restart

网关重载所有内置 + ClawHub 扩展技能。

步骤 5：查看已安装技能清单，确认是否加载成功

bash

运行

# 列出所有技能（内置+ClawHub扩展） openclaw skills list # 详细模式，展示版本、来源、权限 openclaw skills list --verbose

能看到browser-relay、pdf-chat等刚安装的技能即生效。

步骤 6：配置技能所需密钥 / 参数（大部分联网技能需要）

很多 ClawHub 技能依赖第三方 API（天气、PDF、搜索、GPT），两种配置方式：

方式 1：全局配置命令

bash

运行

openclaw configure --section skill.browser-relay # 填入网关token、浏览器插件密钥

方式 2：环境变量写入启动脚本

bash

运行

# 示例：Tavily搜索技能密钥 export TAVILY_API_KEY="sk-xxxxxxx" openclaw gateway restart

步骤 7：对话内调用 ClawHub 新增技能

和内置技能调用格式一致，/skill 技能名 参数示例（安装 browser-relay 浏览器中继技能后）：

plaintext

/skill browser-relay connect /skill browser-relay screenshot

四、技能日常管理（更新 / 卸载 / 验证）

1. 更新技能

bash

运行

# 更新单个技能 openclaw skills update browser-relay # 更新当前项目全部ClawHub技能 openclaw skills update --all # 全局更新 openclaw skills update --all --global

2. 卸载不需要的扩展技能

bash

运行

openclaw skills uninstall weather-now # 批量卸载 openclaw skills uninstall pdf-chat git-helper

存在依赖时会阻止卸载，需先卸载依赖子技能。

3. 校验技能完整性

bash

运行

openclaw skills verify browser-relay --card

输出技能完整信息卡，排查加载失败问题。

五、实操完整示例：安装 Browser-Relay 浏览器扩展技能

需求：补充内置 browser 没有的 Chrome 插件中继能力（ClawHub 独有）

1. 搜索技能

bash

运行

openclaw skills search browser relay

1. 预览安全信息

bash

运行

openclaw skills inspect browser-relay

1. 在线安装

bash

运行

openclaw skills install browser-relay

1. 重启网关

bash

运行

openclaw gateway restart

1. 配置插件连接 token

bash

运行

openclaw configure --section skill.browser-relay

1. 聊天框调用

plaintext

/skill browser-relay connect /skill browser-relay open https://www.baidu.com

六、Built-in 内置技能 VS ClawHub 扩展技能对比

表格

维度	Built-in 内置技能	ClawHub 安装的扩展技能
来源	OpenClaw 内核自带	ClawHub 社区仓库第三方开发
安装	无需安装，默认启用	必须skills install下载
网络依赖	web_search 需 API 密钥，web_fetch 开箱即用	绝大多数需要第三方 API 密钥
存储位置	内核内置，不可删除	./skills/或全局~/.openclaw/skills，可卸载
典型代表	web_search、web_fetch、browser、calculator	browser-relay、pdf-chat、weather、git、excel 解析
生效条件	网关默认开启（browser 需手动开配置）	安装后必须重启 gateway

七、常见问题

1. 安装后调用提示 “不存在该 skill”
   • 未执行openclaw gateway restart重载；
   • 技能名称 slug 输入错误，用openclaw skills list核对准确名称。
2. 国内 ClawHub 连接超时
   • 使用阿里云镜像：clawhub config set clawhub.mirror https://mirror.aliyun.com/clawhub/
3. 技能调用报错缺少 API Key
   • 执行openclaw configure --section skill.技能名填入密钥，重启网关。
4. 无法安装全局技能
   • Windows 终端以管理员运行；Linux/Mac 加 sudo 执行命令。