本书共 20 章,分为 4 大部分,全面讲解 OpenClaw 插件开发与生态构建。第一部分深入插件架构,包括生命周期管理、Hook 机制、RPC 通信、配置验证;第二部分详解 Plugin SDK,涵盖核心 API、Channel 插件开发、工具注册、Gateway 路由、CLI 命令;第三部分提供实战案例,包括飞书/钉钉集成、记忆后端实现、监控面板、语音通话插件;第四部分探讨生态运营,包括发布流程、安全审计、ClawHub 市场、商业化模式。
什么是插件 · 官方插件列表 · 应用场景 · 生态价值 · 为什么需要插件系统
OpenClaw 插件是一个小型代码模块,用于扩展 OpenClaw 的核心功能,包括命令、工具、Gateway RPC 方法、HTTP 路由、后台服务等。插件让你能够在不修改核心代码的情况下,为 OpenClaw 添加新功能或保持可选功能独立于主安装。
| 插件名称 | NPM 包 | 功能描述 | 状态 |
|---|---|---|---|
| Microsoft Teams | @openclaw/msteams |
Bot Framework 集成,支持企业工作区、频道、私信 | ✅ 稳定 |
| Zalo Personal | @openclaw/zalouser |
越南 Zalo 个人账号二维码登录,支持私聊和群聊 | ✅ 稳定 |
| Matrix | @openclaw/matrix |
去中心化 Matrix 协议支持,兼容 Element/Synapse | ✅ 稳定 |
| Nostr | @openclaw/nostr |
基于 NIP-04 的去中心化私信协议 | 🧪 Beta |
| Zalo | @openclaw/zalo |
Zalo Bot API 企业版,支持 webhook 和菜单命令 | ✅ 稳定 |
| LINE | @openclaw/line |
LINE Messaging API 机器人,支持富媒体消息 | ✅ 稳定 |
| Mattermost | @openclaw/mattermost |
自托管 Mattermost 团队聊天集成 | ✅ 稳定 |
| Nextcloud Talk | @openclaw/nextcloud-talk |
Nextcloud 自托管聊天 webhook 机器人 | 🧪 Beta |
| Twitch | @openclaw/twitch |
Twitch 聊天 IRC 连接,支持直播互动 | 🧪 Beta |
| Tlon (Urbit) | @openclaw/tlon |
基于 Urbit 的去中心化消息应用 | 🔬 Experimental |
| 插件名称 | NPM 包 | 功能描述 | 状态 |
|---|---|---|---|
| Voice Call | @openclaw/voice-call |
Twilio 电话集成,支持 TTS/STT、实时转写、会议桥接 | ✅ 稳定 |
| Memory LanceDB | @openclaw/memory-lancedb |
向量数据库记忆后端,支持语义搜索和自动召回 | ✅ 稳定 |
| OpenProse | @openclaw/open-prose |
高级文本生成和编辑工具,支持风格迁移 | 🧪 Beta |
| Diagnostics OTel | @openclaw/diagnostics-otel |
OpenTelemetry 链路追踪,集成 Prometheus/Grafana | 🧪 Beta |
| 插件名称 | 认证方式 | 支持的模型提供商 | 状态 |
|---|---|---|---|
| Google Antigravity OAuth | OAuth 2.0 | Gemini / PaLM | ✅ 稳定 |
| Gemini CLI OAuth | OAuth + Device Code | Gemini CLI | ✅ 稳定 |
| Qwen Portal Auth | API Key / OAuth | 通义千问 (阿里云) | ✅ 稳定 |
| Copilot Proxy | VS Code 代理桥接 | GitHub Copilot | 🧪 Beta |
| MiniMax Portal Auth | API Key | MiniMax-M2.5 / ABAB | ✅ 稳定 |
@openclaw/msteams。内置的 Teams 支持已弃用。企业通常使用飞书、钉钉、企业微信等内部 IM 工具。通过开发专用 Channel 插件,可以将 OpenClaw 无缝集成到现有工作流中:
---
name: feishu-bitable-crud
description: 飞书多维表格的完整生命周期管理 — 从零搭建 + 日常 CRUD
metadata: { "openclaw": { "requires": { "env": ["FEISHU_APP_ID", "FEISHU_APP_SECRET"] }, "primaryEnv": "FEISHU_APP_ID" } }
---
# 飞书多维表格技能
## 能力
- 从零搭建:描述业务需求 → AI 自动分析、设计表结构、调用 API 创建多维表格
- 日常操作:查询记录、批量导入、字段管理、视图管理、筛选排序
- 无默认字段问题:通过自研脚本在创建时直接指定字段
## 使用方法
/bitabase create <表名> <字段定义>
/bitabase list <app_token>
/bitabase insert <app_token> <table_id> --data <JSON>
默认的 SQLite 记忆后端可能无法满足大规模部署需求。通过开发 Memory 插件,可以接入专业向量数据库:
企业级部署需要完善的监控体系。通过插件可以集成主流可观测性工具:
Voice Call 插件将 OpenClaw 扩展到电话渠道:
ClawHub 是 OpenClaw 的官方插件和技能市场,类似于 npm、VS Code Marketplace 或 Chrome Web Store:
clawhub install <skill-slug> 一键安装clawhub update --all 批量升级已安装的插件clawhub sync --all 扫描并发布更新插件生态为开发者提供了多种变现途径:
package.json 包含 openclaw.extensions 字段openclaw plugins install ./your-plugin 验证功能npm publish --access public(需 @openclaw scope 或自有 scope)ClawHub 使用多维度评分系统决定插件排名:
| 因素 | 权重 | 说明 |
|---|---|---|
| 安装量 | 35% | 过去 30 天新增安装数(衰减加权) |
| 用户评分 | 25% | 平均星级(1-5 星)× 评价数量系数 |
| 活跃度 | 20% | 更新频率、Issue 响应速度、PR 合并数 |
| 安全性 | 15% | 安全审计得分、漏洞数量、权限最小化程度 |
| 文档质量 | 5% | README 完整度、示例代码、视频教程 |
| 分成阶梯 | 开发者比例 | 平台比例 | 条件 |
|---|---|---|---|
| 标准 tier | 70% | 30% | 所有新上架插件默认 |
| 白银 tier | 80% | 20% | 月流水 ≥ $5,000 且评分 ≥ 4.5 |
| 黄金 tier | 85% | 15% | 月流水 ≥ $20,000 且评分 ≥ 4.7 |
| 铂金 tier | 90% | 10% | 月流水 ≥ $100,000 且评分 ≥ 4.8 |
| 独家合作 | 95% | 5% | 签署独家协议,承诺不在其他平台发布 |
模式:基础功能永久免费,高级功能需付费解锁。
模式:按月/年收费,持续提供价值和服务。
模式:根据实际使用量收费,如 API 调用次数、Token 消耗、存储空间。
模式:为大客户提供专属定制开发,一次性收费 + 年度维护费。
模式:提供部署、培训、运维支持等专业服务,按时间或项目收费。
| 模式 | 启动难度 | 收入稳定性 | scalability | 适合阶段 |
|---|---|---|---|---|
| 免费增值 | ⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐⭐⭐ | 早期获客 |
| 订阅制 | ⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ | 成长期 |
| 按量计费 | ⭐⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐⭐⭐ | 成熟期 |
| 企业定制 | ⭐⭐⭐⭐⭐ | ⭐⭐ | ⭐⭐ | 品牌建立后 |
| 咨询服务 | ⭐⭐ | ⭐⭐⭐ | ⭐⭐ | 全阶段 |