跳轉到主要內容

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw 中的實驗性功能是需自行選擇啟用的預覽介面。它們位於明確旗標之後，因為它們仍需要真實世界的使用驗證，才值得成為穩定預設值或長期公開合約。 請以不同於一般設定的方式看待它們：
  • 除非相關文件告訴你可以試用，否則請保持預設關閉。
  • 預期形狀與行為變更會比穩定設定更快。
  • 當已有穩定路徑時，請優先使用穩定路徑。
  • 如果你正在大規模導入 OpenClaw，請先在較小的環境中測試實驗性旗標，再將它們納入共用基準。

​
目前已記錄的旗標

介面鍵使用時機更多資訊
本機模型執行環境agents.defaults.experimental.localModelLean較小或較嚴格的本機後端無法處理 OpenClaw 完整的預設工具介面本機模型
記憶搜尋agents.defaults.memorySearch.experimental.sessionMemory你想讓 memory_search 索引先前的工作階段逐字稿，並接受額外的儲存與索引成本記憶設定參考
結構化規劃工具tools.experimental.planTool你想在相容的執行環境與 UI 中公開結構化的 update_plan 工具，用於追蹤多步驟工作Gateway 設定參考

​
本機模型精簡模式

agents.defaults.experimental.localModelLean: true 是較弱本機模型設定的壓力釋放閥。啟用時，OpenClaw 會在每一輪中，從代理的工具介面移除三個預設工具：browser、cron 和 message。其他部分不會改變。

​
為什麼是這三個工具

在預設 OpenClaw 執行環境中，這三個工具擁有最長的描述和最多的參數形狀。對於小上下文或較嚴格的 OpenAI 相容後端而言，這會造成以下差異：
  • 工具結構描述能乾淨地放入提示中，而不是擠掉對話歷史。
  • 模型能選擇正確工具，而不是因為有太多外觀相似的結構描述而輸出格式錯誤的工具呼叫。
  • Chat Completions 轉接器能留在伺服器的結構化輸出限制內，而不是因工具呼叫承載大小觸發 400。
移除它們不會悄悄重接 OpenClaw，只是讓工具清單更短。模型仍然可用 read、write、edit、exec、apply_patch、網頁搜尋/擷取（設定後）、記憶，以及工作階段/代理工具。

​
何時啟用

當你已經證明模型可以與 Gateway 溝通，但完整代理輪次行為異常時，請啟用精簡模式。典型的訊號鏈如下：
  1. openclaw infer model run --gateway --model <ref> --prompt "Reply with exactly: pong" 成功。
  2. 一般代理輪次因格式錯誤的工具呼叫、過大的提示，或模型忽略工具而失敗。
  3. 切換 localModelLean: true 後排除失敗。

​
何時保持關閉

如果你的後端能乾淨處理完整的預設執行環境，請保持關閉。精簡模式是因應措施，不是預設值。它存在是因為某些本機堆疊需要較小的工具介面才能正常運作；託管模型與資源充足的本機設備不需要它。 精簡模式也不會取代 tools.profile、tools.allow/tools.deny，或模型的 compat.supportsTools: false 逃生閥。如果你需要為特定代理永久縮小工具介面，請優先使用那些穩定旋鈕，而不是實驗性旗標。

​
啟用

{
  agents: {
    defaults: {
      experimental: {
        localModelLean: true,
      },
    },
  },
}
變更旗標後重新啟動 Gateway，然後使用以下命令確認修剪後的工具清單： 
openclaw status --deep
深度狀態輸出會列出啟用中的代理工具；啟用精簡模式時，browser、cron 和 message 應不存在。

​
實驗性不代表隱藏

如果某項功能是實驗性的，OpenClaw 應該在文件和設定路徑本身中清楚說明。不應該做的是把預覽行為偷塞進看起來穩定的預設旋鈕，然後假裝那是正常的。那正是設定介面變得混亂的原因。

​
相關