什么是 ClawRecipes？

ClawRecipes 是 OpenClaw 框架的一个强大扩展，旨在消除手动配置 AI 智能体团队的繁琐过程。用户不再需要“修补智能体”，而是可以利用结构化的 Markdown 蓝图（称为“配方”或 recipes）来即时搭建完整、协调且功能齐全的智能体工作空间。该系统强制执行“文件优先”的理念，确保上下文、工作流程和团队配置是可版本控制、可审查和可重复的。

此解决方案将团队设置从脆弱的、隐藏的状态管理转变为透明的、对 Git 友好的基础设施。通过应用一个配方，您可以立即建立共享上下文（如文档和工单）、定义专业化的同事式智能体（主管、开发、QA）、锁定敏捷流程结构（泳道），并通过 cron 作业集成周期性自动化。其结果是确定性的、高质量的设置，每次都能从初始脚手架到完成工作保持一致性。

核心特性

• Markdown 蓝图： 使用易读的 Markdown 文件定义整个团队结构、上下文存储库和工作流程，使配置透明且可审计。
• 文件优先上下文（The Pantry/储藏室）： 所有关键团队信息——笔记、工单、清单和工件——都存在于一个共享的、可版本控制的工作空间中，确保智能体不会“忘记”关键上下文。
• 同事式智能体（The Line/生产线）： 搭建专业角色（例如：主管、开发、DevOps、QA），它们拥有明确的职责、工具和模板，允许用户像与专用团队成员一样与它们交互。
• 自动化工作流循环（The Timer/计时器）： 使用配方中定义的 cron 工作流实现周期性任务，如每日分类、看板卫生或 PR 监控。为安全起见，这些任务是选择加入的，并受提示门控。
• 敏捷流程强制执行（The Pass/传递）： 自动设置结构化的敏捷泳道（待办、进行中、测试中、完成）以及直接内置于工作流结构中的清晰交接和验证清单。
• 确定性脚手架： 确保每个新团队都从一个已知良好的结构开始，配备预定义的角色、模板和约定，保证跨项目的持续一致性。

如何使用 ClawRecipes

开始使用 ClawRecipes 需要将其集成到您现有的 OpenClaw 环境中，然后应用所需的配方来构建您的团队结构。

1. 安装： 首先，通过终端将插件安装到您的 OpenClaw 设置中：

$openclaw plugins install @jiggai/recipes

安装后，您必须重启 OpenClaw 网关以激活新功能：

$openclaw gateway restart

2. 搭建团队或智能体： 安装后，您可以使用 scaffold-team 命令根据配方部署一个完整、预配置的环境。例如，要设置一个标准的开发团队：

$openclaw recipes scaffold-team development-team -t my-dev-team --apply-config

或者，如果您只需要一个专业的智能体，可以直接搭建它：

$openclaw recipes scaffold researcher --agent-id my-researcher --apply-config

3. 审查和迭代： 由于所有配置都是基于文件的，您可以立即检查生成的工​​作空间结构，检查智能体角色，并在完全部署或运行智能体之前在版本控制系统中修改敏捷泳道或 cron 作业。

用例

1. 快速项目启动： 即时启动新项目的标准化开发环境。一个配方可以强制执行公司范围内的代码审查清单、部署程序（DevOps 角色）和初始文档结构的约定，确保没有遗漏任何关键的设置步骤。
2. 自动化研究与报告： 部署一个以研究员智能体为中心，并由 QA 智能体支持的团队。使用 cron 功能安排每日数据聚合或市场监控任务，在无需人工干预的情况下交付一致、可重复的报告。
3. 强制执行敏捷纪律： 对于在流程遵守方面遇到困难的团队，ClawRecipe 可以锁定严格的敏捷流程（分派 -> 待办 -> 进行中 -> 测试中 -> 完成）。结构本身会引导智能体和人类贡献者进行适当的交接和验证步骤。
4. 新开发人员入职： 新团队成员可以克隆包含项目 ClawRecipe 配置的存储库。这会立即在他们的本地 OpenClaw 环境中设置与团队其他成员完全相同的智能体角色、上下文文件和工作流程期望。
5. 维护基础设施即代码 (IaC) 工作流： 使用配方来定义负责基础设施管理的智能体（DevOps）。它们的上下文可以包含 IaC 模板，并且它们的流程可以设置为按计划运行自动安全检查或部署验证循环。

常见问题 (FAQ)

问：ClawRecipes 在与 OpenClaw 一起使用时是免费的吗？ 答：ClawRecipes 作为 OpenClaw 的一个开放插件（@jiggai/recipes）提供。虽然该插件本身通常是开源且可以免费安装的，但使用成本取决于底层的 OpenClaw 网关基础设施和您使用的 LLM 提供商。

问：我如何自定义配方中定义的角色（例如更改 Dev 智能体的工具）？ 答：由于配方使用基于文件的蓝图，您可以在部署后检查生成的配置文件。您可以直接修改工作空间中生成的配置文件中的智能体定义（工具、模板、职责），并将其提交到版本控制中。

问：如果配方中定义的 cron 作业意外运行会怎样？ 答：ClawRecipes 优先考虑安全性。配方建议的 cron 作业仅在获得用户的明确同意（通过提示）后才会安装。它们在脚手架搭建时不会自动激活，从而防止了不需要的后台操作。

问：我可以与他人共享我的自定义团队设置吗？ 答：当然可以。文件优先方法的_核心_优势在于可共享性。您可以将修改后的配方文件或生成的脚手架工作空间结构提交到 Git，并与任何安装了 ClawRecipes 插件的其他 OpenClaw 用户共享。

问：如果我需要一个标准配方中不包含的角色（例如专用的市场营销智能体）该怎么办？ 答：您可以扩展现有配方或创建新配方。该系统允许您定义自定义角色，为其分配特定的工具和模板，并将它们集成到现有的敏捷泳道中，确保您的专业需求在结构化框架内得到满足。