本书共 20 章，分为 4 大部分，全面讲解 OpenClaw 自定义技能与扩展开发。第一部分介绍开发环境、工具链和第一个 Skill 的创建；第二部分深入 SKILL.md 规范、参数验证、错误处理和实战案例；第三部分讲解自定义 Channel 开发、消息适配器和 Webhook 配置；第四部分探讨性能优化、安全审计、发布共享和商业化策略。
ClawHub · 5400+ 技能库 · 分类体系 · 热门技能分析 · 生态趋势
OpenClaw 技能（Skills）是扩展 AI 助手能力的核心机制。通过 SKILL.md 文件，开发者可以教会 AI 执行特定任务，从简单的文件操作到复杂的企业系统集成。
技能不是传统意义上的代码库，而是自然语言指令 + 执行示例的组合：
ClawHub 是 OpenClaw 的官方技能市场，类似于 npm 对于 Node.js、PyPI 对于 Python：
# 浏览技能市场
clawhub browse
# 搜索技能
clawhub search pdf
# 安装技能
clawhub install feishu-bitable-skill
# 更新所有技能
clawhub update --all
# 查看已安装技能
clawhub list
# 卸载技能
clawhub uninstall skill-namecurl -fsSL https://raw.githubusercontent.com/Larkin0302/feishu-bitable-skill/main/install.sh | bash，全自动完成依赖检查、权限引导和配置写入。| 分类 | 技能数量 | 代表技能 | 使用场景 |
|---|---|---|---|
| 📊 数据分析 | 872 | 飞书多维表格、钉钉 AI 表格、Excel 处理 | 企业数据管理、报表生成、数据清洗 |
| 🌐 网络爬虫 | 654 | 网页抓取、SEO 分析、竞品监控 | 市场调研、价格监控、内容聚合 |
| 📁 文件处理 | 523 | PDF 解析、图片压缩、格式转换 | 文档管理、批量处理、自动化办公 |
| 💬 IM 集成 | 412 | 飞书机器人、钉钉助手、企业微信 | 团队协作、客户支持、通知推送 |
| 🔧 开发工具 | 389 | Git 操作、代码审查、API 测试 | 软件开发、DevOps、持续集成 |
| 🏥 医疗健康 | 267 | 临床辅助、基因组学、药物发现 | 医疗研究、诊断辅助、健康管理 |
GitHub: github.com/Larkin0302/feishu-bitable-skill
---
name: feishu-bitable
description: 飞书多维表格的完整生命周期管理 — 从零搭建 + 日常 CRUD
license: MIT
metadata:
openclaw:
os: ["darwin", "linux"]
requires:
bins: ["curl", "bash"]
category: data-analysis
difficulty: intermediate
---
# 技能指令
## 概述
本技能帮助你在飞书中从零创建和管理多维表格...
## 使用示例
用户：帮我创建一个项目管理表格
助手：好的，我将创建一个包含任务、负责人、进度的多维表格...特色：OpenClaw 自主操作 Claude Code 开发的完整产品
---
name: my-awesome-skill
description: 用一句话清晰描述技能功能（1-1024 字符）
license: MIT
compatibility:
openclaw: ">=2026.1.0"
metadata:
openclaw:
os: ["darwin", "linux", "win32"]
requires:
bins: ["curl", "jq"]
env: ["API_KEY"]
category: productivity
difficulty: beginner
tags: ["automation", "file-processing"]
author: "Your Name "
version: "1.0.0"
homepage: "https://github.com/you/my-skill"
---
# 技能名称
## 概述
用 2-3 段话详细描述技能的功能、适用场景和核心价值。
说明用户可以从这个技能获得什么收益。
## 前置条件
- 需要安装的依赖：curl, jq
- 需要配置的环境变量：API_KEY
- 需要的权限：文件系统读写、网络访问
## 参数定义
| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|--------|------|------|--------|------|
| input_file | string | 是 | - | 输入文件路径 |
| output_dir | string | 否 | ./output | 输出目录 |
| verbose | boolean | 否 | false | 是否输出详细日志 |
## 使用示例
### 示例 1：基本用法
用户：帮我处理 report.pdf
助手：好的，我将处理 report.pdf 并保存到 output 目录...
### 示例 2：带参数
用户：处理 input.txt，输出到 /tmp/results
助手：收到，正在处理 input.txt，结果将保存到 /tmp/results...
## 执行步骤
1. 验证输入文件是否存在
2. 检查环境变量 API_KEY 是否配置
3. 调用外部 API 进行处理
4. 保存结果到指定目录
5. 返回处理摘要和文件路径
## 错误处理
- 文件不存在：提示用户提供正确路径
- API 调用失败：重试 3 次后返回友好错误信息
- 权限不足：指导用户如何授予必要权限
## 性能优化
- 大文件分块处理，避免内存溢出
- 使用缓存减少重复 API 调用
- 并发处理多个独立任务
## 安全注意事项
- 不存储敏感数据
- API 密钥通过环境变量传递
- 所有文件操作限制在工作区内
## 测试方法
```bash
# 运行单元测试
npm test
# 手动测试
echo "test content" > test.txt
openclaw agent --message "处理 test.txt"
```
## 常见问题
**Q: 遇到 "API_KEY not found" 错误怎么办？**
A: 在 ~/.openclaw/.env 文件中添加 API_KEY=your_key_here
**Q: 如何处理超过 100MB 的大文件？**
A: 技能会自动分块处理，但建议先压缩文件
## 更新日志
- v1.0.0 (2026-03-12): 初始版本发布
- v1.0.1 (2026-03-15): 修复文件路径解析 bug
- v1.1.0 (2026-03-20): 新增并发处理支持
## 参考资源
- [官方文档](https://docs.openclaw.ai/skills)
- [GitHub 仓库](https://github.com/you/my-skill)
- [问题反馈](https://github.com/you/my-skill/issues)| 步骤 | 检查项 | 命令/操作 | 预计时间 |
|---|---|---|---|
| 1. 代码审查 | 无硬编码密钥、权限最小化、错误处理完善 | git diff, grep -r "API_KEY" | 30 分钟 |
| 2. 文档完善 | SKILL.md 完整、README 清晰、示例充分 | markdownlint SKILL.md | 1 小时 |
| 3. 测试验证 | 单元测试通过、手动测试通过、边界条件覆盖 | npm test, manual testing | 2 小时 |
| 4. 版本打包 | 语义化版本号、CHANGELOG 更新、Git Tag | npm version patch, git tag | 15 分钟 |
| 5. 提交审核 | 填写 ClawHub 表单、等待审核（1-3 天） | clawhub publish | 10 分钟 + 审核时间 |
| 6. 发布推广 | 社交媒体宣传、社区分享、收集反馈 | Twitter, Discord, Forum | 持续 |