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

# 全局安装 clawhub
npm install -g clawhub

# 验证安装成功
clawhub --version 

步骤 2：搜索技能

# 搜索包含“github”的技能
clawhub search github

# 查看热门技能
clawhub list --popular

# 浏览分类（如 devops、productivity）
clawhub browse devops

步骤 3：安装技能

# 安装指定技能
clawhub install tavily-search    # 联网搜索技能
clawhub install find-skills       # 技能检索技能（自动发现缺失技能）
clawhub install proactive-agent   # 主动迭代技能（自我优化）

# 安装指定版本
clawhub install github-actions@1.2.0

# 安装来自特定发布者的技能
clawhub install @username/skill-name

步骤 4：验证安装

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

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

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

# 搜索技能
openclaw skills search "github"

# 安装技能
openclaw skills install github-actions

# 安装新手推荐组合包
openclaw skills install-recommended

# 列出已安装技能
openclaw skills list

# 查看技能详情
openclaw skills info tavily-search

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

如果你不熟悉命令行，可以通过浏览器界面安装。

启动 OpenClaw 网关：

openclaw gateway start

浏览器访问 Web UI

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

在聊天框输入指令

帮我安装 tavily-search 技能

OpenClaw 会自动通过 fetch_url 完成安装。

3.4 方法四：从 GitHub 仓库手动安装（适合开发者）

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

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

# 进入技能目录
cd custom-skill

# 安装依赖（如有 package.json）
npm install

# 将技能链接到 OpenClaw 技能目录
# Linux/Mac
ln -s $(pwd) ~/.openclaw/skills/custom-skill

# Windows（管理员 PowerShell）
New-Item -ItemType Junction -Path "$env:USERPROFILE\.openclaw\skills\custom-skill" -Target $(pwd)

四、安装后的关键配置

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

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

# 1. 编辑 OpenClaw 配置文件
nano ~/.openclaw/config.json

# 2. 在配置文件中添加 API-Key
{
  "skills": {
    "customEntries": {
      "tavily": {
        "apiKey": "你的Tavily Search API-Key"
      }
    }
  }
}

# 3. 保存退出，重启网关使配置生效
openclaw gateway restart

4.2 技能启用/禁用

bash
# 禁用技能（保留但不使用）
openclaw skills disable github-actions

# 重新启用
openclaw skills enable github-actions

4.3 技能更新

bash
# 更新指定技能
openclaw skills update tavily-search

# 更新所有技能
openclaw skills update-all

4.4 技能卸载

bash
# 卸载不再使用的技能
openclaw skills uninstall find-skills
# 或使用 clawhub
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

clawhub install tavily-search

使用示例：

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

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

clawhub install find-skills

作用： 当用户提出 OpenClaw 当前无法完成的任务时，自动识别缺失功能并提示安装。

3. 主动迭代技能：proactive-agent

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 开发环境准备

# 创建技能开发目录
mkdir openclaw-custom-skills
cd openclaw-custom-skills

# 初始化第一个技能项目
mkdir file-report-skill
cd file-report-skill

# 初始化 package.json
npm init -y

# 安装 TypeScript 依赖
npm install typescript @types/node --save-dev

# 生成 tsconfig.json
npx tsc --init --target ES2020 --module CommonJS --outDir dist

6.2 技能核心结构

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

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

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

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

{
  "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（执行逻辑）

import fs from 'fs';
import path from 'path';

function countFilesByType(dirPath: string): Record<string, number> {
  const stats: Record<string, number> = {};

  if (!fs.existsSync(dirPath)) {
    throw new Error(`目录不存在：${dirPath}`);
  }

  const files = fs.readdirSync(dirPath, { withFileTypes: true });

  for (const file of files) {
    if (file.isDirectory()) continue;
    const ext = path.extname(file.name).toLowerCase() || '无扩展名';
    stats[ext] = (stats[ext] || 0) + 1;
  }

  return stats;
}

function generateMarkdownReport(stats: Record<string, number>, dirPath: string): string {
  const now = new Date().toLocaleString();
  let markdown = `# 文件统计报表\n`;
  markdown += `**统计目录**：${dirPath}\n`;
  markdown += `**统计时间**：${now}\n\n`;
  markdown += `| 文件类型 | 数量 |\n|----------|------|\n`;

  Object.entries(stats).forEach(([ext, count]) => {
    markdown += `| ${ext} |${count} |\n`;
  });

  const total = Object.values(stats).reduce((sum, val) => sum + val, 0);
  markdown += `\n**总文件数**：${total}\n`;

  return markdown;
}

export default async function run(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 
      : path.join(process.cwd(), outputPath);
    fs.writeFileSync(fullOutputPath, markdown, 'utf8');

    return {
      success: true,
      message: `文件统计报表已生成`,
      data: {
        stats: fileStats,
        reportPath: fullOutputPath,
        totalFiles: Object.values(fileStats).reduce((sum, val) => sum + val, 0)
      }
    };
  } catch (error) {
    return {
      success: false,
      message: `执行失败：${(error as Error).message}`,
      data: null
    };
  }
}

步骤 3：编译并安装

编译 TypeScript

npx tsc

# 创建软链接到 OpenClaw 技能目录
# Linux/Mac
ln -s $(pwd) ~/.openclaw/skills/file-report-skill

# 重启网关
openclaw gateway restart

6.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：技能安装后无法使用

bash

检查技能是否已启用
openclaw skills list

查看技能日志
openclaw logs --filter 技能名称

确认 API-Key 是否正确配置
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 推荐的安全类技能

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

bash

安装安全审计技能
clawhub install security-audit

安装权限管理技能
clawhub install permission-manager

安装密钥保险箱技能
clawhub install key-vault

8.3 定期安全审计

bash

执行深度安全审计
openclaw security audit --deep

查看技能权限使用情况
openclaw skills permissions --report

8.4 黄金法则

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

---

九、总结

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

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