OpenClaw的技能（skills）安装和使用教程【防踩坑版】

作者：CSDN博客
OpenClaw Skills 安装与使用完全教程【防踩坑版】

当你的 OpenClaw 成功对接飞书后，下一步就是通过 Skills（技能插件） 让它真正“会干活”。Skills 是 OpenClaw 的能力扩展模块，相当于给 AI 装上“灵活双手”——从浏览器自动化到文件管理，从邮件处理到代码调试，安装对应技能就能解锁对应能力 。
本文基于 2026 年 OpenClaw 最新版本，详细拆解 Skills 的四种安装方法、常用技能使用场景、自定义开发流程以及安全管理要点，所有命令可直接复制执行，助你从“部署完成”一步到位实现“功能全开”。

---

一、Skills 核心认知：AI 的“标准作业指导书”

1.1 Skills 是什么？

OpenClaw 的设计理念是“核心框架 + 技能扩展” ：

核心框架：仅包含任务调度、通信通道等底层功能，相当于“智能设备空白机”Skills：可扩展的功能模块，相当于“各类功能 APP”——安装浏览器技能就能自动爬取数据，安装文件管理技能就能读写分类文件

截至 2026 年 2 月，OpenClaw Skills 生态已拥有 1715+ 个社区贡献技能，涵盖 31 个主要分类，由全球开发者持续更新维护 。
1.2 为什么必须安装 Skills？

很多用户部署完 OpenClaw 后觉得“不好用”，根本原因就是没装核心技能 。基础安装仅提供对话能力，无法完成联网搜索、文件操作等实际任务。典型场景：

联网技能：赋予访问互联网、获取实时信息的能力技能检索技能：让其自主识别缺失功能并自动安装补充主动迭代技能：使其具备失败重试、自我优化的闭环能力

没有这些核心 Skills，OpenClaw 就如同“空壳框架”，这也是本文存在的意义。

---

二、安装前的认知与准备

2.1 技能类型

OpenClaw 支持三类技能 ：

类型	说明	适用场景
自然语言技能（SKILL.md）	用 Markdown + YAML 编写的流程说明书	简单工作流、日常自动化
TypeScript 技能	全功能技能，可访问 API、执行复杂逻辑	复杂集成、第三方 API 对接
CLI 技能	封装命令行工具	系统运维、脚本执行

2.2 前置准备

无论通过何种方式安装技能，都需要准备 ：

OpenClaw 已部署运行（已完成的基础部署）Node.js ≥ 22.x（技能管理工具依赖）Python ≥ 3.9（部分技能执行依赖）ClawHub 访问权限：技能资源库官网 https://clawhub.ai/

2.3 ⚠️ 安全第一原则

OpenClaw 的 Skills 生态开放，任何人都可贡献插件，这意味着存在恶意代码风险。尤其当技能涉及以下内容时，务必谨慎 ：

账号凭证（Cookie、登录密码）API 密钥、私钥（如阿里云百炼 API-Key、钱包私钥）资金相关操作（交易、转账）

核心安全原则：安装前体检、运行中监控、权限最小化。第 5 章会专门讲解安全类技能的使用。

---

三、4 种 Skills 安装方法（从易到难）

OpenClaw 2026 版提供了 4 种技能安装方式，新手推荐从方法一开始，逐步掌握 。
3.1 方法一：命令行一键安装（clawhub 工具）

这是最推荐、最稳定的安装方式，所有命令全平台通用 。
步骤 1：安装技能管理工具 clawhub

1. # 全局安装 clawhubnpminstall-g clawhub
3. # 验证安装成功
4. clawhub --version

复制代码

步骤 2：搜索技能

1. # 搜索包含“github”的技能
2. clawhub search github
4. # 查看热门技能
5. clawhub list --popular# 浏览分类（如 devops、productivity）
6. clawhub browse devops

复制代码

步骤 3：安装技能

1. # 安装指定技能
2. clawhub install tavily-search    # 联网搜索技能
3. clawhub install find-skills       # 技能检索技能（自动发现缺失技能）
4. clawhub install proactive-agent   # 主动迭代技能（自我优化）# 安装指定版本
5. clawhub install github-actions@1.2.0
7. # 安装来自特定发布者的技能
8. clawhub install @username/skill-name

复制代码

步骤 4：验证安装

1. # 列出所有已安装技能
2. clawhub list
3. # 输出示例：# ✔ tavily-search@2.1.0# ✔ find-skills@1.3.2# ✔ proactive-agent@0.9.5

复制代码

3.2 方法二：OpenClaw 内置命令安装（推荐）

OpenClaw 自身也集成了技能管理命令，与方法一效果相同。

1. # 搜索技能
2. openclaw skills search "github"# 安装技能
3. openclaw skills install github-actions
5. # 安装新手推荐组合包
6. openclaw skills install-recommended
8. # 列出已安装技能
9. openclaw skills list
11. # 查看技能详情
12. openclaw skills info tavily-search

复制代码

3.3 方法三：Web UI 可视化安装（适合新手）

如果你不熟悉命令行，可以通过浏览器界面安装。
启动 OpenClaw 网关：

1. openclaw gateway start

复制代码

浏览器访问 Web UI

1. http://你的服务器IP:18789/?token=你的Token

复制代码

在聊天框输入指令

1. 帮我安装 tavily-search 技能

复制代码

OpenClaw 会自动通过 fetch_url 完成安装。
3.4 方法四：从 GitHub 仓库手动安装（适合开发者）

对于未发布到 ClawHub 的自定义技能，可通过 GitHub 安装。

1. # 克隆仓库git clone https://github.com/username/custom-skill.git
3. # 进入技能目录cd custom-skill
5. # 安装依赖（如有 package.json）npminstall# 将技能链接到 OpenClaw 技能目录# Linux/Macln-s$(pwd) ~/.openclaw/skills/custom-skill
7. # Windows（管理员 PowerShell）
8. New-Item -ItemType Junction -Path"$env:USERPROFILE\.openclaw\skills\custom-skill"-Target$(pwd)

复制代码

四、安装后的关键配置

4.1 配置 API-Key（以 Tavily Search 为例）

很多技能需要 API 密钥才能正常工作。以联网搜索技能 tavily-search 为例 ：

1. # 1. 编辑 OpenClaw 配置文件nano ~/.openclaw/config.json
3. # 2. 在配置文件中添加 API-Key{"skills":{"customEntries":{"tavily":{"apiKey":"你的Tavily Search API-Key"}}}}# 3. 保存退出，重启网关使配置生效
4. openclaw gateway restart

复制代码

4.2 技能启用/禁用

1. bash# 禁用技能（保留但不使用）
2. openclaw skills disable github-actions
4. # 重新启用
5. openclaw skills enable github-actions

复制代码

4.3 技能更新

1. bash# 更新指定技能
2. openclaw skills update tavily-search
4. # 更新所有技能
5. openclaw skills update-all

复制代码

4.4 技能卸载

1. bash# 卸载不再使用的技能
2. openclaw skills uninstall find-skills
3. # 或使用 clawhub
4. clawhub uninstall find-skills

复制代码

五、基础技能使用场景（内置 + 推荐）

5.1 基础内置技能（无需额外安装）

OpenClaw 默认预装了三个核心技能 ：

技能名称	功能	示例指令
agent-browser	浏览器自动化	“用 agent-browser 访问百度，抓取实时热搜前 5 名并整理成文本”
file-manager	文件管理	“创建名为’OpenClaw技能测试’的文本文件，保存到 /root/openclaw/files 目录”
system-command	系统命令执行	“查看当前服务器 CPU 占用率，整理成简单报告”

5.2 办公自动化三件套（强烈推荐）

通过 clawhub install 安装以下技能，可极大提升办公效率。
1.  联网搜索技能：tavily-search

1. clawhub install tavily-search

复制代码

使用示例：

1. 使用 tavily-search 搜索 2026 年国际热点新闻，返回 3 条核心链接

复制代码

2. 技能检索技能：find-skills

1. clawhub install find-skills

复制代码

作用： 当用户提出 OpenClaw 当前无法完成的任务时，自动识别缺失功能并提示安装。
3. 主动迭代技能：proactive-agent

1. clawhub install proactive-agent

复制代码

作用： 使 AI 具备自我优化能力，任务失败时自动重试、调整策略。
5.3 更多实用技能推荐

分类	技能名称	功能	安装命令
邮件管理	gmail-manager	自动收发邮件、整理 inbox	clawhub install gmail-manager
PDF 处理	nano-pdf	PDF 合并、拆分、内容提取	clawhub install nano-pdf
笔记管理	notion-manager	对接 Notion，自动创建笔记	clawhub install notion-manager
代码开发	coding-agent	生成代码、调试优化	clawhub install coding-agent
GitHub	github	操作仓库、提交代码	clawhub install github
任务管理	todoist	创建任务、设置截止日期	clawhub install todoist
记忆优化	Bio-MemoryPro	节省 Token（最高省 72%）	clawhub install bio-memorypro

六、进阶：自定义 Skill 开发（让 AI 按你的想法干活）

当官方和社区的技能无法满足你的个性化需求时（如对接公司内部 CRM、生成行业专属报表），可以自行开发技能。
6.1 开发环境准备

1. # 创建技能开发目录mkdir openclaw-custom-skills
2. cd openclaw-custom-skills
4. # 初始化第一个技能项目mkdir file-report-skill
5. cd file-report-skill
7. # 初始化 package.jsonnpm init -y# 安装 TypeScript 依赖npminstall typescript @types/node --save-dev
9. # 生成 tsconfig.json
10. npx tsc --init--target ES2020 --module CommonJS --outDir dist

复制代码

6.2 技能核心结构

所有 OpenClaw Skill 都遵循"3 文件核心结构"：

1. my-custom-skill/
2. ├── plugin.json       # Skill 元信息（名称、权限、接口声明）
3. ├── index.ts/js       # 核心执行逻辑
4. └── package.json      # 依赖配置（可选）

复制代码

6.3 实战：开发"文件统计报表"技能

步骤 1：编写 plugin.json（元信息）

1. {"name":"file-report-skill","version":"1.0.0","description":"统计指定目录的文件类型和数量，生成Markdown格式报表","author":"Your Name","skills":[{"action":"generate-file-report","description":"统计目录文件并生成Markdown报表","parameters":[{"name":"dirPath","type":"string","required":true,"description":"要统计的目录绝对路径"},{"name":"outputPath","type":"string","required":false,"default":"./file-report.md","description":"报表保存的路径"}],"permissions":["file.read","file.write"]}]}

复制代码

步骤 2：编写 index.ts（执行逻辑）

1. import fs from'fs';import path from'path';functioncountFilesByType(dirPath:string): Record<string,number>{const stats: Record<string,number>={};if(!fs.existsSync(dirPath)){thrownewError(`目录不存在：${dirPath}`);}const files = fs.readdirSync(dirPath,{ withFileTypes:true});for(const file of files){if(file.isDirectory())continue;const ext = path.extname(file.name).toLowerCase()||'无扩展名';
2.     stats[ext]=(stats[ext]||0)+1;}return stats;}functiongenerateMarkdownReport(stats: Record<string,number>, dirPath:string):string{const now =newDate().toLocaleString();let markdown =`# 文件统计报表\n`;
3.   markdown +=`**统计目录**：${dirPath}\n`;
4.   markdown +=`**统计时间**：${now}\n\n`;
5.   markdown +=`| 文件类型 | 数量 |\n|----------|------|\n`;
7.   Object.entries(stats).forEach(([ext, count])=>{
8.     markdown +=`| ${ext} |${count} |\n`;});const total = Object.values(stats).reduce((sum, val)=> sum + val,0);
9.   markdown +=`\n**总文件数**：${total}\n`;return markdown;}exportdefaultasyncfunctionrun(action:string, params:any){try{if(action !=='generate-file-report'){return{ success:false, message:`不支持的动作：${action}`, data:null};}const{ dirPath, outputPath ='./file-report.md'}= params;const fileStats =countFilesByType(dirPath);const markdown =generateMarkdownReport(fileStats, dirPath);const fullOutputPath = path.isAbsolute(outputPath)? outputPath
10.       : path.join(process.cwd(), outputPath);
11.     fs.writeFileSync(fullOutputPath, markdown,'utf8');return{
12.       success:true,
13.       message:`文件统计报表已生成`,
14.       data:{
15.         stats: fileStats,
16.         reportPath: fullOutputPath,
17.         totalFiles: Object.values(fileStats).reduce((sum, val)=> sum + val,0)}};}catch(error){return{
18.       success:false,
19.       message:`执行失败：${(error as Error).message}`,
20.       data:null};}}

复制代码

步骤 3：编译并安装

编译 TypeScript

1. npx tsc
3. # 创建软链接到 OpenClaw 技能目录# Linux/Macln-s$(pwd) ~/.openclaw/skills/file-report-skill
5. # 重启网关
6. openclaw gateway restart

复制代码

6.4 技能开发核心原则

1. 标准化输入输出： 参数和返回值必须符合规范
2. 最小权限原则： 只申请完成任务必需的权限
3. 异常处理完备： 必须捕获错误，返回清晰信息
4. 无状态设计： Skill 不保存用户数据，由内核传递上下文

复制代码

代码
预览
七、日常管理与维护

7.1 常用命令速查表

命令	功能
clawhub search <关键词>	搜索技能
clawhub install <技能名>	安装技能
clawhub list	列出已安装技能
clawhub update <技能名>	更新指定技能
clawhub update-all	更新所有技能
clawhub uninstall <技能名>	卸载技能
openclaw skills config <技能名> --set key=value	配置技能参数
openclaw logs --filter skills	查看技能运行日志
cp ~/.openclaw/config.json ~/.openclaw/config.backup.json	备份技能配置

7.2 故障排查

问题 1：技能安装后无法使用

1. bash
3. 检查技能是否已启用
4. openclaw skills list
6. 查看技能日志
7. openclaw logs --filter 技能名称
9. 确认 API-Key 是否正确配置
10. cat ~/.openclaw/config.json |grep 技能名称

复制代码

问题 2：提示 “missing api key”

解决方案： 按 4.1 节方法在配置文件中添加对应 API-Key。
问题 3：技能冲突

如果多个技能有相同动作名，高优先级技能会覆盖低优先级技能。
优先级顺序：
工作区 Skills > 本地托管 Skills (~/.openclaw/skills) > 内置 Skills

---

八、安全使用指南（必读）

OpenClaw Skills 可以访问你的系统、文件、网络，甚至接触资金信息，安全意识是使用 Skills 的前提。
8.1 安装前检查

来源可信度： 优先从 ClawHub 官方市场或知名开发者安装查看权限申请： 安装前检查技能申请的权限（plugin.json 中的 permissions 字段）阅读 README： 了解技能功能、所需权限、API 密钥用途

8.2 推荐的安全类技能

以下技能可帮助你在使用其他技能时保障安全：

1. bash
3. 安装安全审计技能
4. clawhub install security-audit
6. 安装权限管理技能
7. clawhub install permission-manager
9. 安装密钥保险箱技能
10. clawhub install key-vault

复制代码

8.3 定期安全审计

1. bash
3. 执行深度安全审计
4. openclaw security audit --deep
6. 查看技能权限使用情况
7. openclaw skills permissions --report

复制代码

8.4 黄金法则

最小权限原则： 只为技能提供完成任务必需的权限密钥隔离： 不同技能使用不同的 API 密钥，避免一个泄露全盘皆失定期清理： 卸载不再使用的技能，减少攻击面沙箱运行： 对于不信任的技能，考虑在隔离环境（如 Docker）中运行

---

九、总结

从基础的浏览器自动化到自定义技能开发，OpenClaw Skills 让你真正拥有一个“会干活”的 AI 助手。记住三个关键点：

先装核心：tavily-search、find-skills、proactive-agent 是提升体验的必备三件套安全优先： 任何涉及敏感信息的操作，先安装安全类技能再操作按需扩展： 遇到重复性工作，考虑开发或安装对应技能，让 AI 替你完成

原文地址：https://blog.csdn.net/qq_39141301/article/details/158894716