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

一、基础概念区分Built-in 内置技能内核自带web_search/web_fetch/browser/calculator等无需安装开箱即用ClawHub官方技能商店社区第三方扩展技能仓库所有额外功能天气、PDF 解析、Git、企业微信、BrowserRelay 插件等都要从这里安装安装后属于外部扩展 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执行逻辑连接 ClawHub 仓库下载技能包自动解析并安装依赖子技能写入./skills/目录注册到 Agent输出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-skill3.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_KEYsk-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 --global2. 卸载不需要的扩展技能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 独有搜索技能bash运行openclaw skills search browser relay预览安全信息bash运行openclaw skills inspect browser-relay在线安装bash运行openclaw skills install browser-relay重启网关bash运行openclaw gateway restart配置插件连接 tokenbash运行openclaw configure --section skill.browser-relay聊天框调用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、calculatorbrowser-relay、pdf-chat、weather、git、excel 解析生效条件网关默认开启browser 需手动开配置安装后必须重启 gateway七、常见问题安装后调用提示 “不存在该 skill”未执行openclaw gateway restart重载技能名称 slug 输入错误用openclaw skills list核对准确名称。国内 ClawHub 连接超时使用阿里云镜像clawhub config set clawhub.mirror https://mirror.aliyun.com/clawhub/技能调用报错缺少 API Key执行openclaw configure --section skill.技能名填入密钥重启网关。无法安装全局技能Windows 终端以管理员运行Linux/Mac 加 sudo 执行命令。