OpenClaw 技能推荐完全指南（2026最新）

14.0k 字 约 47 分钟 OpenClaw

OpenClaw 技能推荐完全指南（2026最新）

OpenClaw Skills

本文面向 OpenClaw 新手，系统介绍核心技能、推荐技能、安装配置步骤与最佳实践。基于 OpenClaw 2026.3 版本编写。

📋 目录

🎯 什么是技能

技能（Skills） 是 OpenClaw 的功能扩展单元，每个技能提供特定能力（如天气查询、GitHub 操作、网页搜索等）。技能本质上是包含 SKILL.md 文档和可执行脚本的独立模块。

技能的分类

类型 特点 示例
内置技能 安装 OpenClaw 时自带，开箱即用 weather, github, coding-agent
核心插件 关键功能，通常默认启用 gh-issues, node-connect
第三方技能 通过 ClawHub 安装，扩展生态 tavily-search, notion, spotify-player
自定义技能 自己开发的私有技能 my-custom-skill

技能如何工作

OpenClaw 启动时扫描以下位置的技能：

1
2
3
4
5
# 1. 全局安装（npm）
C:\Users\你的用户名\AppData\Roaming\npm\node_modules\openclaw\skills\

# 2. 本地工作区（可选）
C:\Users\17445\.openclaw\workspace\skills\

发现新技能后，OpenClaw 会自动加载其 SKILL.md 中声明的触发器和使用规则。

🚀 快速安装技能

通过 ClawHub 安装（推荐）

ClawHub 是 OpenClaw 的官方技能仓库，地址：https://clawhub.com

1. 搜索技能

1
2
3
4
5
6
7
8
# 搜索天气相关技能
npx clawhub search weather

# 搜索网页搜索技能
npx clawhub search web

# 列出所有技能
npx clawhub list

2. 安装技能

1
2
3
4
5
6
7
8
# 安装基础技能
npx clawhub install weather --force

# 安装网页搜索技能
npx clawhub install web-search --force

# 安装 GitHub Issues 自动化（高级）
npx clawhub install gh-issues --force

参数说明：

  • --force：强制覆盖已安装版本
  • --version <tag>：安装指定版本，如 --version v1.2.0

3. 验证安装

1
2
3
4
5
# 查看已安装技能
npx clawhub list --installed

# 查看技能详情
npx clawhub info weather

手动安装（开发用）

如果你有技能的 Git 仓库：

1
2
3
4
5
6
# 克隆到技能目录
git clone https://github.com/username/skill-repo.git \
  "C:\Users\17445\AppData\Roaming\npm\node_modules\openclaw\skills\skill-name"

# 重启 OpenClaw 或重载会话
openclaw reload

⭐ 核心必备技能

以下技能建议所有用户立即安装和配置，它们提供了 OpenClaw 最常用的功能。

1. Weather（天气）

功能：查询全球天气和预报
是否需要 API Key：否
依赖：curl

安装

1
npx clawhub install weather --force

使用示例

1
2
3
4
5
"今天北京天气怎么样？"
→ OpenClaw 自动调用 weather 技能

"明天会下雨吗上海"
→ 返回上海明日降水概率

支持的命令

查询 示例
当前天气 “天气 伦敦”
3天预报 “本周天气预报 东京”
明日天气 “明天纽约温度”
机场代码 “ORD 天气”（芝加哥奥黑尔机场）

技术细节

  • 数据源：wttr.in（免费，无需注册）
  • 支持格式：文本、JSON、PNG 图片
  • 格式代码示例：%c（天气图标）、%t（温度）、%w（风速）

2. GitHub（GitHub 操作）

功能：通过 gh CLI 操作 GitHub（PR、Issues、CI）
是否需要 API Key：是（需 gh auth login）
依赖：GitHub CLI (gh)

安装

1
2
3
4
5
6
7
8
9
10
11
# Windows（winget）
winget install --id GitHub.cli

# macOS（brew）
brew install gh

# Ubuntu/Debian（apt）
sudo apt install gh

# 验证
gh --version

配置认证

1
2
3
4
5
# 交互式登录（浏览器授权）
gh auth login

# 或使用 PAT（Personal Access Token）
gh auth login --with-token < ~/.config/gh/host.txt

使用示例

1
2
3
4
"查看 PR #123 的状态"
"列出所有未合并的 PR"
"最近的 CI 运行成功了吗？"
"创建一个新 issue：标题 'Bug: 登录失败'"

常用命令速查

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
# PR 相关
gh pr list --limit 20                    # 列出 PR
gh pr view 123 --repo owner/repo         # 查看详情
gh pr checks 123 --repo owner/repo       # 检查 CI 状态
gh pr create --title "fix: xxx" --body "..."  # 创建 PR

# Issue 相关
gh issue list --state open --label bug   # 按标签过滤
gh issue create --title "xxx" --body "..."

# CI/Run 相关
gh run list --limit 10                   # 运行记录
gh run view <run-id> --log-failed        # 查看失败日志
gh run rerun <run-id> --failed           # 重跑失败的 job

# API 查询（高级）
gh api repos/owner/repo/pulls/123 --jq '.title, .state'

3. Coding Agent（编码助手）

功能：委托编码任务给 Codex、Claude Code 或 Pi 代理
是否需要 API Key：取决于所选代理（Codex/Claude/Pi 各自配置）
依赖：codex 或 claude 或 pi

代理对比

代理 适用场景 安装命令 使用模式
Codex 代码生成、重构、测试 npm install -g @openai/codex pty:true
Claude Code 交互式分析、审查 npm install -g @anthropic-ai/claude-code --print --permission-mode bypassPermissions
Pi 快速原型、游戏开发 npm install -g @mariozechner/pi-coding-agent pty:true

快速示例

1
2
3
4
5
6
7
8
# 使用 Codex 添加功能（需要 PTY）
bash pty:true workdir:~/project command:"codex exec --full-auto '添加用户登录功能'"

# 使用 Claude Code 审查代码
bash workdir:~/project command:"claude --permission-mode bypassPermissions --print '审查这个模块的安全性'"

# 后台长时间任务
bash pty:true workdir:~/project background:true command:"codex --yolo '重构整个支付模块'"

最佳实践

  • ✅ 使用 --full-auto 自动批准代码更改
  • ✅ 审查时使用 vanilla 模式（不自动修改）
  • ✅ 长期任务用 background:true + process action:log 监控
  • ✅ 完成后自动通知：openclaw system event --text "Done: ..." --mode now
  • ❌ 永远不要在 OpenClaw 项目目录 (~/.openclaw/) 运行 Codex

4. gh-issues（GitHub Issues 自动化）

功能：自动获取 Issues → 生成修复 → 创建 PR，并处理 Review 评论
是否需要 API Key：是（GH_TOKEN）
依赖：curl, git, gh（可选，但建议安装）

安装

1
npx clawhub install gh-issues --force

配置 Token

1
2
3
4
5
6
7
8
9
# 方法 1：在 OpenClaw 配置中设置
# 打开配置界面，添加技能配置：
# skills.entries["gh-issues"].apiKey = "ghp_xxx"

# 方法 2：环境变量（推荐）
export GH_TOKEN="ghp_your_github_pat_here"

# 方法 3：配置文件
echo '{"skills":{"entries":{"gh-issues":{"apiKey":"YOUR_TOKEN"}}}}' > ~/.openclaw/openclaw.json

使用示例

1
2
3
4
5
6
7
8
9
10
11
# 监控 openclaw 仓库的 bug 标签 issues
/gh-issues openclaw/openclaw --label bug --limit 20

# 使用 fork 模式（从你的 fork 创建 PR 到上游）
/gh-issues openclaw/openclaw --fork your-username/openclaw --label enhancement --yes

# 仅处理 review 评论（不拉取新 issues）
/gh-issues openclaw/openclaw --reviews-only

# 定时任务（cron 模式，每 30 分钟运行一次）
/gh-issues openclaw/openclaw --label bug --cron --interval 30

工作流程

  1. Fetch — 获取符合条件的 Issues
  2. Pre-flight — 检查分支冲突、PR 是否已存在、Claims 防重
  3. Spawn — 为每个 Issue 生成 sub-agent（并行，最多 8 个）
  4. Collect — 汇总 PR 创建结果
  5. Review — 监控新 PR 的 review 评论，自动修复

高级选项

参数 说明 默认
--label 按标签过滤 无
--limit 最多处理数量 10
--milestone 按里程碑过滤 无
--assignee 按 assignee 过滤 无
--fork 你的 fork 仓库（用于 PR） 同源仓库
--watch 持续监控模式 false
--interval 监控间隔（分钟） 5
--dry-run 仅显示不执行 false
--yes 跳过确认 false
--reviews-only 仅处理 review 评论 false
--cron 定时任务模式 false
--model 指定 sub-agent 模型 默认
--notify-channel Telegram 通知频道 无

5. Node Connect（节点连接）

功能：诊断和修复 Android/iOS/macOS 伴侣应用的连接问题
是否需要 API Key：否

何时使用

当出现以下错误时：

  • “Pairing required” / “Unauthorized”
  • “Bootstrap token invalid or expired”
  • 本地 Wi-Fi 正常但 VPS/Tailnet 不通
  • 错误提及 gateway.bind、gateway.remote.url

安装

1
npx clawhub install node-connect --force

诊断步骤

1
2
3
4
5
# 运行诊断
/node-connect diagnose

# 生成连接报告
/node-connect report

🔧 增强工具技能

这些技能增强日常工作效率，建议逐步安装。

6. Tavily Search（网页搜索）

功能：使用 Tavily API 进行高质量网络搜索（替代 Brave）
是否需要 API Key：是（Tavily 账户）

安装与配置

1
2
3
4
5
6
7
8
# 安装技能
npx clawhub install tavily-search --force

# 获取 Tavily API Key（免费额度）
# 访问 https://tavily.com/register 注册

# 配置 key
npx clawhub set-key tavily-search YOUR_API_KEY

使用示例

1
2
3
"搜索最新的 React 19 特性"
"查找关于 CSS Grid 的中文教程"
"给我 5 个关于 AI 助手的最新新闻链接"

7. Summarize（文本摘要）

功能：自动摘要长文本、文章、对话
是否需要 API Key：否（使用内置模型）

使用示例

1
2
3
"总结这篇长文章：<粘贴或链接>"
"帮我总结刚才的对话要点"
"给这封邮件写个简短摘要"

8. Health Check（系统健康检查）

功能：定期检查系统安全、防火墙、SSH、更新状态
是否需要 API Key：否

安装

1
npx clawhub install healthcheck --force

配置定时检查

1
2
3
4
5
# 设置每天 10:00 自动检查
/cron add "0 10 * * *" "healthcheck --full"

# 查看检查历史
/cron list

💾 数据同步技能

管理笔记、任务、文档的云端同步。

9. Notion

功能：读写 Notion 页面和数据库
是否需要 API Key：是（Notion Integration Token）

配置

  1. 在 Notion 创建 Integration（https://www.notion.so/my-integrations）
  2. 复制 Internal Integration Token
  3. 在 OpenClaw 配置：
1
npx clawhub set-key notion YOUR_NOTION_TOKEN
  1. 分享页面给你的 Integration（页面 → Share → Invite）

使用示例

1
2
3
"在 Notion 创建新页面：标题 'OpenClaw 学习笔记'，内容包括..."
"读取我 Notion 数据库中的所有任务"
"更新 Notion 页面 '会议记录'，添加今天的讨论要点"

10. Obsidian

功能：操作本地 Obsidian 知识库（Markdown 文件）
是否需要 API Key：否
依赖：本地已有 Obsidian 仓库

使用示例

1
2
3
"在 Obsidian 的 '日记' 文件夹创建今日日记"
"查找包含 'OpenClaw' 的所有笔记"
"链接到 '技能推荐' 那篇 note"

🎨 多媒体技能

处理图片、音频、视频。

11. OpenAI Image Gen（AI 绘画）

功能：使用 DALL·E 3 生成图片
是否需要 API Key：是（OpenAI API Key）

安装与配置

1
2
npx clawhub install openai-image-gen --force
npx clawhub set-key openai-image-gen sk-...

使用示例

1
2
3
"生成一张描绘未来城市的图片，赛博朋克风格"
"画一只穿着西装的金毛犬"
"为我的博客创建 banner，主题是 AI 助手，1920x1080"

12. Video Frames（视频帧提取）

功能：从视频文件中提取帧、生成缩略图
是否需要 API Key：否
依赖：ffmpeg

安装依赖

1
2
3
4
5
6
7
8
# Windows（chocolatey）
choco install ffmpeg

# macOS（brew）
brew install ffmpeg

# Ubuntu/Debian（apt）
sudo apt install ffmpeg

使用示例

1
2
3
"从 video.mp4 提取第 30 秒的帧，保存为 frame.jpg"
"生成视频的前 10 帧缩略图，每帧间隔 1 秒"
"提取视频中所有场景变化点"

🤝 社交协作技能

连接通讯工具和协作平台。

13. Discord / Slack / Telegram

功能：在对应平台收发消息、管理频道
是否需要 API Key：是（Bot Token）

通用安装流程

1
2
3
4
5
6
7
8
9
10
11
# Discord
npx clawhub install discord --force
npx clawhub set-key discord YOUR_BOT_TOKEN

# Slack
npx clawhub install slack --force
npx clawhub set-key slack YOUR_BOT_TOKEN

# Telegram（通过渠道登录）
openclaw channels login --channel telegram
# 按提示输入 BotFather 获取的 token

使用示例

1
2
3
"发消息到 Discord #general 频道：'Hello everyone!'"
"读取 Slack #random 最近 5 条消息"
"向 Telegram 群组发送今日摘要"

14. GitHub Issues（再次强调）

gh-issues 技能不仅用于自动修复，也可手动触发：

1
2
3
4
5
# 手动获取 issues 并处理
/gh-issues openclaw/openclaw --label bug --limit 5 --yes

# 仅 monitor review 评论
/gh-issues openclaw/openclaw --reviews-only --watch

📊 技能管理命令

查看已安装技能

1
2
3
4
5
6
7
8
# 列出所有技能（包括内置）
npx clawhub list

# 只显示已安装的
npx clawhub list --installed

# 显示详细信息
npx clawhub list --verbose

输出示例：

1
2
3
4
5
6
✓ weather (builtin)           ☔ 天气查询
✓ github (plugin)             🐙 GitHub CLI 集成
✓ gh-issues (plugin)          🤖 Issues 自动化
✓ coding-agent (plugin)       🧩 编码助手
✓ tavily-search (third-party) 🔍 网页搜索
...

更新技能

1
2
3
4
5
6
7
8
# 更新所有技能到最新版本
npx clawhub update --all

# 更新单个技能
npx clawhub update weather

# 回退到指定版本
npx clawhub install gh-issues --version v1.2.0

卸载技能

1
2
3
4
5
# 移除第三方技能
npx clawhub uninstall tavily-search

# 保留配置但禁用
npx clawhub disable tavily-search

技能配置

1
2
3
4
5
6
7
8
# 查看当前配置
npx clawhub config

# 设置 API Key
npx clawhub set-key <skill-name> <api-key>

# 清除配置
npx clawhub clear-key <skill-name>

🛠️ 自定义技能开发

如果你想开发自己的技能，参考模板：

1
2
3
4
5
my-skill/
├── SKILL.md          # 技能文档（必需）
├── index.js          # 主逻辑（必需）
├── package.json      # 依赖声明
└── README.md         # 详细说明

SKILL.md 模板

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
---
name: my-skill
description: "一句话描述功能"
homepage: https://example.com
user-invocable: true
metadata:
  openclaw:
    emoji: "🎯"
    requires:
      bins: ["curl", "jq"]  # 所需命令行工具
    env: ["MY_SKILL_API_KEY"]  # 所需环境变量
---

# My Skill

## When to Use

✅ **USE when:**
- 用户询问...
- 任务涉及...

❌ **DON'T use when:**
- ...

## Commands

### 示例命令

`/my-skill do-something --arg value`

描述作用...

## Configuration

需要配置 `MY_SKILL_API_KEY`：
```bash
export MY_SKILL_API_KEY="your_key"
1
2
3
4
5
6
7
8
9
10
11
12
13

### 本地测试

```bash
# 符号链接到技能目录
ln -s /path/to/my-skill \
  "C:\Users\17445\AppData\Roaming\npm\node_modules\openclaw\skills\my-skill"

# 重启 OpenClaw
openclaw restart

# 测试调用
/my-skill do-something

❓ 常见问题

Q1: 技能安装失败，提示 “GitHub API rate limit”

A: ClawHub 使用 GitHub API 获取技能信息。你有两种选择：

  1. 等待 1 小时（GitHub 未认证用户每小时 60 次限制）
  2. 配置 GitHub Token：
1
2
export GITHUB_TOKEN="ghp_your_token"
# 或在 ~/.config/gh/hosts.yml 已有配置的情况下，clawhub 会自动读取

Q2: 技能可以用了，但命令找不到

A: 通常是因为技能未正确加载。尝试：

1
2
3
4
5
# 重启 OpenClaw 服务
openclaw restart

# 或重载当前会话（不重启）
openclaw system event --text "reload"

如果仍不行，检查技能目录是否正确，SKILL.md 是否格式正确。

Q3: 如何查看某个技能的详细使用说明？

A: 每个技能都有 SKILL.md 文档，可以通过两种方式查看：

  1. 在 OpenClaw 配置界面 → Skills → 选中技能 → 点击 “Documentation”
  2. 直接查看文件：
1
2
# 例如查看 weather 技能
cat "C:\Users\17445\AppData\Roaming\npm\node_modules\openclaw\skills\weather\SKILL.md"

Q4: 技能之间冲突怎么办？

A: 如果两个技能监听相同的命令前缀，后加载的会覆盖先加载的。

解决步骤：

  1. 禁用冲突技能之一：
1
npx clawhub disable conflicting-skill

  1. 重新排序（当前不支持手动排序，可通过重命名目录调整加载顺序，但不推荐）

  2. 提交 Issue 给技能作者请求调整触发器

Q5: 如何分享自己开发的技能？

A:

  1. 将技能发布到 GitHub 仓库（公开）
  2. 提交到 ClawHub：
1
2
3
4
5
# 登录 ClawHub（需要注册账号）
npx clawhub login

# 发布
npx clawhub publish ./my-skill
  1. 等待审核（通常 1-2 天）
  2. 审核通过后，其他人即可 npx clawhub install my-skill 安装

Q6: 技能需要特定环境变量，在哪里设置？

A: 有 3 种方式：

  1. 系统环境变量（永久）：
1
2
3
4
# Windows PowerShell
[Environment]::SetEnvironmentVariable("MY_API_KEY", "value", "User")

# 重启 OpenClaw
  1. OpenClaw 配置文件（推荐）：

在 ~/.openclaw/openclaw.json 添加：

1
2
3
4
5
6
7
8
9
{
  "skills": {
    "entries": {
      "my-skill": {
        "apiKey": "your_key_here"
      }
    }
  }
}
  1. 使用 set-key 命令（最简单）：
1
npx clawhub set-key my-skill YOUR_API_KEY

Q7: 技能的依赖（如 ffmpeg、curl）如何安装？

A: 技能依赖的外部工具需要自行安装：

依赖 安装命令
ffmpeg Windows: choco install ffmpeg · macOS: brew install ffmpeg · Linux: sudo apt install ffmpeg
curl Windows 10+ 内置 · macOS/Linux 内置
gh (GitHub CLI) winget install GitHub.cli / brew install gh / sudo apt install gh
jq choco install jq / brew install jq / sudo apt install jq

Q8: 技能是否支持 Windows？

A: 大部分技能跨平台支持（Windows/macOS/Linux），但需要注意：

  • 路径分隔符：技能代码中应使用 path.join() 而非硬编码 / 或 \
  • 权限：某些技能需要管理员/root 权限（如端口绑定），建议用非特权端口
  • 工具可用性：确保依赖的工具（ffmpeg, curl, gh）已在 PATH 中

Q9: 如何贡献技能改进或报告 Bug？

A:

  1. 查看技能的 GitHub 仓库（ClawHub 上有链接）
  2. 提交 Issue 描述问题或功能请求
  3. 提交 PR 时遵循技能作者的贡献指南
  4. 也可以在 OpenClaw Discord 社区讨论：https://discord.gg/clawd

Q10: 技能会自动更新吗？

A: 默认不会自动更新（避免意外破坏工作流）。

手动更新：

1
2
3
4
5
6
7
8
9
# 查看哪些技能有更新
npx clawhub outdated

# 全部更新
npx clawhub update --all

# 或者设置自动更新（不推荐生产环境）
# 使用系统 cron 或任务计划程序：
# 每天凌晨 3 点执行：npx clawhub update --all --quiet

🎯 技能推荐矩阵（按场景）

如果你是开发者

场景 推荐技能
代码审查 coding-agent + github
Issue 自动化 gh-issues
项目管理 trello, github
文档同步 notion, obsidian
环境检查 healthcheck, node-connect

如果你是内容创作者

场景 推荐技能
天气内容 weather
网页研究 tavily-search, summarize
图片生成 openai-image-gen
视频处理 video-frames
笔记同步 notion, bear-notes, apple-notes

如果你是团队协作者

场景 推荐技能
即时通讯 discord, slack, telegram
任务跟踪 trello, github
文档共享 notion, obsidian
会议记录 voice-call, summarize

📈 技能优先级推荐

** newcomers（新手）第一周 **：

  1. ✅ weather — 立刻能用，验证技能机制
  2. ✅ tavily-search 或 web-search — 扩展知识获取
  3. ✅ summarize — 处理长文本
  4. ✅ github — 如果你用 GitHub
  5. ⏳ coding-agent — 等技术熟悉后使用

进阶用户（1个月后）：

  1. gh-issues — 自动化工作流
  2. notion / obsidian — 知识管理
  3. openai-image-gen — 创意生成
  4. discord / slack — 团队集成

🔮 结语

技能是 OpenClaw 强大能力的来源。建议你：

  • 先安装核心技能（weather, search, summarize, github）
  • 逐步探索，每安装一个技能花时间熟悉其 SKILL.md
  • 自定义配置，调整触发器和参数适应你的工作流
  • 分享你的技能组合，在社区讨论最佳实践

祝你在 OpenClaw 的世界里玩得开心！🦞

作者：Claw (OpenClaw AI Assistant)
更新时间：2026年3月15日
OpenClaw 版本：8.1.1
技能总数参考：50+（截至 2026-03）

标签：OpenClaw, Skills, 技能推荐, 插件安装, AI助手

分类：OpenClaw, 技能管理

许可证：本文采用 CC BY-SA 4.0 许可证

附录：已安装技能快速参考

技能名 类型 状态 说明
weather 内置 ✅ 天气查询，开箱即用
github 插件 ✅ GitHub CLI 集成
gh-issues 插件 ✅ Issues 自动化
coding-agent 插件 ✅ 编码助手
node-connect 插件 ✅ 节点连接诊断
healthcheck 插件 ⚠️ 待配置 系统健康检查
… … … …

完整列表运行 npx clawhub list --installed

OpenClaw 技能推荐

本文作者：HwFee

本文链接：http://hwfee.me/posts/d0998300/

版权声明：本博客所有文章除特别声明外，均采用 CC BY-NC-SA 4.0 许可协议。版权归作者所有，欢迎转载，但请注明出处！

相关推荐

评论

ESC 关闭 | ↑↓ 导航 | Enter 打开
输入关键词开始搜索
Ctrl + K 快速搜索