Fundamentals
ฟีเจอร์ทดลอง
ฟีเจอร์ทดลองใน OpenClaw เป็น พื้นผิวพรีวิวแบบเลือกเปิดใช้ ฟีเจอร์เหล่านี้อยู่หลังแฟล็กที่ต้องเปิดใช้อย่างชัดเจน เพราะยังต้องผ่านการใช้งานจริงมากขึ้น ก่อนจะเหมาะเป็นค่าเริ่มต้นที่เสถียรหรือสัญญาสาธารณะที่ใช้งานระยะยาว
ให้ปฏิบัติกับฟีเจอร์เหล่านี้ต่างจากการกำหนดค่าปกติ:
- ปิดไว้ เป็นค่าเริ่มต้น เว้นแต่เอกสารที่เกี่ยวข้องจะบอกให้คุณลองใช้
- คาดว่า รูปแบบและพฤติกรรมจะเปลี่ยนแปลง เร็วกว่าการกำหนดค่าที่เสถียร
- เลือกใช้เส้นทางที่เสถียรก่อนเมื่อมีอยู่แล้ว
- หากคุณกำลังปรับใช้ OpenClaw ในวงกว้าง ให้ทดสอบแฟล็กทดลองในสภาพแวดล้อมที่เล็กกว่าก่อนนำไปใส่ในค่าพื้นฐานที่ใช้ร่วมกัน
แฟล็กที่มีเอกสารในปัจจุบัน
| พื้นผิว | คีย์ | ใช้เมื่อ | เพิ่มเติม |
|---|---|---|---|
| รันไทม์โมเดลในเครื่อง | agents.defaults.experimental.localModelLean |
แบ็กเอนด์ในเครื่องที่เล็กกว่าหรือเข้มงวดกว่ามีปัญหากับพื้นผิวเครื่องมือค่าเริ่มต้นเต็มรูปแบบของ OpenClaw | โมเดลในเครื่อง |
| การค้นหาหน่วยความจำ | agents.defaults.memorySearch.experimental.sessionMemory |
คุณต้องการให้ memory_search จัดทำดัชนีบทถอดความเซสชันก่อนหน้า และยอมรับต้นทุนพื้นที่จัดเก็บ/การจัดทำดัชนีเพิ่มเติม |
ข้อมูลอ้างอิงการกำหนดค่าหน่วยความจำ |
| เครื่องมือวางแผนแบบมีโครงสร้าง | tools.experimental.planTool |
คุณต้องการเปิดเผยเครื่องมือ update_plan แบบมีโครงสร้างสำหรับการติดตามงานหลายขั้นตอนในรันไทม์และ UI ที่รองรับ |
ข้อมูลอ้างอิงการกำหนดค่า Gateway |
โหมดลีนสำหรับโมเดลในเครื่อง
agents.defaults.experimental.localModelLean: true เป็นวาล์วระบายแรงกดสำหรับการตั้งค่าโมเดลในเครื่องที่อ่อนกว่า เมื่อเปิดใช้งาน OpenClaw จะตัดเครื่องมือค่าเริ่มต้นสามตัว — browser, cron, และ message — ออกจากพื้นผิวเครื่องมือของเอเจนต์ในทุกเทิร์น ส่วนอื่นไม่เปลี่ยนแปลง
เหตุผลที่เป็นเครื่องมือสามตัวนี้
เครื่องมือสามตัวนี้มีคำอธิบายยาวที่สุดและมีรูปแบบพารามิเตอร์มากที่สุดในรันไทม์ OpenClaw ค่าเริ่มต้น สำหรับแบ็กเอนด์ที่เข้ากันได้กับ OpenAI ซึ่งมีบริบทขนาดเล็กหรือเข้มงวดกว่า นี่คือความแตกต่างระหว่าง:
- สคีมาเครื่องมือพอดีกับพรอมป์อย่างเรียบร้อย เทียบกับการเบียดประวัติการสนทนาออกไป
- โมเดลเลือกเครื่องมือที่ถูกต้อง เทียบกับการปล่อยการเรียกเครื่องมือที่ผิดรูปแบบเพราะมีสคีมาที่หน้าตาคล้ายกันมากเกินไป
- อะแดปเตอร์ Chat Completions อยู่ภายในขีดจำกัด structured-output ของเซิร์ฟเวอร์ เทียบกับการชน 400 จากขนาดเพย์โหลดการเรียกเครื่องมือ
การนำเครื่องมือเหล่านี้ออกไม่ได้เชื่อมสาย OpenClaw ใหม่แบบเงียบ ๆ แต่แค่ทำให้รายการเครื่องมือสั้นลง โมเดลยังมี read, write, edit, exec, apply_patch, การค้นหา/ดึงข้อมูลเว็บ (เมื่อกำหนดค่าไว้), หน่วยความจำ และเครื่องมือเซสชัน/เอเจนต์ให้ใช้งาน
เมื่อใดควรเปิดใช้
เปิดใช้โหมดลีนเมื่อคุณพิสูจน์แล้วว่าโมเดลคุยกับ Gateway ได้ แต่เทิร์นเอเจนต์แบบเต็มทำงานผิดปกติ ลำดับสัญญาณทั่วไปคือ:
openclaw infer model run --gateway --model <ref> --prompt "Reply with exactly: pong"สำเร็จ- เทิร์นเอเจนต์ปกติล้มเหลวด้วยการเรียกเครื่องมือที่ผิดรูปแบบ พรอมป์ขนาดใหญ่เกินไป หรือโมเดลเพิกเฉยต่อเครื่องมือของตัวเอง
- การสลับ
localModelLean: trueทำให้ความล้มเหลวหายไป
เมื่อใดควรปิดไว้
หากแบ็กเอนด์ของคุณจัดการรันไทม์ค่าเริ่มต้นเต็มรูปแบบได้อย่างเรียบร้อย ให้ปิดตัวเลือกนี้ไว้ โหมดลีนเป็นวิธีแก้เฉพาะหน้า ไม่ใช่ค่าเริ่มต้น มีอยู่เพราะสแต็กในเครื่องบางชุดต้องใช้พื้นผิวเครื่องมือที่เล็กกว่าเพื่อให้ทำงานได้ดี โมเดลที่โฮสต์และเครื่องในเครื่องที่มีทรัพยากรเพียงพอไม่จำเป็นต้องใช้
โหมดลีนยังไม่ใช่สิ่งทดแทน tools.profile, tools.allow/tools.deny, หรือทางออกฉุกเฉิน compat.supportsTools: false ของโมเดล หากคุณต้องการพื้นผิวเครื่องมือที่แคบลงถาวรสำหรับเอเจนต์เฉพาะ ให้เลือกใช้ปุ่มควบคุมที่เสถียรเหล่านั้นแทนแฟล็กทดลอง
เปิดใช้
{
agents: {
defaults: {
experimental: {
localModelLean: true,
},
},
},
}
รีสตาร์ท Gateway หลังจากเปลี่ยนแฟล็ก แล้วตรวจสอบรายการเครื่องมือที่ถูกตัดทอนด้วย:
openclaw status --deep
เอาต์พุตสถานะแบบลึกจะแสดงรายการเครื่องมือเอเจนต์ที่ใช้งานอยู่; browser, cron, และ message ควรหายไปเมื่อเปิดโหมดลีน
ทดลองไม่ได้แปลว่าซ่อนอยู่
หากฟีเจอร์เป็นแบบทดลอง OpenClaw ควรระบุให้ชัดเจนในเอกสารและในเส้นทางการกำหนดค่าเอง สิ่งที่ไม่ควรทำคือแอบใส่พฤติกรรมพรีวิวเข้าไปในปุ่มค่าเริ่มต้นที่ดูเหมือนเสถียร แล้วทำเหมือนว่านั่นเป็นเรื่องปกติ นั่นคือวิธีที่พื้นผิวการกำหนดค่ากลายเป็นเรื่องยุ่งเหยิง