什麼是 ClawRecipes？

ClawRecipes 是 OpenClaw 框架的一個強大擴充功能，旨在消除手動配置 AI 代理團隊的繁瑣過程。使用者無需「駭入代理」，而是可以利用結構化的 Markdown 藍圖（稱為食譜/recipe），即時建構完整、協調且功能齊全的代理工作區。此系統強制執行「以檔案為先」的理念，確保上下文、工作流程和團隊配置都是可版本控制、可審核且可重複的。

此解決方案將團隊設置從脆弱的隱藏狀態管理轉變為透明、對 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 範本，並且可以設定它們的工作流程，以定期執行自動化安全檢查或部署驗證循環。

常見問題

問：ClawRecipes 與 OpenClaw 一起使用是免費的嗎？ 答：ClawRecipes 作為 OpenClaw 的開放外掛程式（@jiggai/recipes）提供。雖然該外掛程式本身通常是開源且可免費安裝的，但使用成本取決於底層 OpenClaw 閘道基礎設施以及您使用的 LLM 提供者。

問：如何自訂食譜中定義的角色（例如變更 Dev 代理的工具）？ 答：由於食譜使用基於檔案的藍圖，您可以在部署後檢查生成的檔案。您可以直接在工作區中生成的配置檔案中修改代理定義（工具、範本、職責），並將這些變更提交到版本控制中。

問：如果食譜中定義的 cron 作業意外執行怎麼辦？ 答：ClawRecipes 優先考慮安全性。食譜建議的 cron 作業僅在獲得使用者明確同意（透過提示）後才會安裝。它們在腳手架時不會自動啟動，從而防止不必要的背景操作。

問：我可以與他人共用我的自訂團隊設定嗎？ 答：絕對可以。以檔案為先方法的 E核心優勢在於可共用性。您可以將修改後的食譜檔案或生成的腳手架工作區結構提交到 Git，並與任何安裝了 ClawRecipes 外掛程式的其他 OpenClaw 使用者共用。

問：如果我需要標準食譜中未包含的角色（例如專門的行銷代理）該怎麼辦？ 答：您可以擴充現有食譜或建立新食譜。該系統允許您定義自訂角色，為它們分配特定的工具和範本，並將它們整合到現有的敏捷通道中，確保您的專業需求在結構化框架內得到滿足。