OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Skills

自我學習

自我學習可讓 OpenClaw 將對話中的有用證據轉化為待處理的 Skill Workshop 提案。它不會訓練模型 權重、編輯啟用中的 Skills，或在未告知的情況下改變代理程式行為。每個學習到的 程序都會維持待處理狀態，直到操作人員審查並套用為止。

自我學習預設為停用。只有在額外執行背景模型及審查逐字稿 適合你的工作區時，才啟用此功能。

啟用自我學習

在 Control UI 中開啟外掛 → 工作坊，然後開啟自我學習。 變更會立即生效；若另一個設定寫入程式已更新檔案， Control UI 會重新整理設定快照並重試切換，而不需要重新載入 頁面或閘道。

使用命令列介面：

bash
openclaw config set skills.workshop.autonomous.enabled true --strict-json

或編輯 ~/.openclaw/openclaw.json：

json5
{  skills: {    workshop: {      autonomous: {        enabled: true,      },    },  },}

再次停用：

bash
openclaw config set skills.workshop.autonomous.enabled false --strict-json

停用自我學習時，使用者要求建立 Skills、/learn 及手動 Skill Workshop 操作 仍可繼續使用。

手動審查過往工作階段

手動歷程審查是自主擷取功能較保守的替代方案。 在 Control UI 中開啟外掛 → 工作坊，然後選取尋找 Skill 構想。 這不會變更 skills.workshop.autonomous.enabled。

每次掃描：

  • 從最新且尚未審查的工作階段開始，並逐步往前回溯；
  • 最多審查 20 個至少包含六次模型輪次的實質工作階段；
  • 略過排程、心跳偵測、鉤子、子代理程式、ACP、外掛擁有及內部審查 工作階段；
  • 在將逐字稿套件傳送至所選代理程式設定的模型前，遮蔽可辨識的祕密資訊並限制其大小；
  • 採用與自主經驗審查相同的高標準；以及
  • 最多可建立或修訂三個待處理提案，絕不會建立啟用中的 Skills。

工作坊會回報累計工作階段數量、日期涵蓋範圍及找到的構想。 選取掃描較早的工作以處理下一個更早的範圍。當游標到達 符合資格的歷程開頭時，動作會變更為掃描新工作。 OpenClaw 只會將游標及涵蓋範圍中繼資料持久儲存在共用狀態資料庫中； 不會建立第二份逐字稿封存。

只有在 OpenClaw 能證明工作階段的擁有權並排除 外部鉤子內容時，才會進行掃描。升級後，目前的升級前逐字稿可在本機 進行分類，但缺少個別執行來源資訊的已輪替升級前逐字稿 會被略過。新的逐字稿會在輪替後繼續保留此來源資訊。

手動掃描仍會產生模型供應商費用，並將符合資格的對話 內容傳送給設定的供應商。只有在此類審查符合 工作區的隱私權及資料處理要求時，才使用此功能。

OpenClaw 可以學習什麼

自我學習有兩種保守途徑：

  1. 直接指示與更正。 OpenClaw 會偵測具持續效力的措辭， 例如「從現在開始」、「下次」以及對失敗方法的更正。 啟用自我學習後，它可以將這些訊號轉化為待處理提案， 不必等待另一個提示。此確定性途徑可將相關 指示分組為最多三個提案、以可寫入的工作區 Skill 為目標， 或修訂自身相關的待處理提案。它也會在失敗的輪次後執行， 因為它擷取的是使用者指示，而不是判斷是否完成。
  2. 經驗審查。 在成功完成實質性的前景輪次後， OpenClaw 可審查已完成的工作，尋找可重複使用的復原技巧，或 能在未來省去至少兩次模型或工具來回操作的 穩定程序。

合適的候選項目包括：

  • 在工具或模型多次失敗後可可靠復原的方法；
  • 避免重複發生錯誤且不易察覺的順序限制；
  • 需要反覆探索的穩定多步驟工作流程；或
  • 可避免未來多次呼叫的可重複使用預先檢查。

對於例行成功工作、一次性要求、個人事實、簡單偏好、 暫時性環境故障、一般性建議、缺乏依據的否定主張及祕密資訊， 審查程式應不提出提案。

經驗審查何時執行

經驗審查會刻意延後執行並受到限制：

  • 前景輪次必須成功完成。
  • 目前輪次必須至少包含十次模型迭代。
  • 排程、心跳偵測、記憶、溢位、鉤子、子代理程式及審查工作階段 會被排除。
  • 前景執行必須已解析出供應商及模型，而且實際上 能存取 skill_workshop。
  • OpenClaw 會在完成後等待 30 秒。同一工作階段中若稍後又有前景執行完成， 便會重新開始這段靜默期。
  • 如果任何代理程式或回覆執行仍在進行中，審查會再等待 30 秒。
  • 同一時間只會執行一項經驗審查。
  • 延後審查是處理程序本機的閘道工作。閘道必須在 整段閒置期間持續執行；一次性本機及由命令列介面支援的執行階段不會保留 足夠的軌跡與工具可用性內容來安排審查。

學習絕不會延遲前景回覆。失敗或不符合資格的 輪次不會啟動經驗審查，不過在停用自主功能時，仍可將使用者的直接更正 作為建議提供。

審查程式會收到什麼

背景審查程式只會收到目前輪次，從最近一則 使用者訊息開始。轉譯後的軌跡上限為 60,000 個字元； 必要時，OpenClaw 會保留第一則訊息及最新證據， 並標示省略的中間部分。

審查程式會重複使用已解析的供應商及模型。當前景 驗證設定檔的身分可用時，它會重複使用該設定檔，並停用模型後援。 因此，此審查會在設定的供應商上啟動另一次模型執行。 當該執行檢查或起草提案時，可能會發出多次供應商要求。 供應商的定價及資料處理條款與前景輪次相同，均適用於此執行。

開始前，OpenClaw 會重新載入目前的執行階段設定，並重新檢查 原始對話的有效沙箱及工具原則。如果該執行位於 沙箱中、原則不再允許 skill_workshop，或缺少必要的執行階段事實， 審查會採取失敗關閉方式，且不建立任何內容。

提案安全性

審查程式會在隔離的工作階段中執行，且工具 範圍會受到刻意限制：

  • 它只能列出或檢查工作坊提案，並建立或修訂一個 待處理提案。
  • 它無法更新啟用中的 Skill、套用提案、拒絕提案、隔離 提案、傳送訊息，或使用一般代理程式工具。
  • 模型重試會共用一份變更預算，因此一次審查最多只能建立或 修訂一個提案。
  • 受審查的軌跡會被視為不受信任的證據，而不是提供給 背景代理程式的指示。
  • Skill Workshop 會掃描提案內容，並在寫入提案狀態前拒絕 可辨識的明文認證資訊。

一般工作坊限制仍然適用，包括 maxPending、maxSkillBytes、 支援檔案限制、掃描程式檢查，以及僅限工作區寫入。設定 approvalPolicy: "auto" 不會授予背景審查程式存取 生命週期動作的權限。

審查學習產生的提案

自我學習會產生與手動使用工作坊相同的待處理提案。 套用前請先檢查：

bash
openclaw skills workshop listopenclaw skills workshop inspect <proposal-id>openclaw skills workshop apply <proposal-id>

修訂、拒絕或隔離有用但尚未準備妥當的提案：

bash
openclaw skills workshop revise <proposal-id> --proposal ./PROPOSAL.mdopenclaw skills workshop reject <proposal-id> --reason "Too specific"openclaw skills workshop quarantine <proposal-id> --reason "Needs security review"

套用是唯一會寫入啟用中 SKILL.md 的操作。完整的生命週期及儲存 模型請參閱 Skill Workshop。

設定

設定 預設值 自我學習效果
skills.workshop.autonomous.enabled false 啟用直接更正擷取及延後經驗審查。
skills.workshop.approvalPolicy "pending" 控制一般由代理程式發起之生命週期動作的核准提示；不會擴大背景審查程式的權限。
skills.workshop.maxPending 50 限制每個工作區待處理及已隔離提案的數量。
skills.workshop.maxSkillBytes 40000 限制提案本文的位元組大小。
skills.workshop.allowSymlinkTargetWrites false 僅影響套用行為；自我學習本身寫入的是提案狀態，而非啟用中的 Skill 目標。

完整的結構描述、範圍及相關 Skill 設定請參閱 Skills 設定。

疑難排解

長時間輪次後未出現提案

檢查以下所有項目：

  1. 啟用中的閘道設定內，skills.workshop.autonomous.enabled 為 true。
  2. 該輪次已成功，且在最近一則使用者訊息後至少包含 十次模型迭代。
  3. 該對話是一般前景執行，而非排程、記憶、 鉤子或子代理程式執行。
  4. 原始執行可存取 skill_workshop，且未在沙箱中執行。
  5. 系統維持閒置的時間足以執行延後審查。
  6. 長時間執行的閘道處理程序在整段閒置期間保持啟用； 一次性本機命令不會等待延後審查。

符合資格的審查仍可能不產生提案。當證據未達到 可重複使用程序的標準時，不提出提案是預期結果。

Doctor 回報工作坊工具已隱藏

啟用自我學習時，openclaw doctor 會檢查預設 代理程式的有效工具原則是否允許 skill_workshop。依照回報的 tools.allow 或 tools.alsoAllow 變更操作，或停用自我學習。

出現太多低價值提案

停用自我學習，並繼續使用 /learn 或明確的工作坊要求：

bash
openclaw config set skills.workshop.autonomous.enabled false --strict-json

停用此功能後，待處理提案仍可供審查。停用 自我學習不會套用、拒絕或刪除這些提案。

相關內容

Was this useful?
On this page

On this page