openclaw claws
Claw 是為一個新的 OpenClaw 代理程式所建立的版本化設定。它可以描述該代理程式所需的代理程式設定、工作區檔案、Skills、外掛、MCP 伺服器及排程工作。Claw 不會取代或修改現有的代理程式。
Claw 目前仍屬實驗性功能。其結構描述、命令輸出及生命週期可能會變更。請明確啟用此命令介面：
建立分組資訊清單
先建立版本 1 的 JSON 資訊清單：SOUL.md 等啟動檔案使用具名項目；其他檔案則使用套件相對來源及工作區相對目標：
檢查與預覽
驗證來源，但不規劃本機變更：planIntegrity 摘要。功能記錄會顯示確切的套件、MCP、排程工作、沙箱、工具或心跳偵測影響。建立代理程式前請先審查計畫：
--yes 並不足夠。若來源、目的地或即時設定在預覽後有所變更，OpenClaw 會重新建立計畫並拒絕同意。當套件預設值與本機狀態衝突時，請在預覽及套用期間都使用 --agent-id 或 --workspace。
新增 Claw 會建立新的代理程式及工作區設定、寫入已宣告的工作區檔案、安裝或重複使用已宣告的 Skill 與外掛成品，並記錄來源。系統不會覆寫現有檔案；若受管理內容已發生偏移，重試時會採取失敗關閉策略。後續的 Claw 階段會新增其他已宣告的資源。
檢查已安裝狀態
status 會將已安裝的代理程式及其記錄的工作區與套件來源，和目前狀態進行比較。它會回報未完成的安裝、缺少的資源及偏移，但不會變更本機狀態。
Claw 來源記錄會區分兩種關係：
- **受管理：**Claw 導入並正在管理該資源。若資源未變更且沒有衝突的擁有者，便可列為清理候選項目。
- **受參照：**該資源原本即獨立存在或由多方共用。移除時預設會解除此 Claw 的參照，並保留該資源。
移除已安裝的 Claw
選擇清理項目前，先預覽移除作業：--yes 絕不會擴大其範圍。全域安裝的外掛會在解除此 Claw 的參照後繼續保留；若要解除安裝整個處理程序共用的外掛，請另行使用一般的外掛生命週期操作。
若要移除由 Claw 導入、未經變更且沒有其他目前擁有者的參照，請在預覽及套用時都加入 --remove-unused。若要改為選取特定的受參照資源，請重複指定 --remove-referenced：
--force-referenced。它允許在存在這些衝突時仍清理所選項目，但不會略過計畫完整性同意。
命令參考
實驗性的機器可讀輸出請使用
--json。