Fundamentals
คุณสมบัติทดลอง
ฟีเจอร์ทดลองใน OpenClaw คือ พื้นผิวพรีวิวแบบเลือกเปิดใช้ ฟีเจอร์เหล่านี้อยู่ หลังแฟล็กที่ต้องเปิดอย่างชัดเจน เพราะยังต้องผ่านการใช้งานจริงมากกว่านี้ก่อนที่จะ สมควรเป็นค่าเริ่มต้นที่เสถียรหรือสัญญาสาธารณะที่คงอยู่นาน
ปฏิบัติกับฟีเจอร์เหล่านี้ให้ต่างจาก config ปกติ:
- ปล่อยให้ ปิดโดยค่าเริ่มต้น เว้นแต่เอกสารที่เกี่ยวข้องจะบอกให้ลองใช้
- คาดว่า รูปแบบและพฤติกรรมจะเปลี่ยน เร็วกว่า config ที่เสถียร
- เลือกเส้นทางที่เสถียรก่อนเมื่อมีอยู่แล้ว
- หากคุณกำลังนำ OpenClaw ไปใช้ในวงกว้าง ให้ทดสอบแฟล็กทดลองในสภาพแวดล้อมที่เล็กกว่า ก่อนใส่เข้าไปใน baseline ที่ใช้ร่วมกัน
แฟล็กที่มีเอกสารในปัจจุบัน
| พื้นผิว | คีย์ | ใช้เมื่อ | เพิ่มเติม |
|---|---|---|---|
| รันไทม์โมเดลภายในเครื่อง | agents.defaults.experimental.localModelLean, agents.list[].experimental.localModelLean |
แบ็กเอนด์ภายในเครื่องที่เล็กกว่าหรือเข้มงวดกว่ารองรับพื้นผิวเครื่องมือเริ่มต้นแบบเต็มของ OpenClaw ไม่ไหว | โมเดลภายในเครื่อง |
| การค้นหาหน่วยความจำ | agents.defaults.memorySearch.experimental.sessionMemory |
คุณต้องการให้ memory_search ทำดัชนีทรานสคริปต์เซสชันก่อนหน้าและยอมรับต้นทุน storage/การทำดัชนีที่เพิ่มขึ้น |
ข้อมูลอ้างอิงการกำหนดค่าหน่วยความจำ |
| ฮาร์เนส Codex | plugins.entries.codex.config.appServer.experimental.sandboxExecServer |
คุณต้องการให้เซิร์ฟเวอร์แอป Codex แบบเนทีฟ 0.132.0 หรือใหม่กว่าชี้ไปยัง exec-server ที่มี sandbox ของ OpenClaw รองรับ แทนการปิดใช้งานโหมดโค้ด | ข้อมูลอ้างอิงฮาร์เนส Codex |
| เครื่องมือวางแผนแบบมีโครงสร้าง | tools.experimental.planTool |
คุณต้องการเปิดเผยเครื่องมือ update_plan แบบมีโครงสร้างสำหรับติดตามงานหลายขั้นตอนในรันไทม์และ UI ที่รองรับ |
ข้อมูลอ้างอิงการกำหนดค่า Gateway |
โหมดลดเครื่องมือสำหรับโมเดลภายในเครื่อง
agents.defaults.experimental.localModelLean: true เป็นวาล์วลดแรงกดสำหรับชุดโมเดลภายในเครื่องที่อ่อนกว่า เมื่อเปิดใช้ OpenClaw จะถอดเครื่องมือเริ่มต้นสามรายการ ได้แก่ browser, cron และ message ออกจากพื้นผิวเครื่องมือของ agent ในทุก turn นอกจากนี้ยังตั้งค่าเริ่มต้นของ run นั้นให้ใช้การควบคุมการค้นหาเครื่องมือแบบมีโครงสร้างเมื่อไม่ได้กำหนด tools.toolSearch ไว้อย่างชัดเจน เพื่อให้แค็ตตาล็อก Plugin, MCP หรือเครื่องมือไคลเอนต์ที่ใหญ่กว่าอยู่หลัง tool_search, tool_describe และ tool_call แทนที่จะถูกเทลงในพรอมป์ Run ที่ต้องส่ง message โดยตรงจะคงเครื่องมือนั้นไว้แบบตรงแทนการเปิดค่าเริ่มต้นการค้นหาเครื่องมือของโหมดลดเครื่องมือ ใช้ agents.list[].experimental.localModelLean เพื่อเปิดหรือปิดพฤติกรรมเดียวกันสำหรับ agent ที่กำหนดค่าไว้หนึ่งตัว
เหตุผลที่เป็นเครื่องมือสามรายการนี้
เครื่องมือสามรายการนี้มีคำอธิบายยาวที่สุดและมีรูปแบบพารามิเตอร์มากที่สุดในรันไทม์เริ่มต้นของ OpenClaw บนแบ็กเอนด์ที่มี context ขนาดเล็กหรือแบ็กเอนด์ที่เข้ากันได้กับ OpenAI แต่เข้มงวดกว่า นี่คือความแตกต่างระหว่าง:
- สคีมาของเครื่องมือพอดีกับพรอมป์อย่างสะอาด เทียบกับเบียดประวัติการสนทนาออกไป
- โมเดลเลือกเครื่องมือที่ถูกต้อง เทียบกับปล่อย tool call ที่ผิดรูปแบบเพราะมีสคีมาที่หน้าตาคล้ายกันมากเกินไป
- อะแดปเตอร์ Chat Completions อยู่ภายในขีดจำกัด structured-output ของเซิร์ฟเวอร์ เทียบกับชนข้อผิดพลาด 400 จากขนาด payload ของ tool-call
การถอดเครื่องมือเหล่านี้ไม่ได้ rewiring OpenClaw อย่างเงียบ ๆ แต่เพียงทำให้รายการเครื่องมือโดยตรงสั้นลง โมเดลยังมี read, write, edit, exec, apply_patch, การค้นหา/ดึงข้อมูลเว็บ (เมื่อกำหนดค่าไว้), หน่วยความจำ และเครื่องมือเซสชัน/agent ให้ใช้งาน แค็ตตาล็อกเพิ่มเติมยังเรียกผ่านการค้นหาเครื่องมือได้ เว้นแต่คุณจะตั้งค่า tools.toolSearch: false อย่างชัดเจน
ควรเปิดใช้เมื่อใด
เปิดโหมดลดเครื่องมือเมื่อคุณพิสูจน์แล้วว่าโมเดลคุยกับ Gateway ได้ แต่ turn ของ agent แบบเต็มทำงานผิดปกติ ลำดับสัญญาณทั่วไปคือ:
openclaw infer model run --gateway --model <ref> --prompt "Reply with exactly: pong"สำเร็จ- turn ของ agent ปกติล้มเหลวด้วย tool call ที่ผิดรูปแบบ, พรอมป์ใหญ่เกินไป หรือโมเดลละเลยเครื่องมือของตัวเอง
- การสลับ
localModelLean: trueทำให้ความล้มเหลวหายไป
ควรปิดไว้เมื่อใด
หากแบ็กเอนด์ของคุณรองรับรันไทม์เริ่มต้นแบบเต็มได้อย่างสะอาด ให้ปิดไว้ โหมดลดเครื่องมือเป็นวิธีเลี่ยงปัญหา ไม่ใช่ค่าเริ่มต้น มีอยู่เพราะสแต็กภายในเครื่องบางตัวต้องใช้พื้นผิวเครื่องมือที่เล็กกว่าเพื่อให้ทำงานถูกต้อง โมเดลที่โฮสต์ไว้และเครื่องภายในเครื่องที่มีทรัพยากรเพียงพอไม่จำเป็นต้องใช้
โหมดลดเครื่องมือยังไม่ใช่ตัวแทนของ tools.profile, tools.allow/tools.deny หรือทางออกฉุกเฉิน compat.supportsTools: false ของโมเดล หากคุณต้องการพื้นผิวเครื่องมือที่แคบลงอย่างถาวรสำหรับ agent เฉพาะ ให้เลือก knob ที่เสถียรเหล่านั้นแทนแฟล็กทดลอง
หากคุณปรับแต่งการค้นหาเครื่องมือทั่วทั้งระบบอยู่แล้ว OpenClaw จะปล่อย config ของ operator นั้นไว้ตามเดิม ตั้งค่า tools.toolSearch: false เพื่อเลือกไม่ใช้ค่าเริ่มต้นการค้นหาเครื่องมือของโหมดลดเครื่องมือ
เปิดใช้
{ agents: { defaults: { experimental: { localModelLean: true, }, }, },}สำหรับ agent เพียงตัวเดียว:
{ agents: { list: [ { id: "local", model: "lmstudio/gemma-4-e4b-it", experimental: { localModelLean: true, }, }, ], },}รีสตาร์ท Gateway หลังเปลี่ยนแฟล็ก จากนั้นยืนยันรายการเครื่องมือที่ถูกลดด้วย:
openclaw status --deepเอาต์พุตสถานะแบบลึกจะแสดงรายการเครื่องมือของ agent ที่ใช้งานอยู่; browser, cron และ message ควรไม่ปรากฏเมื่อเปิดโหมดลดเครื่องมือ เว้นแต่โหมดการส่งปัจจุบันจะบังคับให้ตอบกลับด้วย message โดยตรง
ทดลองไม่ได้หมายความว่าซ่อนอยู่
หากฟีเจอร์เป็นแบบทดลอง OpenClaw ควรบอกอย่างชัดเจนในเอกสารและใน เส้นทาง config เอง สิ่งที่ไม่ควรทำคือแอบยัดพฤติกรรมพรีวิวเข้าไปใน knob ค่าเริ่มต้น ที่ดูเหมือนเสถียร แล้วทำเหมือนว่านั่นเป็นเรื่องปกติ นั่นคือวิธีที่ทำให้พื้นผิว config ยุ่งเหยิง
