OpenClaw 技能使用教程

01

技能基础概念

什么是技能？

技能（Skills）是 OpenClaw 的扩展模块，它们就像手机上的 App 一样，为 AI 助手增加新的能力。

类比理解

不装天气 App	→	查不了天气
不装地图 App	→	无法导航
不装邮件 App	→	发不了邮件
不装技能	→	AI 不知道怎么做

技能的工作原理

                    用户请求 → AI分析 → 需要某技能 → 加载SKILL.md → 执行对应工具 → 返回结果
                

技能层级

层级	来源	可见范围
工作空间技能	用户自定义	仅当前智能体
项目技能	项目级别	仅当前工作空间
个人技能	用户级别	本机所有智能体
托管技能	系统安装	本机所有智能体
捆绑技能	内置功能	所有用户

02

内置工具一览

文件操作类

工具	功能	使用场景
read	读取文件内容	查看文档、读取配置
write	写入文件	创建文件、写入数据
edit	编辑文件	修改代码、更新内容
exec	执行系统命令	运行脚本、管理进程

网络类

工具	功能	使用场景
web_search	搜索网络	查找信息、搜索新闻
web_fetch	获取网页	抓取内容、分析页面
http_method_tester	API测试	测试接口、调试开发

AI能力类

🖼️

image

图片分析

🎨

image_generate

AI绘图

🎙️

tts

文字转语音

🎬

video_generate

视频生成

03

技能安装指南

方法一：从 ClawHub 安装（推荐）

                    # 查看可用技能
openclaw skills list

# 安装技能
openclaw skills install weather

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

方法二：手动安装

把技能文件夹放到工作空间：

                    ~/.openclaw/workspace/skills/
└── my-skill/
    ├── SKILL.md          # 必须有
    └── scripts/           # 可选
        └── run.sh
                

安装后验证

                    # 查看已安装的技能
openclaw skills list

# 查看技能详情
openclaw skills show weather
                

04

常用技能推荐

🌤️ weather - 天气预报

openclaw skills install weather

查询全球各地的天气情况

"北京今天天气怎么样？" → 🌡️ 温度：15°C - 23°C ☀️ 天气：晴

📧 email_sender - 邮件发送

openclaw skills install email-sender

发送电子邮件，支持附件

"帮我发一封邮件给 zhangsan@example.com，主题：项目汇报"

📊 data_visualizer - 数据可视化

openclaw skills install data-visualizer

将数据生成柱状图、折线图、饼图

"根据这份销售数据生成一个柱状图"

🔍 bing-search - 搜索工具

openclaw skills install bing-search

使用必应搜索获取网络信息

"搜索一下 OpenClaw 的最新消息"

📅 calendar_sync - 日历同步

openclaw skills install calendar-sync

同步和管理日历事件

"查看明天的日程" / "创建一个会议：明天下午3点"

技能目录结构

                    skill-name/
├── SKILL.md           # 必须：技能说明文件
├── README.md          # 可选：详细文档    ├── setup.sh
    └── run.py
                

SKILL.md 格式

                    ---
name: my-first-skill
description: 这是我的第一个技能
---

# 我的技能

## 使用场景
当用户想要执行某个特定任务时使用此技能。

## 使用方法
1. 第一步：准备数据
2. 第二步：调用工具
3. 第三步：返回结果

## 示例
用户输入："xxx"
AI 回答："xxx"
                

技能创建示例：新闻播报技能

news-broadcast/SKILL.md

# 新闻播报技能

## 触发条件
- 用户说"播报新闻"
- 用户说"今日头条"

## 使用流程
1. 使用 web_search 搜索最新新闻
2. 筛选重要资讯（热度 > 80）
3. 整理成简洁的播报格式
4. 使用 tts 转换为语音播报（可选）

## 输出格式
📰 今日头条
1. [标题] - 来源：xxx

06

技能实战案例

案例一：自动发送每日报告

🎯 目标：每天早上 9 点自动生成并发送日报

所需技能：weather + calendar_sync + email_sender

                        openclaw cron add \
  --name "日报" \
  --every "1d" \
  --at "09:00" \
  --message "生成并发送今日日报给团队" \
  --session isolated
                    

AI 执行流程：搜索新闻 → 获取天气 → 查看日程 → 汇总报告 → 发送邮件

案例二：图片批量处理

🎯 目标：批量压缩图片并转换为指定格式

所需技能：image_compressor + batch_rename

"压缩 images 文件夹下所有 JPG 图片"
"将所有图片转换为 PNG 格式"

案例三：多语言翻译助手

🎯 目标：快速翻译文本，支持多语言

所需技能：translation

"翻译：Hello, how are you?" → 中文
"把这段中文翻译成英文：你好吗？"

07

常见问题解答

Q1：技能安装失败怎么办？

                    # 查看 Node 版本
node --version

# 更新 OpenClaw
openclaw update

# 重新安装技能
openclaw skills install  --force
                

Q2：技能不生效怎么办？

排查步骤：

检查技能是否启用：openclaw skills list
查看 SKILL.md 是否存在语法错误
查看日志：openclaw logs tail
重启网关：openclaw gateway restart

Q3：技能和插件有什么区别？

区别	技能 (Skill)	插件 (Plugin)
加载方式	作为指导说明注入	作为代码模块加载
功能范围	指导 AI 如何行动	提供具体工具函数
配置难度	简单（纯文本）	复杂（代码）
适用场景	流程指导、规则说明	复杂功能、API 集成

📋

命令速查

命令	说明
openclaw skills list	列出所有技能
openclaw skills install <name>	安装技能
openclaw skills remove <name>	卸载技能
openclaw skills update --all	更新所有技能
openclaw skills show <name>	查看技能详情
openclaw skills enable <name>	启用技能
openclaw skills disable <name>	禁用技能

📚

ClawHub

技能市场

clawhub.ai

💬

官方 Discord

社区交流

discord.com/invite/clawd

📖

官方文档

完整指南

docs.openclaw.ai

🔧 OpenClaw 技能使用教程

📑 目录导航