社区插件
Community Plugins（社区插件）是由第三方开发者为 OpenClaw 构建的扩展包。它们通过 npm 包或 OpenClaw 插件注册中心分发，覆盖渠道接入、工具扩展、Hook 集成等多种场景。
插件生态概览
OpenClaw 的插件生态围绕三个核心类型构建：
| 类型 | 说明 | 示例 |
|---|---|---|
| Channel（渠道） | 接入新的消息平台 | Zalo、LINE、Slack |
| Tool（工具） | 为 Agent 添加新能力 | 图片生成、CRM 查询 |
| Hook（钩子） | 拦截和处理系统事件 | 消息日志、审计追踪 |
搜索插件
使用 CLI 搜索可用的社区插件：
bash
# 搜索所有社区插件
openclaw plugins search
# 按关键词搜索
openclaw plugins search voice
# 按类型过滤
openclaw plugins search --type channel
openclaw plugins search --type tool插件命名约定
官方插件以 @openclaw/ 为前缀，社区插件通常以 openclaw-plugin- 为前缀。
安装插件
bash
# 安装官方插件
openclaw plugins install @openclaw/voice-call
# 安装社区插件
openclaw plugins install openclaw-plugin-notion
# 安装指定版本
openclaw plugins install @openclaw/voice-call@1.2.0
# 从 npm 安装
npm install openclaw-plugin-custom --save安装后在 openclaw.config.yaml 中启用：
yaml
plugins:
- name: '@openclaw/voice-call'
enabled: true
config:
provider: twilio
- name: 'openclaw-plugin-notion'
enabled: true热门社区插件
渠道类插件
| 插件名 | 说明 | 维护状态 |
|---|---|---|
@openclaw/zalo-oa | Zalo Official Account 接入 | ✅ 活跃 |
@openclaw/zalouser | Zalo 个人号接入 | ✅ 活跃 |
@openclaw/line | LINE Messaging API | ✅ 活跃 |
openclaw-plugin-slack | Slack Bot 集成 | ✅ 活跃 |
openclaw-plugin-teams | Microsoft Teams 接入 | 🔶 维护中 |
工具类插件
| 插件名 | 说明 | 维护状态 |
|---|---|---|
@openclaw/web-search | 网页搜索集成 | ✅ 活跃 |
@openclaw/code-sandbox | 安全代码执行沙盒 | ✅ 活跃 |
openclaw-plugin-notion | Notion API 工具 | ✅ 活跃 |
openclaw-plugin-github | GitHub 操作工具 | ✅ 活跃 |
集成类插件
| 插件名 | 说明 | 维护状态 |
|---|---|---|
openclaw-plugin-webhook | Webhook 事件转发 | ✅ 活跃 |
openclaw-plugin-analytics | 使用分析与统计 | 🔶 维护中 |
安全注意事项
第三方插件安全
社区插件由第三方开发者维护，安装前请注意以下风险：
- 审查源码 — 安装前查看 GitHub 仓库的代码
- 检查权限 — 了解插件需要的系统权限和 API 权限
- 版本锁定 — 使用精确版本号避免意外升级
- 隔离环境 — 在测试环境中先行验证插件行为
- 社区反馈 — 查看 npm 下载量、issue 和最近更新时间
bash
# 查看插件详情和安全信息
openclaw plugins info openclaw-plugin-notion
# 列出已安装插件
openclaw plugins list
# 卸载插件
openclaw plugins uninstall openclaw-plugin-notion贡献插件
开发自己的插件并发布到社区：
bash
# 使用脚手架创建插件项目
openclaw plugins create my-plugin
# 本地开发测试
openclaw plugins link ./my-plugin
# 发布到 npm
cd my-plugin && npm publish详细开发规范请参阅 插件清单。
🇨🇳 中国用户须知
- npm 安装速度慢时，使用淘宝镜像：
npm config set registry https://registry.npmmirror.com - 国内社区插件项目可发布到 npm 或 Gitee 分发
- 搜索国内适用插件时可关注
openclaw-plugin-cn-*前缀