CONTRIBUTING

• 原始链接：https://github.com/openclaw/openclaw/blob/main/CONTRIBUTING.md
• 来源章节：7. 官方仓库与生态仓库
• 来源小节：无
• 抓取方式：jina:https://r.jina.ai/http://github.com/openclaw/openclaw/blob/main/CONTRIBUTING.md
• 抓取时间：2026-04-05 13:47:10
• 状态：ok

中文内容

欢迎来到龙虾池！ 🦞

快速链接

• GitHub：https://github.com/openclaw/openclaw
• 愿景：VISION.md
• 不和谐：https://discord.gg/qkhbAGHRBT
• X/Twitter：@steipete / @openclaw

维护者

• 彼得斯坦伯格 - 仁慈的独裁者

• GitHub: @steipete · X: @steipete

• Shadow - Discord 子系统、Discord 管理员、Clawhub、所有社区审核

• GitHub: @thewilloftheshadow · X: @4shadowed

• Vignesh - 内存 (QMD)、形式建模、TUI、IRC 和 Lobster

• GitHub: @vignesh07 · X: @_vgnsh

• Jos - Telegram、API、Nix 模式

• GitHub: @joshp123 · X: @jjpcodes

• Ayaan Zaidi - Telegram 子系统，Android 应用程序

• GitHub: @obviyus · X: @obviyus

• Tyler Yust - 代理/子代理、cron、BlueBubbles、macOS 应用程序

• GitHub: @tyler6204 · X: @tyleryust

• Mariano Belinky - iOS 应用程序，安全

• GitHub: @mbelinky · X: @belimad

• Nimrod Gutman - iOS 应用程序、macOS 应用程序和甲壳类功能

• GitHub: @ngutman · X: @theguti

• Vincent Koc - 代理、遥测、挂钩、安全

• GitHub: @vincentkoc · X: @vincent_koc

• Val Alexander - UI/UX、文档和 Agent DevX

• GitHub: @BunsDev · X: @BunsDev

• Seb Slight - 文档、代理可靠性、运行时强化

• GitHub: @sebslight · X: @sebslig

• 克里斯托夫中泽 - JS Infra

• GitHub: @cpojer · X: @cnakazawa

• Gustavo Madeira Santana - 多代理、CLI、性能、插件、矩阵

• GitHub: @gumadeiras · X: @gumadeiras

• Onur Solmaz - 代理、开发工作流程、ACP 集成、MS Teams

• GitHub: @onutc, @osolmaz · X: @onusoz

• Josh Avant - 核心、CLI、网关、安全、代理

• GitHub: @joshavant · X: @joshavant

• Jonathan Taylor - ACP 子系统、网关功能/错误、Gog/Mog/Sog CLI、SEDMAT

• GitHub @visionik · X: @visionik

• Josh Lehman - 压缩，Tlon/Urbit 子系统

• GitHub @jalehman · X: @jlehman_

• Radek Sienkiewicz - 文档，控制 UI

• GitHub @velvet-shark · X: @velvet_shark

• Muhammed Mukhthar - Mattermost，CLI

• GitHub @mukhtharcm · X: @mukhtharcm

• 阿勒泰 - 代理、CLI、错误处理

• GitHub @altaywtf · X: @altaywtf

• Robin Waslander - 安全、公关分类、错误修复

• GitHub: @Hydro13 · X: @Robin_waslander

• 张腾基（乔治） - 中国模型 API、云、pi

• GitHub: @odysseus0 · X: @odysseus0z

如何贡献

1. 错误和小修复 → 提交 PR！
2. 新功能/架构 → 开始 GitHub 讨论 或先在 Discord 中提问
3. 仅重构 PR → 不要打开 PR。我们不接受仅重构的更改，除非维护者明确要求将它们作为具体修复的一部分。
4. **针对已知的“主要”故障测试/仅限 CI 的 PR ** → 不要打开 PR。维护者团队已经在跟踪这些故障，并且仅调整测试或 CI 来追踪这些故障的 PR 将被关闭，除非需要验证新的修复。
5. 问题 → Discord #help / #users-helping-users

公关限制

我们的上限为 每位作者 10 个开放 PR。如果超过此限制，则会添加“r: Too-many-prs”标签，并且您的 PR 将自动关闭。这是一个硬限制。

对于真正需要超过 10 个 PR 的协调变更集，请加入 Discord 中的 #clawtributors 频道并首先与维护人员交谈。

公关之前

• 使用您的 OpenClaw 实例进行本地测试

• 运行测试：pnpm build && pnpm check && pnpm test

• 对于扩展/插件更改，请首先运行快速本地通道：

  • pnpm test:扩展 <扩展名>
  • pnpm test:extension --list 查看有效的扩展 ID
  • 如果您更改了共享插件或通道表面，请运行“pnpm test:contracts”
  • 对于目标共享表面工作，请使用 pnpm test:contracts:channels 或 pnpm test:contracts:plugins
  • 这些命令还涵盖默认单元通道跳过的共享接缝/烟雾文件
  • 如果您更改了更广泛的运行时行为，请在请求审核之前仍然运行相关的更广泛通道（“pnpm test:extensions”、“pnpm test:channels”或“pnpm test”）

• 如果您有权访问 Codex，请在打开或更新 PR 之前在本地运行“codex review --base origin/main”。将此视为当前 AI 审核的最高标准，即使 GitHub Codex 审核也运行。

• 不要提交仅重构的 PR，除非维护者明确要求重构活动修复或可交付成果。

• 不要针对“主” CI 上已经红色的故障提交测试或 CI 配置修复。如果在 主分支 CI 运行 中已经出现故障，则这是维护者团队正在跟踪的已知问题，并且仅解决这些故障的 PR 将自动关闭。如果您发现主 CI 中尚未显示_new_回归，请首先将其报告为问题。

• 不要提交仅测试 PR，试图让已知的“主要” CI 失败通过。当需要验证新修复或覆盖同一 PR 中的新行为时，测试更改是可以接受的。

• 确保 CI 检查通过

• 保持 PR 的重点（每个 PR 只关注一件事；不要混合不相关的问题）

• 描述什么和为什么

• 在再次请求审核之前回复或解决您提出的机器人审核对话

• 包括屏幕截图 — 显示问题的屏幕截图

m/之前，显示修复/之后的内容（用于 UI 或视觉更改）

• 在代码、注释、文档和 UI 字符串中使用美式英语拼写和语法
• 除非列出的所有者明确要求更改或已经与您一起审查，否则请勿编辑“代码所有者”安全所有权所涵盖的文件。将这些路径视为受限制的审查表面，而不是机会主义的清理目标。

评论对话归作者所有

如果评论机器人在您的 PR 上留下评论对话，您需要处理后续事宜：

• 一旦代码或解释完全解决了机器人的问题，您自己解决对话
• 仅当您需要维护者或审阅者判断时才回复并保持打开状态
• 不要将“固定”机器人审核对话留给维护人员来为您清理
• 如果 Codex 留下评论，请解决所有相关评论，或者在不适用于您的更改时用简短的解释来解决它
• 如果 GitHub Codex 审核由于某种原因未触发，请在本地运行“codex review --base origin/main”，并将该输出视为所需的审核工作

这适用于人类撰写的公关和人工智能辅助的公关。

控制 UI 装饰器

控制 UI 将 Lit 与 legacy 装饰器一起使用（当前 Rollup 解析不支持标准装饰器所需的“accessor”字段）。添加响应式字段时，保持旧式风格：

@state() foo = "酒吧"; @property({ 类型：数字 }) 计数 = 0;

根“tsconfig.json”使用“useDefineForClassFields: false”为旧装饰器（“experimentalDecorators: true”）进行配置。除非您还更新 UI 构建工具以支持标准装饰器，否则请避免翻转它们。

AI/Vibe-Coded PR 欢迎！ 🤖

使用 Codex、Claude 或其他 AI 工具构建？ 太棒了 - 只需标记即可！

请在您的 PR 中包含：

• 在 PR 标题或描述中标记为 AI 辅助
• 注意测试的程度（未测试/轻度测试/完全测试）
• 如果可能的话，包括提示或会话日志（超级有帮助！）
• 确认您了解代码的作用
• 如果您有权访问 Codex，请在本地运行“codex review --base origin/main”并在请求审核之前解决发现的问题
• 在您解决或回复机器人评论对话后

AI PR 在这里是一等公民。我们只是想要透明度，以便审稿人知道要寻找什么。如果您使用 LLM 编码代理，请指示它解决已解决的机器人审查对话，而不是将其留给维护人员。

当前重点和路线图 🗺

我们目前优先考虑的是：

• 稳定性：修复通道连接中的边缘情况（WhatsApp/Telegram）。
• UX：改进入门向导和错误消息。
• 技能：有关技能贡献，请前往 ClawHub — OpenClaw 技能社区中心。
• 性能：优化令牌使用和压缩逻辑。

检查 GitHub 问题 中的 "good first issues" 标签。如果没有开放的，请选择一个小文档或错误问题并留下简短评论，表示您愿意解决它。

维护者

我们正在有选择地扩大维护者团队。如果您是一位经验丰富的贡献者，想要帮助塑造 OpenClaw 的方向（无论是通过代码、文档还是社区），我们希望收到您的来信。

成为维护者是一种责任，而不是一种荣誉称号。我们期望积极、一致的参与——分类问题、审查 PR 并帮助推动项目向前发展。

还有兴趣吗？发送电子邮件至 contributing@openclaw.ai：

• OpenClaw 上您的 PR 的链接（如果您没有，请先从那里开始）
• 指向您维护或积极贡献的开源项目的链接
• 您的 GitHub、Discord 和 X/Twitter 句柄
• 简介：背景、经验和感兴趣的领域
• 您使用的语言以及您的所在地
• 您实际可以投入多少时间

我们欢迎各种技能的人才——工程、文档、社区管理等等。我们仔细审查每个仅由人类编写的应用程序，并缓慢而谨慎地添加维护人员。请等待几周的时间来回复。

报告漏洞

我们认真对待安全报告。直接向问题所在的存储库报告漏洞：

• 核心 CLI 和网关 — openclaw/openclaw
• macOS 桌面应用程序 — openclaw/openclaw (apps/macos)
• iOS 应用程序 — openclaw/openclaw (apps/ios)
• Android 应用程序 — openclaw/openclaw (apps/android)
• ClawHub — openclaw/clawhub
• 信任和威胁模型 — openclaw/trust

对于不适合特定存储库的问题，或者如果您不确定，请发送电子邮件**security@openclaw.ai**，我们将对其进行路由。

报告中必填

1. 标题
2. 严重性评估
3. 影响
4. 受影响的组件
5. 技术复制
6. 已显现的影响
7. 环境
8. 补救建议

没有复制步骤、已证明的影响和补救建议的报告将被取消优先级。考虑到人工智能生成的扫描仪结果的数量，我们必须确保收到来自了解这些问题的研究人员的经过审查的报告。