如何把自己的插件贡献给OpenClaw社区收录

核心理念：OpenClaw 的生态繁荣依赖于社区。社区欢迎高质量的第三方插件，但必须确保它们安全、可用且有人维护。 适用人群：希望发布自定义插件的开发者、希望将插件加入官方文档列表的维护者。

🏆 一、收录标准：什么样的插件能进入官方列表？

OpenClaw 官方文档中的“社区插件 (Community Plugins)”列表不仅仅是一个链接集合，它是经过筛选的高质量插件认证名单。要想让你的插件被收录，必须满足以下四大硬性指标：

1. ✅ 必须发布到 NPM

• 要求：插件包必须正式发布在 npmjs.com 上。
• 原因：确保用户可以通过标准命令一键安装。
• 验证：用户必须能通过 openclaw plugins install <npm-spec> 成功安装。
  • 错误示例：仅提供 GitHub 下载链接或私有源。
  • 正确示例：@myorg/openclaw-weather 已在 NPM 公开。

2. ✅ 源代码必须开源 (GitHub)

• 要求：源码必须托管在公开的 GitHub 仓库中。
• 原因：透明度是安全的基石。用户和审核者需要能够审查代码，确认没有恶意逻辑。
• 注意：GitLab 或其他平台暂不支持作为主要收录依据（除非有特殊镜像）。

3. ✅ 完善的文档与反馈渠道

• README 必备：仓库根目录必须包含清晰的 README.md，涵盖：
  • 功能介绍：这个插件做什么？
  • 安装步骤：如何安装？
  • 配置指南：需要哪些环境变量或配置文件？
  • 使用示例：具体的调用案例。
• Issue 追踪：必须开启 GitHub Issues 功能，作为用户反馈 Bug 和提出需求的主要渠道。

4. ✅ 明确的维护信号 (Maintenance Signal)

这是最关键的一点。我们拒绝“僵尸插件”。你的项目必须展示出其是活着的：

• 活跃的维护者：有明确的 Owner 或团队负责。
• 近期更新：最近几个月内有 Commit 或版本发布。
• 响应速度：对用户提交的 Issue 有回应（即使只是标记“收到，正在看”）。

❌ 拒收情况：

• 简单的“套壳”包装（Low-effort wrappers），没有实际增值。
• 作者不明或无法联系。
• 长期未更新且 Issue 堆积如山。

📝 二、提交流程：如何申请收录？

如果你的插件满足上述所有条件，可以通过 Pull Request (PR) 申请加入官方文档列表。

步骤 1: 准备信息

整理好以下五项核心信息：

1. 插件名称 (Plugin Name)
2. NPM 包名 (npm package name)
3. GitHub 仓库链接 (Repo URL)
4. 一句话简介 (One-line description)：清晰概括核心功能。
5. 安装命令 (Install command)：方便用户复制。

步骤 2: 发起 PR

1. Fork OpenClaw 官方文档仓库。
2. 找到社区插件列表页面（通常是 docs/community-plugins.md 或类似路径）。
3. 按照下方的标准格式添加你的插件条目。
4. 提交 PR，标题格式建议为：docs: Add community plugin [Your Plugin Name]。

步骤 3: 等待审核

维护者将根据“审核标准 (Review Bar)”进行检查。如果通过，PR 会被合并，你的插件将正式出现在官方文档中。

📏 三、审核标准 (Review Bar)

我们在合并 PR 时会重点考察以下维度：

💡 提示：如果你的插件是一个实验性项目（Demo），建议在描述中标注 [Experimental]，但这可能会降低被收录的优先级，除非它极具创新性。

📋 四、标准提交格式模板

为了保证文档整洁统一，请严格使用以下 Markdown 格式编写你的条目：

- **[插件显示名称]** — 一句话简短描述，突出核心功能。
  npm: `@scope/package-name`
  repo: `https://github.com/org/repo`
  install: `openclaw plugins install @scope/package-name`

✅ 正确示例

• WeChat Connect — 通过 WeChatPadPro (iPad 协议) 连接微信个人号。支持文本、图片、文件交互及关键词自动回复。 npm: @icesword760/openclaw-wechat repo: https://github.com/icesword0760/openclaw-wechat install: openclaw plugins install @icesword760/openclaw-wechat
• Notion Sync Pro — 双向同步 OpenClaw 对话记录到 Notion 数据库，支持自动标签分类。 npm: @openclaw-community/notion-sync repo: https://github.com/openclaw-community/notion-sync-pro install: openclaw plugins install @openclaw-community/notion-sync

❌ 错误示例 (不要这样写)

• My Plugin (描述太长，包含了安装教程，格式混乱) npm: my-plugin (缺少 @scope 或格式不对) Link: github.com/me/plugin (不是完整 URL)

🚀 五、给开发者的建议：如何提高通过率？

1. 先小范围测试：在提交 PR 前，先在社区 Discord 或论坛分享你的 NPM 包，收集一些用户反馈。如果有用户背书，审核会更快。
2. 完善 Badge：在 GitHub README 顶部添加 NPM 版本、License、Build Status 等徽章，这能直观展示项目的专业度。
3. 语义化版本：严格遵守 SemVer (语义化版本控制)，不要随意发布破坏性更新。
4. 响应 Issue：即使不能立刻修复 Bug，也要及时回复用户，表明你在关注项目。

🤝 结语

OpenClaw 的社区插件列表是用户发现优质扩展的第一站。通过严格的准入机制，我们共同维护一个可信、高效、活跃的生态系统。

如果你开发了一个很棒的插件，不要让它埋没在 GitHub 角落里，提交 PR，让它被全世界看到！ 🌍

最后更新时间：2026-03-18