OpenClaw 技能插件完全指南：31个 Skill 详解与实战

前言

OpenClaw 最强大的地方在于它的技能（Skill）生态系统。Skill 是预定义的能力模块，让 AI Agent 能够执行特定任务——从发送邮件到操作浏览器，从查询股票到管理飞书文档。

本文将详细介绍我的 OpenClaw 实例中安装的所有 31 个 Skill，涵盖功能、工作原理、调用方式和实际使用场景。

Skill 系统原理

什么是 Skill？

Skill 本质上是一个包含 SKILL.md 指令文件的目录。当用户发送消息时，OpenClaw 的 Agent 会扫描消息内容，匹配到相关的 Skill 后加载其 SKILL.md 作为上下文，从而获得执行该任务所需的知识和能力。

~/.openclaw/skills/
├── my-skill/
│   ├── SKILL.md          # 技能定义文件（核心）
│   ├── _meta.json        # 元数据
│   ├── scripts/          # 脚本文件
│   └── references/       # 参考资料

调用流程

用户消息 → Agent 语义匹配 → 加载对应 SKILL.md → Agent 根据指令执行 → 调用脚本/工具/API

Agent 不需要显式调用 Skill，它会根据对话内容自动识别需要哪个 Skill。你也可以在消息中明确提到 Skill 名称来触发。

安装方式

Skill 有三种来源：

1. 内置 Skill — 随 OpenClaw 安装，开箱即用
2. ClawHub 社区 Skill — 从 clawhub.ai 下载安装
3. 自定义 Skill — 自己编写，放到 ~/.openclaw/skills/ 目录

一、社区安装的 Skills（12个）

1. agent-browser — Stagehand 浏览器自动化

功能：基于 Stagehand 框架的浏览器自动化工具，可以操控网页、填写表单、点击按钮、提取数据等。

原理：Stagehand 是一个 AI 驱动的浏览器自动化库，通过自然语言描述来控制浏览器，不需要写传统的 CSS 选择器。

安装来源：ClawHub - agent-browser

使用场景： - 自动登录网站并抓取数据 - 填写和提交在线表单 - 网页截图和数据提取

2. auto-updater — 系统包自动更新

功能：检查并更新系统软件包，支持 apt、npm、pip 等包管理器。

原理：通过执行系统命令检查可更新的包，并按照安全策略执行更新。

安装来源：ClawHub - auto-updater

使用场景： - 定期检查服务器安全更新 - 批量更新 npm/pip 依赖 - 生成更新报告

3. automation-workflows — 自动化工作流

功能：定义和管理自动化工作流，将多个步骤串联成可重复执行的流程。

原理：通过声明式配置定义工作流的步骤、条件和触发器，Agent 按顺序执行。

安装来源：ClawHub - automation-workflows

使用场景： - 定义「收到邮件 → 分析内容 → 回复」的自动化流程 - 定时任务编排 - 多步骤数据处理管道

4. browser-use — AI 浏览器操作

功能：另一个 AI 驱动的浏览器自动化工具，基于 Python 的 browser-use 库。

原理：使用 Playwright 作为浏览器引擎，配合 LLM 理解网页内容并执行操作。与 agent-browser 的区别在于技术栈不同（Python vs Node.js）。

安装方式：

uv tool install "browser-use[cli]"

使用场景： - 复杂的网页交互（多步骤操作） - 需要登录状态的网站操作 - 网页数据批量采集

注意事项：如果服务器配置了 socks5 代理，可能需要 patch 启动脚本清除 all_proxy 环境变量。

5. clawddocs — OpenClaw 文档专家

功能：查询和理解 OpenClaw 官方文档，帮助排查配置问题和了解新功能。

原理：包含 OpenClaw 文档的索引和查询脚本，Agent 可以快速定位相关文档内容。

安装来源：ClawHub - clawddocs

使用场景： - 查询 OpenClaw 配置选项 - 排查部署问题 - 了解新版本特性

6. evolver — AI 自我进化引擎

功能：分析 Agent 的运行历史，识别改进机会，在协议约束下进行自我进化。

原理：通过分析对话日志、任务执行记录，提取模式并生成改进建议，然后自动更新配置或创建新的技能。

安装来源：ClawHub - evolver

使用场景： - 自动优化 Agent 行为 - 从错误中学习并创建防护规则 - 生成新 Skill 的草稿

7. imap-smtp-email — 邮件收发

功能：通过 IMAP 收取邮件、通过 SMTP 发送邮件，支持多账号配置。

原理：Node.js 脚本封装了 imapflow 和 nodemailer 库，提供命令行接口。

核心命令：

# 检查邮箱
node scripts/imap.js check
node scripts/imap.js check --account qq  # 指定账号

# 搜索邮件
node scripts/imap.js search --query "关键词"

# 获取邮件详情
node scripts/imap.js fetch --uid 1234

# 下载附件
node scripts/imap.js download --uid 1234

# 列出邮箱文件夹
node scripts/imap.js list-mailboxes

# 发送邮件
node scripts/smtp.js send --to "[email protected]" --subject "主题" --body "内容"

配置方式：在 ~/.config/imap-smtp-email/.env 中配置邮箱账号：

IMAP_HOST=imap.163.com
IMAP_PORT=993
IMAP_USER=[email protected]
IMAP_PASS=your_password
IMAP_TLS=true

SMTP_HOST=smtp.163.com
SMTP_PORT=465
SMTP_USER=[email protected]
SMTP_PASS=your_password
SMTP_TLS=true

支持的邮箱：Gmail、Outlook、163、QQ、iCloud 等所有支持 IMAP/SMTP 的邮箱。

8. nano-banana-pro — Gemini PDF 工具

功能：使用 Google Gemini 模型处理和分析 PDF 文件。

原理：调用 Gemini API 的多模态能力，将 PDF 内容（包括图表、图片）发送给 Gemini 进行分析。

安装来源：ClawHub - nano-banana-pro

前置条件：需要配置 Gemini API Key。

9. polymarket-trade — Polymarket 预测市场

功能：查询 Polymarket 预测市场数据，包括热门事件、赔率、价格趋势等。

原理：通过 Polymarket 的公开 API 获取市场数据，不需要 API Key。

核心命令：

# 查看热门市场
python3 scripts/polymarket.py trending

# 搜索特定事件
python3 scripts/polymarket.py search --query "election"

# 查看市场详情
python3 scripts/polymarket.py market --id "市场ID"

使用场景： - 跟踪大选、科技发布等事件预测 - 查看市场趋势和交易量 - 设置价格提醒

10. self-improving-agent — AI 自我学习

功能：让 Agent 具备自我反思和改进的能力，从执行结果中学习。

原理：记录每次任务执行的过程和结果，定期分析成功/失败模式，更新行为策略。

安装来源：ClawHub - self-improving-agent

使用场景： - 代码生成后自动测试并改进 - 从用户反馈中学习偏好 - 优化常用任务的执行策略

11. stock-analysis — 股票分析

功能：通过 yfinance 获取股票实时行情、历史数据、财务报表等。

原理：基于 Python 的 yfinance 库，调用 Yahoo Finance API 获取股票数据。

核心功能：

# 查看股票价格
python3 scripts/stock_analysis.py price --ticker AAPL

# 查看财务数据
python3 scripts/stock_analysis.py financials --ticker AAPL

# 管理自选股
python3 scripts/watchlist.py add AAPL
python3 scripts/watchlist.py list

使用场景： - 快速查看股票行情 - 对比分析多只股票 - 管理个人自选股列表

12. youtube-watcher — YouTube 字幕获取

功能：获取 YouTube 视频的字幕/转录文本，支持多语言字幕。

原理：使用 youtube-transcript-api 库，通过视频 ID 获取 YouTube 的隐藏字幕数据。

核心命令：

# 获取字幕
python3 scripts/get_transcript.py --url "https://youtube.com/watch?v=VIDEO_ID"

# 指定语言
python3 scripts/get_transcript.py --url "视频URL" --lang zh

使用场景： - 快速提取视频内容要点 - 生成视频摘要 - 获取外语视频的中文字幕

二、内置 Skills（19个）

13. discord — Discord 操作

功能：通过 Discord API 发送消息、管理频道、创建线程等。

原理：封装 Discord Bot API，支持消息收发、频道管理、表情反应等操作。

使用场景： - 在 Discord 频道自动发消息 - 管理服务器和频道 - 监控 Discord 消息

14. gh-issues — GitHub Issue 自动处理

功能：自动处理 GitHub Issues——获取、分析、创建 PR 修复、监控 Review 评论。

原理：结合 gh CLI 和 AI 分析能力，自动读取 Issue、生成修复代码、提交 PR。

使用方式：

/gh-issues owner/repo --label bug --limit 5

使用场景： - 自动修复标记为 bug 的 Issue - 批量处理社区贡献 - 定时检查新 Issue

15. github — GitHub 操作

功能：全面的 GitHub 操作能力，包括 Issues、PR、CI、代码审查等。

原理：封装 gh CLI 工具，提供结构化的 GitHub 操作接口。

使用场景： - 查看 PR 状态和 CI 运行结果 - 创建和管理 Issue - 代码审查和评论

16. healthcheck — 主机安全检查

功能：检查服务器的安全配置、系统更新状态、防火墙规则等。

原理：执行一系列安全检查命令（ufw 状态、SSH 配置、系统更新等），生成安全报告。

使用场景： - 定期安全审计 - 新服务器安全加固 - 检查暴露风险

17. nano-pdf — PDF 编辑

功能：使用自然语言指令编辑 PDF 文件——合并、拆分、旋转、加水印等。

原理：通过 nano-pdf CLI 工具，将自然语言指令转换为 PDF 操作命令。

使用场景： - 合并多个 PDF 文件 - 提取 PDF 特定页面 - 添加水印或页码

18. node-connect — 设备连接诊断

功能：诊断 OpenClaw Node（手机/电脑客户端）的连接和配对问题。

原理：检查网络配置、Tailscale 连接、Gateway 绑定等，定位连接失败原因。

使用场景： - 手机 App 无法连接服务器 - Tailscale 组网问题 - QR 码配对失败

19. skill-creator — Skill 创建工具

功能：帮助创建、编辑、审计和优化 Skill。

原理：提供 Skill 开发的最佳实践模板和规范检查，确保新 Skill 符合 OpenClaw 规范。

使用场景： - 从零创建新 Skill - 优化现有 Skill - 审计 Skill 安全性

20. tmux — 终端会话管理

功能：远程控制 tmux 会话，发送按键和读取面板输出。

原理：通过 tmux 的控制模式，实现对交互式 CLI 工具的自动化操作。

使用场景： - 自动化交互式 CLI 操作 - 在后台运行长时间命令 - 管理多个终端会话

21. video-frames — 视频抽帧

功能：从视频中提取帧图片或短视频片段。

原理：使用 ffmpeg 进行视频处理，支持按时间、按帧率、按场景变化提取。

使用场景： - 视频内容分析 - 提取关键帧制作缩略图 - 视频片段裁剪

22. weather — 天气查询

功能：查询全球各地的天气和预报。

原理：通过 wttr.in 或 Open-Meteo API 获取天气数据，无需 API Key。

使用场景： - 查看当前天气 - 获取未来几天预报 - 计划出行

23. xurl — X (Twitter) API 工具

功能：全面的 X (Twitter) 操作——发推、回复、搜索、管理粉丝、发送 DM、上传媒体等。

原理：封装 X API v2 的所有端点，通过 CLI 命令调用。

使用场景： - 自动发推和互动 - 搜索热门话题 - 管理 Twitter 账号

24-31. 飞书系列 Skills

OpenClaw 内置了完整的飞书集成，提供 8 个飞书相关 Skill：

feishu-bitable — 多维表格

管理飞书多维表格：创建、查询、编辑记录，管理字段、视图、数据表。

使用场景： - 自动填写多维表格 - 批量导入数据 - 创建自动化报表

feishu-calendar — 日历与日程

管理飞书日历：创建日程、查询忙闲、管理参会人。

feishu-channel-rules — 飞书频道规则

控制飞书消息的输出格式和行为，确保消息在飞书环境正确显示。

feishu-create-doc — 创建云文档

从 Markdown 内容创建飞书云文档，支持指定位置。

feishu-fetch-doc — 获取云文档

读取飞书云文档内容，转为 Markdown 格式。

feishu-im-read — IM 消息读取

获取群聊/单聊历史消息、话题回复、跨会话搜索、下载图片文件。

feishu-task — 任务管理

创建、查询、更新任务和清单。

feishu-troubleshoot — 问题排查

飞书插件故障诊断，包含常见问题 FAQ 和深度诊断命令。

feishu-update-doc — 更新云文档

支持追加、覆盖、定位替换等多种更新模式。

三、如何管理 Skills

查看已安装 Skills

openclaw skills check

从 ClawHub 安装

# 通用方式
curl -L -o /tmp/skill.zip "https://wry-manatee-359.convex.site/api/v1/download?slug=技能名"
unzip -o /tmp/skill.zip -d ~/.openclaw/skills/技能名/

# 如果有 npm 依赖
cd ~/.openclaw/skills/技能名 && npm install

# 如果有 Python 依赖
pip3 install 依赖包名

卸载 Skill

rm -rf ~/.openclaw/skills/技能名
openclaw gateway restart

创建自定义 Skill

mkdir -p ~/.openclaw/skills/my-skill/{scripts,references}

然后编写 SKILL.md 文件，定义技能的功能和使用说明。

四、最佳实践

1. 按需安装：只安装你实际会用到的 Skill，减少不必要的依赖
2. 定期更新：定期从 ClawHub 检查 Skill 更新
3. 注意权限：安装前审查 Skill 的权限需求
4. 配置安全：API Key 等敏感信息使用环境变量，不要硬编码
5. 利用内置：优先使用内置 Skill，它们经过更好的测试

总结

OpenClaw 的 Skill 系统让 AI Agent 的能力可以无限扩展。从邮件管理到浏览器自动化，从股票分析到飞书办公，31 个 Skill 覆盖了日常开发和生活的方方面面。

最重要的是，Skill 的设计理念是「自然语言驱动」——你不需要记住任何命令，只需要用自然语言描述你的需求，Agent 会自动选择合适的 Skill 来完成任务。

相关链接： - ClawHub 技能市场 - OpenClaw GitHub - OpenClaw 文档 - OpenClaw Discord 社区