技能与扩展

约 1632 字大约 5 分钟

2026-03-02

什么是 Skills

Skills（技能）是 OpenClaw 的能力扩展单元，类似于插件或应用。它们运行在 Agent 上下文中，可以连接到浏览器、画布、节点、定时任务、会话与外部服务，极大地扩展 OpenClaw 的能力边界。

Skills 的特点

模块化设计：每个 Skill 对应一组特定功能
即插即用：安装后立即可用，无需重启
生态丰富：ClawHub 提供大量第三方 Skills
可自定义：支持开发自己的 Skills

ClawHub 技能市场

什么是 ClawHub

ClawHub 是 OpenClaw 官方的技能市场，提供了丰富的第三方 Skills。访问地址：https://clawhub.ai/

安装 ClawHub CLI

npm install -g clawhub

使用 ClawHub

搜索 Skills

# 搜索浏览器相关的 Skills
clawhub search browser

# 搜索 GitHub 相关的 Skills
clawhub search github

# 搜索天气相关的 Skills
clawhub search weather

查看 Skill 详情

clawhub info <skill-name>

安装 Skills

# 安装指定的 Skill
clawhub install <skill-name>

# 安装特定版本
clawhub install <skill-name>@1.2.3

# 从 GitHub 安装
clawhub install github:username/repo

更新 Skills

# 更新所有 Skills
clawhub update

# 更新特定 Skill
clawhub update <skill-name>

卸载 Skills

clawhub uninstall <skill-name>

管理已安装的 Skills

查看已安装的 Skills

openclaw skills list

输出示例：

✓ browser (v1.2.0) - ready
✓ github (v2.1.5) - ready
✓ weather (v1.0.3) - ready
⚠ calendar (v0.9.1) - error

状态说明：

ready（绿色）：Skill 正常运行
loading（黄色）：Skill 正在加载
error（红色）：Skill 出现错误
disabled（灰色）：Skill 已禁用

启用/禁用 Skills

# 禁用 Skill
openclaw skills disable <skill-name>

# 启用 Skill
openclaw skills enable <skill-name>

查看 Skill 日志

# 查看特定 Skill 的日志
openclaw logs --skill browser

# 实时查看日志
openclaw logs --skill browser --follow

常用 Skills 推荐

Browser - 浏览器自动化

功能：网页访问、搜索、抓取、表单操作

安装：

clawhub install browser

使用示例：

打开浏览器，用 Google 搜索 "OpenClaw"

适用场景：

网页内容抓取
自动化表单填写
网页截图
搜索引擎查询

GitHub - 代码仓库管理

功能：PR 审查、Issue 管理、代码搜索

安装：

clawhub install github

使用示例：

帮我审查这个 PR：https://github.com/user/repo/pull/123

适用场景：

自动化 PR 审查
Issue 跟踪和管理
代码搜索和分析
仓库统计

Weather - 天气查询

功能：实时天气、天气预报

安装：

clawhub install weather

使用示例：

北京今天天气怎么样？

Calendar - 日程管理

功能：日程查询、创建事件、提醒

安装：

clawhub install calendar

使用示例：

明天下午3点提醒我开会

Email - 邮件管理

功能：邮件发送、收件箱管理、邮件分类

安装：

clawhub install email

使用示例：

发送邮件给 example@email.com，主题是"会议通知"

Todoist - 待办事项

功能：任务管理、项目组织

安装：

clawhub install todoist

使用示例：

添加待办事项：完成项目文档

Reddit - Reddit 内容聚合

功能：热门帖子、评论搜索、订阅管理

安装：

clawhub install reddit

使用示例：

获取 r/programming 今天的热门帖子

Skills 配置

配置 Skill 参数

某些 Skills 需要额外的配置（如 API Key）：

# 编辑 Skill 配置
openclaw skills config <skill-name>

或直接编辑配置文件：

~/.openclaw/skills/<skill-name>/config.json

示例：配置 GitHub Skill

{
  "github": {
    "token": "ghp_your_github_token",
    "defaultOrg": "your-org",
    "autoReview": true
  }
}

示例：配置 Weather Skill

{
  "weather": {
    "apiKey": "your_weather_api_key",
    "defaultLocation": "Beijing",
    "units": "metric"
  }
}

工作流与自动化

使用工作流串联 Skills

可以将多个 Skills 串联起来，构建复杂的自动化流程：

示例 1：每日新闻简报

每天早上8点：
1. 使用 Browser Skill 抓取科技新闻
2. 使用 AI 总结新闻内容
3. 通过 Telegram 发送给我

配置方式：

openclaw workflows create daily-news

示例 2：GitHub PR 自动审查

当有新 PR 时：
1. 使用 GitHub Skill 获取 PR 内容
2. 使用 AI 分析代码变更
3. 自动添加审查评论
4. 通过 Discord 通知团队

示例 3：Reddit 内容摘要

每天晚上9点：
1. 使用 Reddit Skill 获取订阅的 Subreddit 热门帖子
2. 使用 AI 生成摘要
3. 通过飞书发送到工作群

使用 Heartbeat 定时任务

Heartbeat 是 OpenClaw 的定时任务系统：

# 创建定时任务
openclaw heartbeat create

# 列出所有定时任务
openclaw heartbeat list

# 删除定时任务
openclaw heartbeat remove <task-id>

开发自定义 Skills

Skill 开发基础

Skills 使用 JavaScript/TypeScript 开发，遵循标准的插件架构。

创建新 Skill

# 使用脚手架创建
openclaw skills create my-skill

# 进入 Skill 目录
cd ~/.openclaw/skills/my-skill

Skill 目录结构

my-skill/
├── package.json       # 包配置
├── index.js          # 入口文件
├── config.json       # Skill 配置
├── README.md         # 说明文档
└── tests/            # 测试文件

基础 Skill 模板

// index.js
module.exports = {
  name: 'my-skill',
  version: '1.0.0',
  description: '我的自定义 Skill',
  
  // Skill 初始化
  async init(context) {
    console.log('Skill 已加载');
  },
  
  // 定义 Skill 能力
  capabilities: {
    // 定义一个命令
    async myCommand(params) {
      return {
        success: true,
        message: '命令执行成功',
        data: params
      };
    }
  },
  
  // Skill 卸载
  async destroy() {
    console.log('Skill 已卸载');
  }
};

测试 Skill

# 在开发模式下加载 Skill
openclaw skills load ./my-skill --dev

# 运行测试
npm test

发布 Skill

# 发布到 ClawHub
clawhub publish

# 或发布到 npm
npm publish

安全与最佳实践

安全要点

只安装可信来源的 Skills
- 优先选择官方或知名开发者的 Skills
- 查看 Skill 的评分和下载量
- 阅读 Skill 的源码（如果开源）

关注版本与来源信息

# 查看 Skill 详细信息
clawhub info <skill-name>

为关键 Skills 开启日志与审计

# 启用审计日志
openclaw skills audit enable <skill-name>

# 查看审计日志
openclaw logs --skill <skill-name> --audit

定期更新 Skills

# 检查更新
clawhub outdated

# 更新所有 Skills
clawhub update

最佳实践

按需安装：不要安装过多不必要的 Skills
定期清理：卸载不再使用的 Skills
监控性能：关注 Skills 的资源占用
备份配置：定期备份 Skills 配置文件
测试环境：在测试环境中先验证新 Skills

权限管理

某些 Skills 需要特定权限：

{
  "skills": {
    "browser": {
      "permissions": ["network", "filesystem"],
      "sandbox": true
    },
    "github": {
      "permissions": ["network"],
      "apiAccess": true
    }
  }
}

故障排查

Skill 无法加载

# 查看详细错误信息
openclaw skills list --verbose

# 检查依赖
cd ~/.openclaw/skills/<skill-name>
npm install

# 重新加载 Skill
openclaw skills reload <skill-name>

Skill 运行错误

# 查看错误日志
openclaw logs --skill <skill-name> --level error

# 重启 Skill
openclaw skills restart <skill-name>

# 重置 Skill 配置
openclaw skills reset <skill-name>

性能问题

# 查看 Skill 性能统计
openclaw skills stats

# 禁用占用资源过多的 Skill
openclaw skills disable <skill-name>